Skip to content

v4.4.0 — Verified integrations + file-based init

Choose a tag to compare

View all tags
@swapnil-cometchat swapnil-cometchat released this 18 Jun 12:51
· 6 commits to main since this release
v4.4.0
a3903ce

@cometchat/skills v4.4.0

Release date: 2026-06-18
Previous release: v4.3.0

The headline: every code example the skills generate is now compile-verified against the live UI Kit on all seven platform targets, and file-based initialization (initFromSettings + a generated cometchat-settings.json) ships GA — verified end-to-end — on all six cores.

New

  • Compile-time verification of every code example. Every TypeScript, Kotlin, Dart, and Swift snippet in the skills is now type-checked against the real published UI Kit on each platform — web, React Native, Angular, Flutter (V5 and V6), iOS, and Android (V5, V6 Views, V6 Compose) — so generated integrations no longer drift from the current SDK APIs. The new Android Kotlin harness (verify:fences:android) completes seven-family compile coverage of every shipped example.
  • File-based initialization (initFromSettings) — GA on all six platforms. CometChatUIKit.initFromSettings reads a generated cometchat-settings.json (credentials, region, hosts, and call-SDK config) instead of an inline UIKitSettingsBuilder chain, so a single declarative file bootstraps the kit. Shipped GA and verified end-to-end on web (chat-uikit-react 6.5.2), React Native (chat-uikit-react-native 5.3.8), Angular (chat-uikit-angular 5.0.3), iOS (CometChatUIKitSwift 5.1.15), Android V6 (chatuikit-{kotlin,compose}-android 6.0.2 + chat-sdk-android 5.0.3), and Flutter V6 (cometchat_chat_uikit 6.0.3). A UIKitSettingsBuilder fallback is documented for older kit versions that predate file-based init.
  • Canonical feature-availability model. Per feature and per platform, the skills now state whether a chat or calls feature works out of the box, needs only a dashboard toggle, or requires code — making the cost of enabling each feature clear upfront.
  • Sound Manager coverage across all platforms for playing, pausing, customizing, and muting incoming/outgoing message and call sounds.
  • Text formatter guidance for mentions and custom inline formatting, cross-linked with localization so internationalized apps style formatted text correctly.
  • Verified call-feature coverage matrix documenting which calling capabilities — recording, picture-in-picture, screen-share, transcription, and virtual background — are supported on each platform.
  • Onboarding Journey specifications (1–11) covering account setup, app creation, credentials, the Visual-Builder-vs-code choice, user provisioning, integration, customization, feature enablement, advanced customization, and knowledge sources — each spec live-validated end to end against published SDKs.
  • Ground-truth + Official-docs header on all 119 skills, enforced by the test harness, so every skill declares its source of truth and the canonical docs page agents can fetch.
  • WORKFLOW.md and ARCHITECTURE.md developer documentation describing the end-to-end integration flow and the skills + CLI + registry architecture.

Enhancements

  • Angular re-verified as pure V5. Leftover V4 references removed so generated standalone-component integrations match the current Angular UI Kit exactly.
  • Theming aligned across web and Angular with the documented .cometchat style scope, per-message-type bubble selectors, and the full color-palette scale.
  • Moderation guidance now makes the Rules Management API canonical and guards against the deprecated extension path that could double-process messages.
  • Custom-message and customization recipes source-verified for four common scenarios (append, override, bubble, and message-option) against the UI Kit source on every platform.
  • Documentation-navigation coverage made consistent across the non-React UI Kits so feature and customization topics map the same way across all families.
  • Visual Builder integrations reconciled against the canonical builder reference applications on each platform — including iOS, whose export now builds and launches on a physical device, so iOS joins every other platform as a Visually-recommended default.
  • Visual Builder + feature-enablement composition verified live: cometchat apply-feature and cometchat builder export write to separate backend stores, so toggling features and exporting builders no longer overwrite each other, and both survive a --force resync.

