@cometchat/skills 4.4.0 → 4.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cometchat/skills",
-  "version": "4.4.0",
+  "version": "4.4.1",
   "publishConfig": {
     "access": "public"
   },

package/skills/cometchat-angular-patterns/SKILL.md

@@ -229,7 +229,7 @@ function boot() {
 if (typeof window === "undefined") {
   boot();                       // server render — skip CometChat init entirely
 } else {
-  CometChatUIKit.init(settings).then(boot).catch((e) => { console.error(e); boot(); });
+  (CometChatUIKit.init(settings) ?? Promise.resolve()).then(boot).catch((e) => { console.error(e); boot(); });
 }
 ```
 

package/skills/cometchat-astro-patterns/SKILL.md

@@ -673,7 +673,7 @@ const handleClose = () => console.log("closed");
 ## 10. Complete integration checklist
 
 1. Ensure `@astrojs/react` is installed: `npx astro add react`
-2. Install packages: `npm install @cometchat/chat-uikit-react @cometchat/chat-sdk-javascript`
+2. Install packages: `npm install @cometchat/chat-uikit-react@^6 @cometchat/chat-sdk-javascript@^4` — **⚠️ keep the `@^6` major pin; never install bare.** v7 is on npm — a bare `npm install @cometchat/chat-uikit-react` pulls it once it's tagged `latest`, and these v6 skills break against the v7 API.
 3. Create `.env` with `PUBLIC_COMETCHAT_APP_ID`, `PUBLIC_COMETCHAT_REGION`, `PUBLIC_COMETCHAT_AUTH_KEY`
 4. Add `.env` to `.gitignore`
 5. Create `src/components/CometChatProvider.tsx` with CSS import inside it (section 3)

package/skills/cometchat-core/SKILL.md

@@ -853,9 +853,11 @@ The UI Kit (`@cometchat/chat-uikit-react`) provides all the React components. Th
 Install with your project's package manager:
 
 ```bash
-npm install @cometchat/chat-uikit-react @cometchat/chat-sdk-javascript
+npm install @cometchat/chat-uikit-react@^6 @cometchat/chat-sdk-javascript@^4
 ```
 
+> ⚠️ **Keep the `@^6` / `@^4` major pins — never run a bare `npm install @cometchat/chat-uikit-react`.** v7 of the React UI Kit is published on npm; a bare (unpinned) install resolves to whatever is tagged `latest`, so once v7 promotes to `latest` it will pull v7 — and these skills teach the **v6** API, so the integration breaks. The `@^6` pin keeps you on the latest v6 (currently 6.5.2) regardless. Bump to `@^7` only when you've moved to the v7 skills.
+
 > 💡 **Cost transparency (ENG-35722) — disclose proactively when integrating into a new project:** the kit adds roughly **2.8 MB of JS** (~860 KB gzipped), **~860 KB of CSS**, and **~1.5 MB of Roboto TTF fonts** (9 weights bundled). If the customer's app already loads custom fonts, the Roboto bundle is redundant; override via the `--cometchat-font-family` CSS variable to skip preloading the kit fonts (the TTFs still ship but the browser doesn't download them unless they're actually used). For SaaS founders evaluating CometChat vs self-build, also mention:
 > - **Pricing:** https://www.cometchat.com/pricing (free tier covers small dev/test use)
 > - **Data extraction / migration:** REST API endpoints `GET /v3/users`, `GET /v3/groups`, `GET /v3/messages?conversationId=` can export everything; no proprietary lock-in

package/skills/cometchat-features/SKILL.md

@@ -276,7 +276,7 @@ CometChatConversations, etc.
 For these, the user opting in IS consent — run the install directly:
 
 ```bash
-npm install @cometchat/calls-sdk-javascript
+npm install @cometchat/calls-sdk-javascript@^5
 npx @cometchat/skills-cli verify --json
 ```
 

package/skills/cometchat-i18n/SKILL.md

@@ -161,7 +161,7 @@ After CometChat init is configured but before mounting any kit components:
 ```ts
 // React example — in your provider
 useEffect(() => {
-  CometChatUIKit.init(settings).then(() => {
+  CometChatUIKit.init(settings)?.then(() => {
     CometChatLocalize.init({ language: getUserLocale(), fallbackLanguage: "en" });
     // Now mount kit components
   });

package/skills/cometchat-native-bare-patterns/SKILL.md

@@ -54,8 +54,8 @@ Ground truth: `docs/ui-kit/react-native/react-native-cli-integration.mdx`, `appl
 
 ```bash
 # Core SDK + UI Kit
-npm install @cometchat/chat-sdk-react-native
-npm install @cometchat/chat-uikit-react-native
+npm install @cometchat/chat-sdk-react-native@^4
+npm install @cometchat/chat-uikit-react-native@^5
 
 # Natively-linked deps used by the kit + sample apps. (datetimepicker isn't a
 # declared kit peer, but every shipped sample installs it — keep it for parity.)

package/skills/cometchat-native-calls/SKILL.md

@@ -283,7 +283,7 @@ Without this guard, undefined env values produce opaque `TypeError: undefined is
 ### Bare RN CLI
 
 ```bash
-npm install @cometchat/chat-sdk-react-native @cometchat/calls-sdk-react-native
+npm install @cometchat/chat-sdk-react-native@^4 @cometchat/calls-sdk-react-native@^5
 npm install react-native-callkeep react-native-voip-push-notification @react-native-firebase/app @react-native-firebase/messaging
 npm install react-native-webrtc           # Calls SDK peer dep
 npm install react-native-gesture-handler react-native-reanimated  # already installed if using UI Kit

package/skills/cometchat-native-core/SKILL.md

@@ -467,7 +467,7 @@ npm install \
 Expo adds `expo-av` / `expo-image-picker` depending on which features you enable. Calls require the separate package PLUS the WebRTC native peers AND the polyfill peers the calls-sdk imports but doesn't declare:
 
 ```bash
-npm install @cometchat/calls-sdk-react-native \
+npm install @cometchat/calls-sdk-react-native@^5 \
   @react-native-community/netinfo \
   react-native-callstats \
   react-native-webrtc \

package/skills/cometchat-native-expo-patterns/SKILL.md

@@ -64,8 +64,8 @@ The UI Kit has a long peer-dep tail. Install them all in one shot so Expo's reso
 
 ```bash
 # Core SDK + UI Kit
-npm install @cometchat/chat-sdk-react-native
-npm install @cometchat/chat-uikit-react-native
+npm install @cometchat/chat-sdk-react-native@^4
+npm install @cometchat/chat-uikit-react-native@^5
 
 # Required peer deps (all natively-linked)
 npx expo install \
@@ -99,7 +99,7 @@ npx expo install \
 If the user's flow includes voice / video calls (the `cometchat-native-features` skill's § Calls gates this):
 
 ```bash
-npm install @cometchat/calls-sdk-react-native \
+npm install @cometchat/calls-sdk-react-native@^5 \
   react-native-url-polyfill \
   react-native-performance \
   valibot

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

@@ -136,7 +136,7 @@ Calls are the biggest "add a feature" step. They require the separate `@cometcha
 **Expo (managed workflow)**:
 
 ```bash
-npm install @cometchat/calls-sdk-react-native
+npm install @cometchat/calls-sdk-react-native@^5
 npx expo install \
   @react-native-community/netinfo \
   react-native-background-timer \

package/skills/cometchat-native-troubleshooting/SKILL.md

@@ -426,10 +426,10 @@ If the user is upgrading from `@cometchat/chat-uikit-react-native@4`, these are
 
 ```bash
 # 1. Update the main kit
-npm install @cometchat/chat-uikit-react-native@latest
+npm install @cometchat/chat-uikit-react-native@^5
 
 # 2. Install the full peer-dep set (v5 doesn't auto-install them like v4 did)
-npm install @cometchat/chat-sdk-react-native \
+npm install @cometchat/chat-sdk-react-native@^4 \
   @react-native-async-storage/async-storage \
   @react-native-clipboard/clipboard \
   @react-native-community/datetimepicker \

package/skills/cometchat-nextjs-patterns/SKILL.md

@@ -850,7 +850,7 @@ If the project has a custom `pages/_document.tsx` for font preloading or third-p
 
 ## 12. Complete integration checklist (App Router)
 
-1. Install packages: `npm install @cometchat/chat-uikit-react @cometchat/chat-sdk-javascript`
+1. Install packages: `npm install @cometchat/chat-uikit-react@^6 @cometchat/chat-sdk-javascript@^4` — **⚠️ keep the `@^6` major pin; never install bare.** v7 is on npm — a bare `npm install @cometchat/chat-uikit-react` pulls it once it's tagged `latest`, and these v6 skills break against the v7 API.
 2. Create `.env.local` with `NEXT_PUBLIC_COMETCHAT_APP_ID`, `NEXT_PUBLIC_COMETCHAT_REGION`, `NEXT_PUBLIC_COMETCHAT_AUTH_KEY`
 3. Import `@cometchat/chat-uikit-react/css-variables.css` in `app/globals.css`
 4. Create `app/providers/CometChatProvider.tsx` with `"use client"` (section 3)
@@ -861,7 +861,7 @@ If the project has a custom `pages/_document.tsx` for font preloading or third-p
 
 ## 13. Complete integration checklist (Pages Router)
 
-1. Install packages: `npm install @cometchat/chat-uikit-react @cometchat/chat-sdk-javascript`
+1. Install packages: `npm install @cometchat/chat-uikit-react@^6 @cometchat/chat-sdk-javascript@^4` — **⚠️ keep the `@^6` major pin; never install bare.** v7 is on npm — a bare `npm install @cometchat/chat-uikit-react` pulls it once it's tagged `latest`, and these v6 skills break against the v7 API.
 2. Create `.env.local` with `NEXT_PUBLIC_COMETCHAT_APP_ID`, `NEXT_PUBLIC_COMETCHAT_REGION`, `NEXT_PUBLIC_COMETCHAT_AUTH_KEY`
 3. Import `@cometchat/chat-uikit-react/css-variables.css` in `pages/_app.tsx`
 4. Create `components/CometChatProvider.tsx` (section 3 code, without `"use client"`)

package/skills/cometchat-react-patterns/SKILL.md

@@ -602,7 +602,7 @@ export default defineConfig({
 
 When integrating CometChat into a React (Vite/CRA) project, follow these steps in order:
 
-1. Install packages: `npm install @cometchat/chat-uikit-react @cometchat/chat-sdk-javascript`
+1. Install packages: `npm install @cometchat/chat-uikit-react@^6 @cometchat/chat-sdk-javascript@^4` — **⚠️ keep the `@^6` major pin; never install bare.** v7 is on npm — a bare `npm install @cometchat/chat-uikit-react` pulls it once it's tagged `latest`, and these v6 skills break against the v7 API.
 2. Create `.env` with `VITE_COMETCHAT_APP_ID`, `VITE_COMETCHAT_REGION`, `VITE_COMETCHAT_AUTH_KEY`
 3. Add `.env` to `.gitignore` if not already there
 4. Import `@cometchat/chat-uikit-react/css-variables.css` in `src/main.tsx`

package/skills/cometchat-react-router-patterns/SKILL.md

@@ -703,7 +703,7 @@ Do not mix v6 and v7 patterns. Detect the mode (section 1) and use the correct p
 
 ## 8. Complete integration checklist (v6 library mode)
 
-1. Install packages: `npm install @cometchat/chat-uikit-react @cometchat/chat-sdk-javascript`
+1. Install packages: `npm install @cometchat/chat-uikit-react@^6 @cometchat/chat-sdk-javascript@^4` — **⚠️ keep the `@^6` major pin; never install bare.** v7 is on npm — a bare `npm install @cometchat/chat-uikit-react` pulls it once it's tagged `latest`, and these v6 skills break against the v7 API.
 2. Create `.env` with `VITE_COMETCHAT_APP_ID`, `VITE_COMETCHAT_REGION`, `VITE_COMETCHAT_AUTH_KEY`
 3. Add `.env` to `.gitignore`
 4. Import `@cometchat/chat-uikit-react/css-variables.css` in `src/main.tsx`
@@ -715,7 +715,7 @@ Do not mix v6 and v7 patterns. Detect the mode (section 1) and use the correct p
 
 ## 9. Complete integration checklist (v7 framework mode)
 
-1. Install packages: `npm install @cometchat/chat-uikit-react @cometchat/chat-sdk-javascript`
+1. Install packages: `npm install @cometchat/chat-uikit-react@^6 @cometchat/chat-sdk-javascript@^4` — **⚠️ keep the `@^6` major pin; never install bare.** v7 is on npm — a bare `npm install @cometchat/chat-uikit-react` pulls it once it's tagged `latest`, and these v6 skills break against the v7 API.
 2. Create `.env` with `VITE_COMETCHAT_APP_ID`, `VITE_COMETCHAT_REGION`, `VITE_COMETCHAT_AUTH_KEY`
 3. Add `.env` to `.gitignore`
 4. Import `@cometchat/chat-uikit-react/css-variables.css` in `app/root.tsx`