@cometchat/skills 4.2.1 → 4.4.0

package/skills/cometchat-ios-features/SKILL.md

@@ -3,17 +3,27 @@ name: cometchat-ios-features
 description: "Feature catalog for CometChat iOS UI Kit — calls, reactions, polls, stickers, AI features, and extensions."
 license: "MIT"
 compatibility: "CometChatUIKitSwift ^5; iOS 13+"
-allowed-tools: "shell, file-read, file-search, file-list"
 metadata:
   author: "CometChat"
   version: "3.0.0"
   tags: "chat cometchat ios features calls reactions polls ai stickers extensions"
 ---
 
+> **Ground truth:** `CometChatUIKitSwift ~> 5` + `packages/registry/v6/features/catalog.json`. (Official docs linked below.) Verify symbols against the installed package/source before relying on them.
+
 ## Purpose
 
+> **Canonical public feature-availability matrix:** [Features & Extensions Guide](https://www.cometchat.com/docs/fundamentals/features-and-extensions-guide) — the authoritative source for which integration method (UI Kit / UI Kit Builder / Widget Builder / SDK) supports each feature + dashboard setup + whether code is required. It **outranks the local `catalog.json` snapshot on conflict**; consult it (WebFetch or docs MCP) for any availability decision.
+
+
 This skill documents all features available in CometChat iOS UI Kit v5 — voice/video calls, reactions, polls, stickers, AI features, and extensions. Use this to understand what's available and how to enable/configure each feature.
 
+### Feature categories — what work each needs
+
+Classify the feature by the product's 5-category "work needed" model before enabling: **Core (zero-setup)** — out of the box (typing, reactions) · **Builder-enabled** — Dashboard API + UI Kit Builder toggle (polls) · **Config-only** — Dashboard API, automatic (link preview) · **Config + settings** — Dashboard API + extra settings/keys, no code (smart replies) · **SDK-integrated** — Dashboard API + **custom client code** (Bitly). **Key rule:** only SDK-integrated features need client code, and **the implementation lives in the docs** — `cometchat features info <id> --json` shows what's needed (`auto_wired_in_uikit: false` ⇒ the toggle alone won't render it; fetch + adapt the doc code, don't hand-roll). Don't assume "enabled = visible" for dashboard extensions.
+
+**Honest-automation boundary:** standard **extensions** (polls, stickers, link-preview, message-translation, etc.) are enabled with a real dashboard API call via `cometchat apply-feature <id> --app-id <your-app-id>` — never tell the user to toggle them manually. But **third-party dashboard-only features** (Giphy, Stipop, Tenor, Chatwoot, Intercom, Disappearing Messages, Message Shortcuts) return `manual-action-required`: they need *your* third-party credentials and **cannot be automated** — state that. **Call recording is a paid plan add-on** (contact CometChat support; no toggle/CLI) — never claim it was enabled (see §1 Voice & Video Calls).
+
 ---
 
 ## 1. Voice & Video Calls
@@ -24,12 +34,12 @@ Add the CometChat Calls SDK to your project:
 
 **CocoaPods:**
 ```ruby
-pod 'CometChatCallsSDK', '~> 4.0'
+pod 'CometChatCallsSDK', '~> 5.0'
 ```
 
 **Swift Package Manager:**
 ```
-https://github.com/cometchat/cometchat-calls-sdk-ios
+https://github.com/cometchat/calls-sdk-ios
 ```
 
 ### Required Permissions
@@ -163,13 +173,14 @@ let callSettings = CallSettingsBuilder()
     .setIsAudioOnly(false)                    // Video call
     .setDefaultAudioMode("SPEAKER")           // "SPEAKER" or "EARPIECE"
     .setShowSwitchToVideoCall(true)           // Allow switching to video
-    .setShowEndCallButton(true)
-    .setShowMuteAudioButton(true)
-    .setShowPauseVideoButton(true)
-    .setShowSwitchCameraButton(true)
-    .setShowAudioModeButton(true)
-    .setStartWithAudioMuted(false)
-    .setStartWithVideoMuted(false)
+    // Button visibility uses inverted setXxxButtonDisable(Bool), NOT setShowXxxButton:
+    .setEndCallButtonDisable(false)
+    .setMuteAudioButtonDisable(false)
+    .setPauseVideoButtonDisable(false)
+    .setSwitchCameraButtonDisable(false)
+    .setAudioModeButtonDisable(false)
+    .setStartAudioMuted(false)        // not setStartWithAudioMuted
+    .setStartVideoMuted(false)        // not setStartWithVideoMuted
     .build()
 
 let outgoingCall = CometChatOutgoingCall()
@@ -184,10 +195,11 @@ Display call history:
 
 ```swift
 let callLogs = CometChatCallLogs()
-callLogs.onItemClick = { callLog, indexPath in
+callLogs.set(onItemClick: { callLog in
     // Handle call log tap - maybe initiate a new call
+    // (the closure receives the tapped call log as `Any`)
     print("Call log tapped: \(callLog)")
-}
+})
 navigationController?.pushViewController(callLogs, animated: true)
 ```
 
@@ -212,14 +224,18 @@ messageList.hideReactionOption = true
 ```swift
 class ReactionListener: CometChatMessageEventListener {
     
+    // ReactionEvent.reaction is a `Reaction?` OBJECT, not a String. The
+    // emoji/uid/messageId live on that nested Reaction; the event itself
+    // carries parentMessageId/conversationId/receiverId (there is NO `message`
+    // or `reactedBy` property on ReactionEvent).
     func onMessageReactionAdded(reactionEvent: ReactionEvent) {
-        print("Reaction added: \(reactionEvent.reaction ?? "")")
-        print("By user: \(reactionEvent.reactedBy?.name ?? "")")
-        print("On message: \(reactionEvent.message?.id ?? 0)")
+        print("Reaction added: \(reactionEvent.reaction?.reaction ?? "")")
+        print("By user: \(reactionEvent.reaction?.uid ?? "")")
+        print("On message: \(reactionEvent.reaction?.messageId ?? 0)")
     }
     
     func onMessageReactionRemoved(reactionEvent: ReactionEvent) {
-        print("Reaction removed: \(reactionEvent.reaction ?? "")")
+        print("Reaction removed: \(reactionEvent.reaction?.reaction ?? "")")
     }
 }
 
@@ -262,15 +278,16 @@ let pollData: [String: Any] = [
 ]
 
 // Create custom message with poll type
+// CustomMessage has no customType: init — pass the type via the trailing type: label
 let pollMessage = CustomMessage(
     receiverUid: user.uid ?? "",
     receiverType: .user,
-    customType: "extension_poll",
-    customData: pollData
+    customData: pollData,
+    type: "extension_poll"
 )
 
 CometChat.sendCustomMessage(message: pollMessage) { message in
-    print("Poll sent: \(message?.id ?? 0)")
+    print("Poll sent: \(message.id)")
 } onError: { error in
     print("Error: \(error?.errorDescription ?? "")")
 }
@@ -279,14 +296,15 @@ CometChat.sendCustomMessage(message: pollMessage) { message in
 ### Poll Bubble Customization
 
 ```swift
-// Polls are rendered using CometChatPollBubble
-// Style customization:
-CometChatPollBubble.style.backgroundColor = .secondarySystemBackground
-CometChatPollBubble.style.questionTextColor = .label
-CometChatPollBubble.style.questionTextFont = CometChatTypography.Heading4.medium
-CometChatPollBubble.style.optionTextColor = .label
-CometChatPollBubble.style.optionTextFont = CometChatTypography.Body.regular
-CometChatPollBubble.style.voteCountTextColor = .secondaryLabel
+// Polls render via the `CometChatPollsBubble` view (note the plural — there is no
+// `CometChatPollBubble`). Its `style` is an INSTANCE property of type `PollBubbleStyle`
+// (NOT a static), so you cannot assign `CometChatPollsBubble.style.x = …`.
+// To restyle the poll bubble, build a `PollBubbleStyle`, then apply it inside a custom
+// message template's bubble view (see cometchat-ios-customization → message templates):
+let pollStyle = PollBubbleStyle()
+pollStyle.backgroundColor = .secondarySystemBackground
+// …set the PollBubbleStyle properties you need, then pass the styled
+// CometChatPollsBubble instance from your template's bubbleView closure.
 ```
 
 ---
@@ -397,8 +415,8 @@ Generates a summary of the conversation:
 
 // Get conversation summary
 CometChat.getConversationSummary(
-    conversationWith: user.uid ?? "",
-    conversationType: .user
+    receiverId: user.uid ?? "",
+    receiverType: .user
 ) { summary in
     print("Summary: \(summary)")
 } onError: { error in
@@ -479,12 +497,22 @@ cometchat apply-feature message-translation --app-id <your-app-id>
 // Translation option appears in message menu when enabled
 // Users can tap "Translate" to see the translated version
 
-// Programmatic translation:
-CometChat.translateMessage(
-    message: textMessage,
-    targetLanguage: "es"  // Spanish
-) { translatedMessage in
-    print("Translated: \(translatedMessage.text ?? "")")
+// Programmatic translation: there is NO `CometChat.translateMessage(...)`
+// method. Message translation is an extension — invoke it via callExtension
+// against the message-translation slug:
+CometChat.callExtension(
+    slug: "message-translation",
+    type: .post,
+    endPoint: "v2/translate",
+    body: [
+        "msgId": textMessage.id,
+        "text": textMessage.text,
+        "languages": ["es"]   // target languages
+    ]
+) { response in
+    // response is [String: Any]? — read the translated text from the
+    // extension payload (see the message-translation extension docs).
+    print("Translation response: \(response ?? [:])")
 } onError: { error in
     print("Error: \(error?.errorDescription ?? "")")
 }
@@ -628,7 +656,7 @@ let messageComposer = CometChatMessageComposer()
 messageComposer.set(user: user)
 
 // Hide voice recording button
-messageComposer.hideVoiceRecording = true
+messageComposer.hideVoiceRecordingButton = true
 ```
 
 ### Required Permission

package/skills/cometchat-ios-placement/SKILL.md

@@ -3,13 +3,14 @@ name: cometchat-ios-placement
 description: "WHERE to put CometChat in your iOS app — navigation patterns, tab bars, modals, and embedded views."
 license: "MIT"
 compatibility: "CometChatUIKitSwift ^5; iOS 13+"
-allowed-tools: "shell, file-read, file-search, file-list"
 metadata:
   author: "CometChat"
   version: "3.0.0"
   tags: "chat cometchat ios placement navigation tabs modal patterns"
 ---
 
+> **Ground truth:** `CometChatUIKitSwift ~> 5` view controllers + `docs/ui-kit/ios`. **Official docs:** https://www.cometchat.com/docs/ui-kit/ios/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.
+
 ## Purpose
 
 This skill teaches WHERE to place CometChat components in your iOS app. It covers navigation patterns, tab bar integration, modal presentations, and embedded views for different use cases.
@@ -64,9 +65,9 @@ func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options conn
     conversations.set(onItemClick: { [weak conversations] conversation, _ in
         let messagesVC = MessagesVC()  // your own VC composing CometChatMessageHeader + List + Composer; see cometchat-ios-components § 12
         if let user = conversation.conversationWith as? User {
-            messagesVC.set(user: user)
+            messagesVC.user = user
         } else if let group = conversation.conversationWith as? Group {
-            messagesVC.set(group: group)
+            messagesVC.group = group
         }
         conversations?.navigationController?.pushViewController(messagesVC, animated: true)
     })
@@ -111,9 +112,9 @@ struct ConversationsListView: UIViewControllerRepresentable {
     
     func makeUIViewController(context: Context) -> CometChatConversations {
         let conversations = CometChatConversations()
-        conversations.onItemClick = { conversation, _ in
+        conversations.set(onItemClick: { conversation, _ in
             selectedConversation = conversation
-        }
+        })
         return conversations
     }
     
@@ -235,7 +236,7 @@ class MainTabBarController: UITabBarController {
     
     private func openMessages(with user: User) {
         let messagesVC = MessagesVC()  // your own VC composing CometChatMessageHeader + List + Composer; see cometchat-ios-components § 12
-        messagesVC.set(user: user)
+        messagesVC.user = user
         messagesVC.hidesBottomBarWhenPushed = true
         
         if let navController = selectedViewController as? UINavigationController {
@@ -245,7 +246,7 @@ class MainTabBarController: UITabBarController {
     
     private func openMessages(with group: Group) {
         let messagesVC = MessagesVC()  // your own VC composing CometChatMessageHeader + List + Composer; see cometchat-ios-components § 12
-        messagesVC.set(group: group)
+        messagesVC.group = group
         messagesVC.hidesBottomBarWhenPushed = true
         
         if let navController = selectedViewController as? UINavigationController {
@@ -348,7 +349,7 @@ class ProductDetailViewController: UIViewController {
             
             DispatchQueue.main.async {
                 let messagesVC = MessagesVC()  // your own VC composing CometChatMessageHeader + List + Composer; see cometchat-ios-components § 12
-                messagesVC.set(user: user)
+                messagesVC.user = user
                 
                 let navController = UINavigationController(rootViewController: messagesVC)
                 navController.modalPresentationStyle = .pageSheet
@@ -536,9 +537,9 @@ class MainViewController: UIViewController {
         conversations.set(onItemClick: { [weak self] conversation, _ in
             let messagesVC = MessagesVC()  // your own VC composing CometChatMessageHeader + List + Composer; see cometchat-ios-components § 12
             if let user = conversation.conversationWith as? User {
-                messagesVC.set(user: user)
+                messagesVC.user = user
             } else if let group = conversation.conversationWith as? Group {
-                messagesVC.set(group: group)
+                messagesVC.group = group
             }
             conversations.navigationController?.pushViewController(messagesVC, animated: true)
         })
@@ -615,9 +616,9 @@ class ChatSplitViewController: UISplitViewController {
         let messagesVC = MessagesVC()  // your own VC composing CometChatMessageHeader + List + Composer; see cometchat-ios-components § 12
         
         if let user = conversation.conversationWith as? User {
-            messagesVC.set(user: user)
+            messagesVC.user = user
         } else if let group = conversation.conversationWith as? Group {
-            messagesVC.set(group: group)
+            messagesVC.group = group
         }
         
         let secondaryNav = UINavigationController(rootViewController: messagesVC)
@@ -729,7 +730,9 @@ class EmbeddedChatViewController: UIViewController {
             DispatchQueue.main.async {
                 self?.supportUser = user
                 self?.messageList.set(user: user)
+                self?.messageList.set(controller: self)        // mandatory — see cometchat-ios-components § 4/§ 6
                 self?.messageComposer.set(user: user)
+                self?.messageComposer.set(controller: self)    // mandatory — enables attachments/sheets
             }
         } onError: { error in
             print("Error: \(error?.errorDescription ?? "")")

package/skills/cometchat-ios-production/SKILL.md

@@ -3,13 +3,14 @@ name: cometchat-ios-production
 description: "Production-ready CometChat iOS setup — server-side auth tokens, security best practices, and deployment checklist."
 license: "MIT"
 compatibility: "CometChatUIKitSwift ^5; iOS 13+"
-allowed-tools: "shell, file-read, file-search, file-list"
 metadata:
   author: "CometChat"
   version: "3.0.0"
   tags: "chat cometchat ios production auth tokens security deployment"
 ---
 
+> **Ground truth:** `CometChatUIKitSwift ~> 5` (+ `CometChatCallsSDK ~> 5`) — Pods/SPM `.swiftinterface` + `ui-kit/ios`. **Official docs:** https://www.cometchat.com/docs/fundamentals/user-auth · **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.
+
 ## Purpose
 
 This skill teaches how to prepare your CometChat iOS integration for production. It covers replacing development Auth Keys with server-side auth tokens, security best practices, and a deployment checklist.
@@ -314,7 +315,9 @@ final class CometChatManager {
                     self?.currentUser = user
                     completion(.success(user))
                 case .onError(let error):
-                    completion(.failure(error))
+                    // CometChatException does NOT conform to Swift's Error, so it
+                    // can't go straight into Result<_, Error> — bridge it.
+                    completion(.failure(CometChatError.sdk(error)))
                 }
             }
         }
@@ -335,7 +338,9 @@ final class CometChatManager {
                     self?.currentUser = nil
                     completion(.success(()))
                 case .onError(let error):
-                    completion(.failure(error))
+                    // CometChatException does NOT conform to Swift's Error, so it
+                    // can't go straight into Result<_, Error> — bridge it.
+                    completion(.failure(CometChatError.sdk(error)))
                 }
             }
         }
@@ -349,7 +354,8 @@ enum CometChatError: LocalizedError {
     case invalidURL
     case noData
     case invalidResponse
-    
+    case sdk(CometChatException)  // bridges a CometChatException into Swift's Error
+
     var errorDescription: String? {
         switch self {
         case .notInitialized:
@@ -360,6 +366,8 @@ enum CometChatError: LocalizedError {
             return "No data received from server"
         case .invalidResponse:
             return "Invalid response from server"
+        case .sdk(let exception):
+            return exception.errorDescription
         }
     }
 }

package/skills/cometchat-ios-push/SKILL.md

@@ -3,13 +3,14 @@ name: cometchat-ios-push
 description: "Set up push notifications for CometChat iOS apps — APNs configuration, token registration, and notification handling."
 license: "MIT"
 compatibility: "CometChatUIKitSwift ^5; iOS 13+"
-allowed-tools: "shell, file-read, file-search, file-list"
 metadata:
   author: "CometChat"
   version: "3.0.0"
   tags: "chat cometchat ios push notifications apns"
 ---
 
+> **Ground truth:** `CometChatUIKitSwift ~> 5` (+ `CometChatCallsSDK ~> 5`) — Pods/SPM `.swiftinterface` + `ui-kit/ios`. **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.
+
 ## Purpose
 
 This skill teaches how to set up push notifications for CometChat iOS apps, including APNs configuration, token registration, and handling incoming notifications.
@@ -161,16 +162,50 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
     }
     
     private func registerPushToken(_ token: String) {
-        CometChat.registerTokenForPushNotification(
-            token: token,
-            settings: ["voip": false]
+        // CANONICAL v5 API: CometChatNotifications.registerPushToken takes a
+        // PushPlatforms enum (NOT a settings dict). Use .APNS_IOS_DEVICE for a
+        // standard APNs device token, .APNS_IOS_VOIP for a PushKit VoIP token,
+        // or .FCM_IOS if you route iOS through FCM. providerId is your dashboard
+        // push-provider id (pass nil to use the default).
+        CometChatNotifications.registerPushToken(
+            pushToken: token,
+            platform: .APNS_IOS_DEVICE,
+            providerId: nil
         ) { success in
             print("Push token registered: \(success)")
         } onError: { error in
-            print("Push token registration failed: \(error?.errorDescription ?? "")")
+            print("Push token registration failed: \(error.errorDescription)")
         }
+        // NOTE: the legacy `CometChat.registerTokenForPushNotification(token:settings:)`
+        // (v4-era) still compiles but is superseded — prefer the call above.
     }
-    
+
+    // MARK: - Token lifecycle (register AFTER login, unregister BEFORE logout)
+    //
+    // ⚠️ `didRegisterForRemoteNotifications` can fire before the user logs in.
+    // Registering a token that isn't bound to a CometChat session is a no-op at
+    // best. Stash the latest APNs token and register it only once login resolves:
+    //
+    //   var pendingPushToken: String?   // set in didRegisterForRemoteNotifications
+    //   // after CometChatUIKit.login(...) onSuccess:
+    //   if let t = pendingPushToken { registerPushToken(t) }
+    //
+    // And ALWAYS unregister before logout — otherwise the device keeps receiving
+    // pushes for the previous user:
+
+    func unregisterPushToken(_ completion: @escaping () -> Void) {
+        CometChatNotifications.unregisterPushToken { _ in
+            completion()
+        } onError: { _ in
+            completion()   // proceed with logout regardless
+        }
+    }
+
+    // Usage at logout:
+    //   unregisterPushToken {
+    //       CometChatUIKit.logout(onSuccess: { _ in /* route to login */ }, onError: { _ in })
+    //   }
+
     // MARK: - Handle Incoming Notifications
     
     func application(
@@ -348,14 +383,16 @@ extension AppDelegate: PKPushRegistryDelegate {
         let token = pushCredentials.token.map { String(format: "%02.2hhx", $0) }.joined()
         print("VoIP Token: \(token)")
         
-        // Register VoIP token with CometChat
-        CometChat.registerTokenForPushNotification(
-            token: token,
-            settings: ["voip": true]
+        // Register VoIP token with CometChat — canonical v5 API uses the
+        // .APNS_IOS_VOIP platform (NOT settings: ["voip": true]).
+        CometChatNotifications.registerPushToken(
+            pushToken: token,
+            platform: .APNS_IOS_VOIP,
+            providerId: nil
         ) { success in
             print("VoIP token registered: \(success)")
         } onError: { error in
-            print("VoIP token registration failed: \(error?.errorDescription ?? "")")
+            print("VoIP token registration failed: \(error.errorDescription)")
         }
     }
     
@@ -511,17 +548,14 @@ UIApplication.shared.applicationIconBadgeNumber = 0
 
 ```swift
 func updateBadgeCount() {
-    CometChat.getUnreadMessageCount { userUnread, groupUnread in
+    // getUnreadMessageCount's success closure receives a SINGLE [String: Any]
+    // (conversations keyed by uid/guid → count) — NOT two separate dicts.
+    CometChat.getUnreadMessageCount { unread in
         var totalUnread = 0
-        
-        for (_, count) in userUnread {
-            totalUnread += count as? Int ?? 0
-        }
-        
-        for (_, count) in groupUnread {
+        for (_, count) in unread {
             totalUnread += count as? Int ?? 0
         }
-        
+
         DispatchQueue.main.async {
             UIApplication.shared.applicationIconBadgeNumber = totalUnread
         }

package/skills/cometchat-ios-testing/SKILL.md

@@ -3,7 +3,6 @@ name: cometchat-ios-testing
 description: Testing patterns for CometChat iOS UI Kit v5 in Swift / SwiftUI / UIKit projects. Covers XCTest setup, mocking CometChatSDK + CometChatUIKitSwift via protocols, snapshot testing with iOSSnapshotTestCase, async/await test helpers, UI testing for full chat flows on simulators, and CI on Xcode Cloud / GitHub Actions.
 license: "MIT"
 compatibility: "Xcode 15+, Swift 5.9+, iOS 13+ deployment target; XCTest (built-in); SnapshotTesting >= 1.15 (Pointfree); CometChatUIKitSwift ~> 5.1"
-allowed-tools: "shell, file-read, file-search, file-list, ask-user"
 metadata:
   author: "CometChat"
   version: "4.0.0"
@@ -19,7 +18,7 @@ Testing patterns for iOS CometChat integrations. XCTest (built-in) for unit + in
 - `cometchat-ios-components` — what each VC does (tests assert against this)
 - `cometchat-ios-calls/references/callkit-and-pushkit.md` — CallKit testing strategy (different from chat)
 
-**Ground truth:**
+**Ground truth:** **Official docs:** https://www.cometchat.com/docs/ui-kit/ios/overview · **Docs MCP:** `claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp` (or fetch the URL directly without MCP).
 - XCTest — https://developer.apple.com/documentation/xctest
 - SnapshotTesting — https://github.com/pointfreeco/swift-snapshot-testing
 
@@ -47,6 +46,10 @@ The CometChat SDKs are class-based with static methods (`CometChat.init`, `Comet
 // Protocols/CometChatService.swift
 import CometChatSDK
 
+// CometChatException does NOT conform to Swift's Error, so a throwing
+// continuation can't resume with it directly — bridge it through this.
+struct CometChatTestError: Error { let message: String }
+
 protocol CometChatServiceProtocol {
   func initialize(appId: String, region: String) async throws
   func login(uid: String, authKey: String) async throws -> User
@@ -63,16 +66,18 @@ final class CometChatService: CometChatServiceProtocol {
         .subscribePresenceForAllUsers()
         .setRegion(region: region)
         .build()
-      CometChat.init(appId: appId, appSettings: settings) { isInitialized, error in
-        if let error = error { cont.resume(throwing: error) } else { cont.resume() }
-      }
+      CometChat.init(appId: appId, appSettings: settings, onSuccess: { _ in
+        cont.resume()
+      }, onError: { error in
+        cont.resume(throwing: CometChatTestError(message: error.errorDescription))
+      })
     }
   }
 
   func login(uid: String, authKey: String) async throws -> User {
     try await withCheckedThrowingContinuation { (cont: CheckedContinuation<User, Error>) in
-      CometChat.login(UID: uid, apiKey: authKey, onSuccess: { cont.resume(returning: $0) },
-                      onError: { cont.resume(throwing: $0) })
+      CometChat.login(UID: uid, authKey: authKey, onSuccess: { cont.resume(returning: $0) },
+                      onError: { cont.resume(throwing: CometChatTestError(message: $0.errorDescription)) })
     }
   }
 
@@ -238,8 +243,8 @@ final class ChatViewSnapshotTests: XCTestCase {
 
   func testChatViewWithMessages() {
     let messages = [
-      TextMessage(text: "Hi", senderUid: "alice"),
-      TextMessage(text: "Hey", senderUid: "bob"),
+      TextMessage(receiverUid: "alice", text: "Hi", receiverType: .user),
+      TextMessage(receiverUid: "bob", text: "Hey", receiverType: .user),
     ]
     let view = ChatView(messages: messages)
     let host = UIHostingController(rootView: view)

package/skills/cometchat-ios-theming/SKILL.md

@@ -3,13 +3,14 @@ name: cometchat-ios-theming
 description: "Customize the look and feel of CometChat iOS UI Kit — colors, fonts, styles, and dark mode support."
 license: "MIT"
 compatibility: "CometChatUIKitSwift ^5; iOS 13+"
-allowed-tools: "shell, file-read, file-search, file-list"
 metadata:
   author: "CometChat"
   version: "3.0.0"
   tags: "chat cometchat ios theming colors fonts styles dark-mode"
 ---
 
+> **Ground truth:** `CometChatUIKitSwift ~> 5` (+ `CometChatCallsSDK ~> 5`) — Pods/SPM `.swiftinterface` + `ui-kit/ios`. **Official docs:** https://www.cometchat.com/docs/ui-kit/ios/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.
+
 ## Purpose
 
 This skill teaches how to customize the visual appearance of CometChat iOS UI Kit components. It covers global theming, component-level styling, dark mode support, and creating custom themes.
@@ -115,8 +116,22 @@ CometChatTheme.neutralColor900 = UIColor.black
 ```swift
 import CometChatUIKitSwift
 
-// Set custom font family — class func, NOT a settable property
-CometChatTypography.setFont(name: "Avenir")
+// Two distinct font APIs exist (both verified against CometChatUIKitSwift):
+//   • `CometChatTypography.setFont(name: String)` — class func, sets ONE font
+//     family name globally (uikit.swiftinterface:11156).
+//   • `Typography.overrideFont(family: CometChatFontFamily)` — mutating instance
+//     method taking per-weight names (regular/medium/bold). Use this when your
+//     weights map to differently-named font files. (Typography.swift:108)
+// The per-weight form is shown below; `CometChatTypography` itself is a static
+// class with no default()/init.
+var customTypography = Typography()   // the mutable Typography struct (has overrideFont)
+let avenirFamily = CometChatFontFamily(
+    regular: "Avenir",
+    medium:  "Avenir-Medium",
+    bold:    "Avenir-Heavy"
+)
+customTypography.overrideFont(family: avenirFamily)
+// Apply via your CometChatTheme construction (see §1).
 
 // Or customize individual text styles
 CometChatTypography.Heading1.bold = UIFont.systemFont(ofSize: 28, weight: .bold)
@@ -620,6 +635,27 @@ extension UIColor {
 
 ---
 
+## Localization
+
+To translate the UI, switch the active language, or override individual strings, route to the dedicated **`cometchat-i18n`** skill — the canonical cross-family localization reference. iOS uses `CometChatLocalize` (see `cometchat-i18n` for the exact iOS signature). It covers bundled languages, custom translations, RTL, and date/time formatting. Docs: https://www.cometchat.com/docs/ui-kit/ios/localize
+
+## Sound Manager — custom notification & call sounds
+
+Sounds are a **behavioral** customization — driven by `CometChatSoundManager` (an instance class). The UI Kit plays the built-in cues automatically; use this to override a cue with your own audio file. (Docs: ui-kit/ios/sound-manager.)
+
+```swift
+// Play a default cue — Sound: .incomingMessage | .outgoingMessage | .incomingCall | .outgoingCall
+CometChatSoundManager().play(sound: .incomingMessage)
+
+// Override with a custom sound file (customSound: URL?)
+if let url = Bundle.main.url(forResource: "ping", withExtension: "wav") {
+    CometChatSoundManager().play(sound: .incomingMessage, customSound: url)
+}
+
+// Stop whatever is playing
+CometChatSoundManager().pause()
+```
+
 ## Best Practices
 
 1. **Configure theme early** — Set theme in `application(_:didFinishLaunchingWithOptions:)` before any CometChat UI is shown