Fixes

  • React message lists that wouldn't scroll or fill the space between the message header and composer — fixed by teaching the kit-injected .cometchat wrapper height rule.
  • Android calls idle-timeout was passed in milliseconds when the SDK API takes seconds, so the previous code effectively disabled the timeout (60_000 became a 16-hour timeout instead of 60 seconds) — corrected.
  • Fabricated hide*Button / callIdleTime config replaced with the real Call Settings APIs.
  • Cross-platform calls drift aligned to the V5 calls SDK across initialization, configuration, and listener APIs.
  • Flutter V6 Visual Builder initialization used V5-only extensions / aiFeature / callingExtension setters that don't exist in V6 — extensions and AI features now enable via the dashboard, with calling enabled through enableCalls.
  • Web Visual Builder export now splices the generated settings into the bundled CometChatSettings file instead of overwriting it, preserving the kit's settings interface and imports.
  • Android push registration passed the platform argument as a string instead of the required PushPlatforms enum — fixed.
  • Push-notification framing for Flutter and Android corrected (registration namespace).
  • Web drift corrected against @cometchat/chat-uikit-react@6.5.0 (component, core, theming, and feature symbols).
  • React Native drift — web-only props that don't exist on the React Native components removed, and theme token shapes corrected.
  • iOS drift across eight call, theming, and component sites surfaced by Swift type-checking, including the calls login and screen-share guidance.
  • Flutter V6 drift across customization, components, and production guidance — including the attachment-utility deep-import requirement that the barrel export doesn't expose.
  • Android V5 component and calls drift corrected against the current UI Kit.
  • Feature catalog moderation entries (Profanity Filter, AI Image Moderation, Malware & Virus Scanner, Sentiment, plus three legacy entries) repointed from deprecated extensions#… documentation anchors to the canonical Moderation Rules API documentation.
  • The apply-feature read-back check misread the dashboard's enabled/isActive flags and reported false "propagation lag" after enabling a feature — fixed.
  • Android V6 host-theme inheritance — the host theme must extend CometChatTheme.DayNight (Kotlin Views) or the first inflate crashes; skills now teach the correct base class.

Compatibility

  • Node.js 18 and later, including Angular CLI workflows on Node.js 20.19+ and 22.12+.
  • React 18 and React 19, verified against @cometchat/chat-uikit-react@6.5.0.
  • Next.js 13 and later with both App Router and Pages Router detection flows.
  • React Router v6 and v7, and Astro 4 and later.
  • Expo SDK 49 and later, and React Native 0.70 and later.
  • Angular 12 through 21 against the Angular V5 UI Kit.
  • Android V5 stable and Android V6 Compose and Views integrations.
  • Native iOS V5 integrations — including Visual Builder export, which now builds and launches on a physical device with CometChatBuilder 1.1.2.
  • Flutter V5 and Flutter V6 integrations, including production-ready V6 calls support on 6.0.1.

Known Issues

  • Bare React Native projects using @cometchat/chat-sdk-react-native@4.0.22: nested React Native dependency installation can cause AsyncStorage module mismatches at startup (pin 4.0.21 or add an npm override).
  • Non-blocking React Native Expo startup promise rejections caused by unresolved Hermes bytecode source maps.
  • Native iOS V5 calls integrations remain blocked while the required WebRTC binary package is unavailable from Cloudsmith.
  • Older iOS Visual Builder exports whose generated ThreadedMessagesVC.swift still references Layout.compactMessageComposer need a re-export from the dashboard; freshly exported builders build and launch clean.

Install

npx @cometchat/skills add

Then, in your IDE:

/cometchat add chat to my app

The dispatcher detects your framework, walks you through account setup and placement, and scaffolds the integration. Supported IDEs: Claude Code (default), Cursor, Kiro, VS Code Copilot, Windsurf, Cline, Replit Agent, and 30+ more agents. Pass --ide <name> or --ide all to target others.

Upgrading from v4.3.0

npm install @cometchat/skills@latest
# or, in a fresh project:
npx @cometchat/skills add

Existing v4.3.x integrations continue to function without modification — the changes in this release improve the accuracy of newly generated code and guidance. Rerunning /cometchat against an existing integration safely detects previously generated files and prompts before applying changes.

Assets 2
Loading