react-native-carrot-quest 0.4.0 → 0.5.0

package/README.md

@@ -1,6 +1,25 @@
 # react-native-carrot-quest
 
-Unofficial React Native bindings for the [Carrot quest](https://www.carrotquest.io/) mobile SDKs, built with [Nitro Modules](https://nitro.margelo.com/).
+[![npm version](https://img.shields.io/npm/v/react-native-carrot-quest)](https://www.npmjs.com/package/react-native-carrot-quest)
+[![npm downloads](https://img.shields.io/npm/dm/react-native-carrot-quest)](https://www.npmjs.com/package/react-native-carrot-quest)
+[![CI](https://github.com/Ahmedhamed77/react-native-carrot-quest/actions/workflows/ci.yml/badge.svg)](https://github.com/Ahmedhamed77/react-native-carrot-quest/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/react-native-carrot-quest)](./LICENSE)
+![platforms](https://img.shields.io/badge/platforms-iOS%20%7C%20Android-blue)
+
+**Carrot quest SDK for React Native** — add the [Carrot quest](https://www.carrotquest.io/)
+(carrotquest) customer messenger to your iOS and Android app: live chat with
+support, push notifications, user identification and properties, event and
+screen tracking, and UTM attribution. Unofficial, typed in TypeScript, and built
+with [Nitro Modules](https://nitro.margelo.com/) for the React Native New
+Architecture.
+
+```ts
+import { setup, hashedAuth, openChat } from 'react-native-carrot-quest';
+
+await setup('YOUR_API_KEY');
+await hashedAuth(userId, hashFromYourBackend);
+await openChat();
+```
 
 > **Not affiliated with Carrot quest.** Carrot does not officially support React
 > Native, so this package maintains its own compatibility coverage against the
@@ -415,7 +434,7 @@ Only set it if you need to pin the chat to one language.
 | Platform | Pinned |
 |---|---|
 | iOS | `CarrotquestSDK ~> 3.4` (verified against 3.4.0) |
-| Android | `io.carrotquest:android-sdk:3.4.2-commonRelease` |
+| Android | `io.carrotquest:android-sdk:3.5.1-commonRelease` |
 
 Upgrading an existing iOS app: run `pod update CarrotquestSDK` — a Podfile.lock
 pinned to 3.1–3.3 will not move on its own, and 3.4+ is required for the log and
@@ -425,7 +444,7 @@ Carrot publishes one Android artifact per region flavour — `commonRelease` or
 `usRelease`. Override from your app's `android/build.gradle`:
 
 ```gradle
-ext { carrotSdkVersion = "3.4.2-usRelease" }
+ext { carrotSdkVersion = "3.5.1-usRelease" }
 ```
 
 **Android 2.x is not supported.** It exposes a callback-free `setup()` that

package/android/build.gradle

@@ -7,11 +7,11 @@ buildscript {
     // Carrot publishes one artifact per region flavour: `commonRelease` for the
     // default servers, `usRelease` for the US ones. Override from your app's
     // android/build.gradle:
-    //   ext { carrotSdkVersion = "3.4.2-usRelease" }
+    //   ext { carrotSdkVersion = "3.5.1-usRelease" }
     //
     // Must stay on the 3.x line — 2.x has a callback-free `setup`, a `setDebug`
     // toggle and JSON-string event params, none of which this bridge uses.
-    carrotSdkVersion: "3.4.2-commonRelease"
+    carrotSdkVersion: "3.5.1-commonRelease"
   ]
 
   ext.getExtOrDefault = { prop ->

package/android/src/main/java/com/margelo/nitro/carrotquest/CarrotQuest.kt

@@ -416,7 +416,9 @@ class CarrotQuest : HybridCarrotQuestSpec() {
   override fun trackUtm(url: String) {
     if (url.isEmpty()) return
 
-    Carrot.trackUtm(url)
+    CarrotQuestSetup.runWhenConfigured("trackUtm") {
+      Carrot.trackUtm(url)
+    }
   }
 
   // MARK: - Push notifications
@@ -492,12 +494,8 @@ class CarrotQuest : HybridCarrotQuestSpec() {
       val result = mutableMapOf<String, String>()
 
       json.keys().forEach { key ->
-        val value = json.get(key)
-        result[key] = if (value is JSONObject || value is org.json.JSONArray) {
-          value.toString()
-        } else {
-          value.toString()
-        }
+        // Nested objects/arrays are re-encoded as JSON, as FCM delivers them.
+        result[key] = json.get(key).toString()
       }
 
       result

package/ios/CarrotQuest.swift

@@ -404,7 +404,11 @@ final class CarrotQuest: HybridCarrotQuestSpec {
   func trackUtm(url: String) throws {
     guard let parsed = URL(string: url) else { return }
 
-    Carrot.shared.trackUtm(parsed)
+    // Queued like every other call: a campaign deep link that opens the app
+    // cold arrives before setup has finished.
+    CarrotQuestSetup.runWhenConfigured("trackUtm") {
+      Carrot.shared.trackUtm(parsed)
+    }
   }
 
   // MARK: - Push notifications

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-carrot-quest",
-  "version": "0.4.0",
-  "description": "Unofficial React Native bindings for the Carrot quest SDK, built with Nitro Modules.",
+  "version": "0.5.0",
+  "description": "React Native SDK for Carrot quest (carrotquest) — live chat, push notifications, user tracking and events for iOS and Android. Unofficial, built with Nitro Modules.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
   "exports": {
@@ -47,8 +47,31 @@
   },
   "keywords": [
     "react-native",
+    "react-native-carrot-quest",
+    "carrot-quest",
+    "carrotquest",
+    "carrot quest",
+    "react-native-carrotquest",
+    "nitro",
+    "nitro-modules",
+    "react-native-nitro-modules",
+    "customer-support",
+    "live-chat",
+    "chat",
+    "in-app-chat",
+    "messenger",
+    "crm",
+    "push-notifications",
+    "user-tracking",
+    "analytics",
+    "marketing-automation",
     "ios",
-    "android"
+    "android",
+    "swift",
+    "kotlin",
+    "typescript",
+    "new-architecture",
+    "sdk"
   ],
   "repository": {
     "type": "git",