react-native-carrot-quest 0.1.0 → 0.3.0

package/CarrotQuest.podspec

@@ -11,7 +11,7 @@ Pod::Spec.new do |s|
   s.authors      = package["author"]
 
   s.platforms    = { :ios => min_ios_version_supported }
-  s.source       = { :git => "https://github.com/ticketscloud/react-native-carrot-quest.git", :tag => "#{s.version}" }
+  s.source       = { :git => "https://github.com/Ahmedhamed77/react-native-carrot-quest.git", :tag => "v#{s.version}" }
 
   s.source_files = [
     "ios/**/*.{swift}",
@@ -22,10 +22,11 @@ Pod::Spec.new do |s|
   s.dependency 'React-jsi'
   s.dependency 'React-callinvoker'
 
-  # Allows any 3.x. The public API used here was verified against 3.1.6 and
-  # 3.2.1; CarrotquestSDK is a closed-source vendor pod, so pin it yourself in
-  # your app's Podfile if you need a specific build.
-  s.dependency 'CarrotquestSDK', '~> 3.1'
+  # 3.4+ is required: the log sink and diagnostics API the bridge uses
+  # (`setLogSink`, `getDiagnostics`) first shipped there. The public API used
+  # here was verified against 3.4.0; CarrotquestSDK is a closed-source vendor
+  # pod, so pin it yourself in your app's Podfile if you need a specific build.
+  s.dependency 'CarrotquestSDK', '~> 3.4'
 
   load 'nitrogen/generated/ios/CarrotQuest+autolinking.rb'
   add_nitrogen_files(s)

package/README.md

@@ -342,8 +342,8 @@ On Android, links route through the activity named by
 | `wasPushShownEarlier(payload)` | `Promise<boolean>` | ✅ | — |
 | `onUrlOpen(source, cb)` | `Subscription` | ✅ | — |
 | `openBrowserLink(url)` / `openUniversalLink(url)` | `void` | ✅ | — |
-| `getDiagnostics()` | `string \| undefined` | — | ✅ |
-| `onLog(cb)` | `Subscription` | — | ✅ |
+| `getDiagnostics()` | `string \| undefined` | ✅ | ✅ |
+| `onLog(cb)` | `Subscription` | ✅ | ✅ |
 
 Methods that cannot meaningfully fail are synchronous and return `void`. Methods
 that can fail return a `Promise` so you get the error. A `—` means the platform's
@@ -351,8 +351,8 @@ SDK has no equivalent; those calls are inert rather than throwing.
 
 ### Forwarding SDK logs
 
-Android only. Useful for routing the SDK's own diagnostics into your crash
-reporter:
+Both platforms (iOS needs `CarrotquestSDK` 3.4+). Useful for routing the SDK's
+own diagnostics into your crash reporter:
 
 ```ts
 import { onLog } from 'react-native-carrot-quest';
@@ -414,14 +414,18 @@ Only set it if you need to pin the chat to one language.
 
 | Platform | Pinned |
 |---|---|
-| iOS | `CarrotquestSDK ~> 3.1` (verified against 3.2.1) |
-| Android | `io.carrotquest:android-sdk:3.1.0-commonRelease` |
+| iOS | `CarrotquestSDK ~> 3.4` (verified against 3.4.0) |
+| Android | `io.carrotquest:android-sdk:3.4.2-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
+diagnostics APIs.
 
 Carrot publishes one Android artifact per region flavour — `commonRelease` or
 `usRelease`. Override from your app's `android/build.gradle`:
 
 ```gradle
-ext { carrotSdkVersion = "3.1.0-usRelease" }
+ext { carrotSdkVersion = "3.4.2-usRelease" }
 ```
 
 **Android 2.x is not supported.** It exposes a callback-free `setup()` that

package/android/build.gradle

@@ -6,11 +6,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.1.0-usRelease" }
+    //   ext { carrotSdkVersion = "3.4.2-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.1.0-commonRelease"
+    carrotSdkVersion: "3.4.2-commonRelease"
   ]
 
   ext.getExtOrDefault = { prop ->
@@ -120,7 +120,7 @@ repositories {
   // Carrot quest publishes its Android SDK from a GitHub-hosted Maven repo
   // rather than Maven Central.
   maven { url "https://raw.github.com/carrotquest/android-sdk/carrotquest" }
-  // Required for the SDK's own transitive GitHub dependencies — 3.1.0 pulls
+  // Required for the SDK's own transitive GitHub dependencies — 3.x pulls
   // com.github.Redman1037:TSnackBar and com.github.chrisbanes:PhotoView.
   maven { url "https://jitpack.io" }
 }

package/ios/CarrotQuest.swift

@@ -24,7 +24,9 @@ final class CarrotQuest: HybridCarrotQuestSpec {
       theme: options?.theme.map { NSNumber(value: Self.nativeTheme($0).rawValue) },
       useEuServer: options?.useEuServer ?? false,
       appGroup: options?.appGroup,
-      isServiceMode: options?.isServiceMode ?? false
+      isServiceMode: options?.isServiceMode ?? false,
+      logLevel: options?.logLevel.map { NSNumber(value: Self.nativeLogLevel($0).rawValue) },
+      logIncludeSensitive: options?.logIncludeSensitive.map { NSNumber(value: $0) }
     ) { error in
       if let error = error {
         promise.reject(withError: error)
@@ -573,16 +575,85 @@ final class CarrotQuest: HybridCarrotQuestSpec {
   // MARK: - Diagnostics
 
   func getDiagnostics() throws -> String? {
-    // Android-only: the iOS SDK exposes no diagnostics dump.
-    return nil
+    // Deliberately not gated on setup: the snapshot carries `isInitialized` and
+    // `recentLogs`, which are what you want when setup fails.
+    return Carrot.shared.getDiagnostics().toFormattedString()
   }
 
+  /// Strong reference: the SDK takes the sink as a protocol object and may not
+  /// retain it, so dropping this would silently stop log delivery.
+  private static var logSink: CarrotQuestLogSink?
+
   func onLog(listener: @escaping (CarrotQuestLogEntry) -> Void) throws {
-    // Android-only: the iOS SDK has no logging hook to attach to.
-    // Documented on the spec; intentionally inert here.
+    let sink = CarrotQuestLogSink(listener: listener)
+
+    Self.logSink = sink
+    Carrot.shared.setLogSink(sink)
   }
 
   func offLog() throws {
-    // Nothing was ever attached on iOS.
+    Carrot.shared.setLogSink(nil)
+    Self.logSink = nil
+  }
+
+  private static func nativeLogLevel(_ level: CarrotQuestLogLevel) -> SdkLogLevel {
+    switch level {
+    case .none: return .none
+    case .error: return .error
+    case .warn: return .warn
+    case .info: return .info
+    // Spelled `debugging` on the JS side — `DEBUG` is a C macro in RN Debug builds.
+    case .debugging: return .debug
+    case .verbose: return .verbose
+    }
+  }
+
+  fileprivate static func jsLogLevel(_ level: SdkLogLevel) -> CarrotQuestLogLevel {
+    switch level {
+    case .none: return .none
+    case .error: return .error
+    case .warn: return .warn
+    case .info: return .info
+    case .debug: return .debugging
+    case .verbose: return .verbose
+    // Future SDK levels: report them at the closest known verbosity.
+    @unknown default: return .verbose
+    }
+  }
+
+  fileprivate static func jsLogCategory(_ category: SdkLogCategory) -> CarrotQuestLogCategory {
+    switch category {
+    case .general: return .general
+    case .network: return .network
+    case .connectivity: return .connectivity
+    case .auth: return .auth
+    case .realtime: return .realtime
+    case .lifecycle: return .lifecycle
+    case .push: return .push
+    @unknown default: return .general
+    }
+  }
+}
+
+/// Adapts the SDK's `SdkLogSink` protocol to a JS listener.
+private final class CarrotQuestLogSink: SdkLogSink {
+  private let listener: (CarrotQuestLogEntry) -> Void
+
+  init(listener: @escaping (CarrotQuestLogEntry) -> Void) {
+    self.listener = listener
+  }
+
+  func onLog(_ entry: SdkLogEntry) {
+    listener(
+      CarrotQuestLogEntry(
+        timestampMs: entry.timestamp.timeIntervalSince1970 * 1000,
+        level: CarrotQuest.jsLogLevel(entry.level),
+        category: CarrotQuest.jsLogCategory(entry.category),
+        tag: entry.tag,
+        message: entry.message,
+        fields: entry.fields,
+        error: entry.error.map { String(describing: $0) }
+      )
+    )
   }
 }

package/ios/CarrotQuestSetup.swift

@@ -133,6 +133,9 @@ import CarrotSDK
   ///   - useEuServer: Route traffic to Carrot's EU servers.
   ///   - appGroup: App Group shared with your Notification Service Extension.
   ///   - isServiceMode: Run without UI, for use inside an extension process.
+  ///   - logLevel: Optional `SdkLogLevel` raw value, applied before `setup` so
+  ///     initialisation itself is logged at the requested level.
+  ///   - logIncludeSensitive: Allow tokens and user ids into SDK logs.
   @objc public static func configure(
     apiKey: String,
     locale: String? = nil,
@@ -140,6 +143,8 @@ import CarrotSDK
     useEuServer: Bool = false,
     appGroup: String? = nil,
     isServiceMode: Bool = false,
+    logLevel: NSNumber? = nil,
+    logIncludeSensitive: NSNumber? = nil,
     completion: ((Error?) -> Void)? = nil
   ) {
     let identity = Identity(
@@ -158,6 +163,10 @@ import CarrotSDK
 
       let conflict = self.conflict(between: existing, and: identity)
 
+      if conflict == nil {
+        applyLogging(level: logLevel, includeSensitive: logIncludeSensitive)
+      }
+
       if conflict == nil, let theme = theme {
         // Identity matches, so this is a re-configure rather than a second
         // init. Apply the mutable options instead of dropping them — a native
@@ -178,6 +187,8 @@ import CarrotSDK
 
       // Join the in-flight attempt rather than initialising a second time, but
       // carry this caller's theme into it so it is not lost.
+      applyLogging(level: logLevel, includeSensitive: logIncludeSensitive)
+
       if let theme = theme {
         pendingTheme = theme
       }
@@ -202,6 +213,9 @@ import CarrotSDK
       applyLocale(locale)
     }
 
+    // Logging first, so initialisation itself is covered by the level.
+    applyLogging(level: logLevel, includeSensitive: logIncludeSensitive)
+
     DispatchQueue.global(qos: .userInitiated).async {
       Carrot.shared.setup(
         withApiKey: apiKey,
@@ -279,6 +293,17 @@ import CarrotSDK
     }
   }
 
+  /// Apply logging options. Plain setters, safe before or after `setup`.
+  private static func applyLogging(level: NSNumber?, includeSensitive: NSNumber?) {
+    if let level = level, let value = SdkLogLevel(rawValue: level.intValue) {
+      Carrot.shared.setLogLevel(value)
+    }
+
+    if let includeSensitive = includeSensitive {
+      Carrot.shared.setLogIncludeSensitive(includeSensitive.boolValue)
+    }
+  }
+
   /// Refuse to re-point a live SDK at a different account or server.
   ///
   /// Silently keeping the first configuration would let a second `setup` call

package/lib/typescript/src/CarrotQuest.nitro.d.ts

@@ -8,8 +8,8 @@ import type { HybridObject } from 'react-native-nitro-modules';
  */
 export type CarrotQuestTheme = 'light' | 'dark' | 'fromDevice' | 'fromWeb';
 /**
- * Android SDK log level, in increasing verbosity. Android only — the iOS SDK
- * exposes no logging control.
+ * Native SDK log level, in increasing verbosity. Both platforms (iOS needs
+ * `CarrotquestSDK` 3.4+).
  *
  * `debugging` maps to the SDK's `DEBUG` level. It is spelled out rather than
  * abbreviated because Nitro derives a C++ enum member from each value, and
@@ -18,11 +18,12 @@ export type CarrotQuestTheme = 'light' | 'dark' | 'fromDevice' | 'fromWeb';
  */
 export type CarrotQuestLogLevel = 'none' | 'error' | 'warn' | 'info' | 'debugging' | 'verbose';
 /**
- * Which subsystem produced a log entry. Mirrors Android's `SdkLogCategory`.
+ * Which subsystem produced a log entry. Mirrors `SdkLogCategory`. `database` is
+ * emitted by Android only.
  */
 export type CarrotQuestLogCategory = 'general' | 'network' | 'connectivity' | 'auth' | 'realtime' | 'lifecycle' | 'database' | 'push';
 /**
- * A single log line emitted by the native SDK. Android only.
+ * A single log line emitted by the native SDK.
  */
 export interface CarrotQuestLogEntry {
     /** Milliseconds since the Unix epoch. */
@@ -148,11 +149,11 @@ export interface CarrotQuestSetupOptions {
      * Android only.
      */
     notificationIconResourceName?: string;
-    /** SDK log level. Android only. */
+    /** SDK log level. */
     logLevel?: CarrotQuestLogLevel;
     /**
-     * Allow sensitive values (tokens, user ids) into SDK logs. Android only.
-     * Leave off in production.
+     * Allow sensitive values (tokens, user ids) into SDK logs. Leave off in
+     * production.
      */
     logIncludeSensitive?: boolean;
 }
@@ -366,14 +367,15 @@ export interface CarrotQuest extends HybridObject<{
     /**
      * A formatted dump of the SDK's internal state and recent logs.
      *
-     * Android only, via `getDiagnostics()`. Returns `undefined` on iOS.
+     * Backed by `getDiagnostics()` on both platforms. Safe to call before or
+     * after {@link setup} — including after it fails, when the dump is most
+     * useful.
      */
     getDiagnostics(): string | undefined;
     /**
      * Receive the SDK's log entries, e.g. to forward them to a crash reporter.
      *
-     * Android only, via `setLogSink`. Never fires on iOS, whose SDK exposes no
-     * logging hook.
+     * Backed by `setLogSink` on both platforms.
      *
      * Entries are filtered by {@link CarrotQuestSetupOptions.logLevel}, so leave
      * that at `info` or lower in production — `verbose` crosses the bridge for

package/lib/typescript/src/CarrotQuest.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CarrotQuest.nitro.d.ts","sourceRoot":"","sources":["../../../src/CarrotQuest.nitro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CarrotQuest.nitro.d.ts","sourceRoot":"","sources":["../../../src/CarrotQuest.nitro.ts"],"names":[],"mappings":"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"}

package/nitrogen/generated/android/kotlin/com/margelo/nitro/carrotquest/Func_void_CarrotQuestLogEntry.kt

@@ -10,7 +10,6 @@ package com.margelo.nitro.carrotquest
 import androidx.annotation.Keep
 import com.facebook.jni.HybridData
 import com.facebook.proguard.annotations.DoNotStrip
-import dalvik.annotation.optimization.FastNative
 
 
 /**
@@ -59,7 +58,6 @@ class Func_void_CarrotQuestLogEntry_cxx: Func_void_CarrotQuestLogEntry {
   override fun invoke(entry: CarrotQuestLogEntry): Unit
     = invoke_cxx(entry)
 
-  @FastNative
   private external fun invoke_cxx(entry: CarrotQuestLogEntry): Unit
 }
 

package/nitrogen/generated/android/kotlin/com/margelo/nitro/carrotquest/Func_void_bool.kt

@@ -10,7 +10,6 @@ package com.margelo.nitro.carrotquest
 import androidx.annotation.Keep
 import com.facebook.jni.HybridData
 import com.facebook.proguard.annotations.DoNotStrip
-import dalvik.annotation.optimization.FastNative
 
 
 /**
@@ -59,7 +58,6 @@ class Func_void_bool_cxx: Func_void_bool {
   override fun invoke(visible: Boolean): Unit
     = invoke_cxx(visible)
 
-  @FastNative
   private external fun invoke_cxx(visible: Boolean): Unit
 }
 

package/nitrogen/generated/android/kotlin/com/margelo/nitro/carrotquest/Func_void_double.kt

@@ -10,7 +10,6 @@ package com.margelo.nitro.carrotquest
 import androidx.annotation.Keep
 import com.facebook.jni.HybridData
 import com.facebook.proguard.annotations.DoNotStrip
-import dalvik.annotation.optimization.FastNative
 
 
 /**
@@ -59,7 +58,6 @@ class Func_void_double_cxx: Func_void_double {
   override fun invoke(count: Double): Unit
     = invoke_cxx(count)
 
-  @FastNative
   private external fun invoke_cxx(count: Double): Unit
 }
 

package/nitrogen/generated/android/kotlin/com/margelo/nitro/carrotquest/Func_void_std__string.kt

@@ -10,7 +10,6 @@ package com.margelo.nitro.carrotquest
 import androidx.annotation.Keep
 import com.facebook.jni.HybridData
 import com.facebook.proguard.annotations.DoNotStrip
-import dalvik.annotation.optimization.FastNative
 
 
 /**
@@ -59,7 +58,6 @@ class Func_void_std__string_cxx: Func_void_std__string {
   override fun invoke(url: String): Unit
     = invoke_cxx(url)
 
-  @FastNative
   private external fun invoke_cxx(url: String): Unit
 }
 

package/nitrogen/generated/android/kotlin/com/margelo/nitro/carrotquest/HybridCarrotQuestSpec.kt

@@ -10,6 +10,7 @@ package com.margelo.nitro.carrotquest
 import androidx.annotation.Keep
 import com.facebook.jni.HybridData
 import com.facebook.proguard.annotations.DoNotStrip
+import dalvik.annotation.optimization.FastNative
 import com.margelo.nitro.core.Promise
 import com.margelo.nitro.core.HybridObject
 
@@ -197,6 +198,7 @@ abstract class HybridCarrotQuestSpec: HybridObject() {
   @Keep
   protected open class CxxPart(javaPart: HybridCarrotQuestSpec): HybridObject.CxxPart(javaPart) {
     // C++ JHybridCarrotQuestSpec::CxxPart::initHybrid(...)
+    @FastNative
     external override fun initHybrid(): HybridData
   }
   override fun createCxxPart(): CxxPart {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-carrot-quest",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Unofficial React Native bindings for the Carrot quest SDK, built with Nitro Modules.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -42,7 +42,8 @@
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
     "test": "jest",
     "test:coverage": "jest --coverage",
-    "verify:native": "node scripts/verify-native-api.mjs"
+    "verify:native": "node scripts/verify-native-api.mjs",
+    "release": "release-it --only-version"
   },
   "keywords": [
     "react-native",
@@ -64,34 +65,39 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
+    "@commitlint/config-conventional": "^21.2.0",
     "@eslint/compat": "^2.1.0",
     "@eslint/eslintrc": "^3.3.5",
     "@eslint/js": "^10.0.1",
     "@react-native/babel-preset": "0.85.0",
     "@react-native/eslint-config": "0.85.0",
+    "@release-it/conventional-changelog": "^12.0.0",
     "@types/jest": "^29",
     "@types/node": "^26.1.2",
     "@types/react": "^19.2.0",
     "babel-jest": "^29",
+    "commitlint": "^21.2.1",
     "del-cli": "^7.0.0",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-ft-flow": "^3.0.11",
     "eslint-plugin-prettier": "^5.5.6",
     "jest": "^29",
-    "nitrogen": "^0.35.3",
+    "lefthook": "^2.1.10",
+    "nitrogen": "^0.37.1",
     "prettier": "^3.8.3",
     "react": "19.2.3",
     "react-native": "0.85.0",
     "react-native-builder-bob": "^0.41.0",
-    "react-native-nitro-modules": "^0.35.3",
+    "react-native-nitro-modules": "^0.37.1",
+    "release-it": "^21.0.1",
     "turbo": "^2.9.16",
     "typescript": "^6.0.3"
   },
   "peerDependencies": {
     "react": "*",
     "react-native": "*",
-    "react-native-nitro-modules": "^0.35.3"
+    "react-native-nitro-modules": "^0.37.1"
   },
   "workspaces": [
     "example"
@@ -136,5 +142,32 @@
       "eslint"
     ],
     "version": "0.63.0"
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}",
+      "requireBranch": "main"
+    },
+    "npm": {
+      "publish": false
+    },
+    "github": {
+      "release": false
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "infile": "CHANGELOG.md",
+        "header": "# Changelog",
+        "preset": {
+          "name": "conventionalcommits"
+        }
+      }
+    }
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
   }
 }

package/src/CarrotQuest.nitro.ts

@@ -10,8 +10,8 @@ import type { HybridObject } from 'react-native-nitro-modules';
 export type CarrotQuestTheme = 'light' | 'dark' | 'fromDevice' | 'fromWeb';
 
 /**
- * Android SDK log level, in increasing verbosity. Android only — the iOS SDK
- * exposes no logging control.
+ * Native SDK log level, in increasing verbosity. Both platforms (iOS needs
+ * `CarrotquestSDK` 3.4+).
  *
  * `debugging` maps to the SDK's `DEBUG` level. It is spelled out rather than
  * abbreviated because Nitro derives a C++ enum member from each value, and
@@ -22,7 +22,8 @@ export type CarrotQuestLogLevel =
   'none' | 'error' | 'warn' | 'info' | 'debugging' | 'verbose';
 
 /**
- * Which subsystem produced a log entry. Mirrors Android's `SdkLogCategory`.
+ * Which subsystem produced a log entry. Mirrors `SdkLogCategory`. `database` is
+ * emitted by Android only.
  */
 export type CarrotQuestLogCategory =
   | 'general'
@@ -35,7 +36,7 @@ export type CarrotQuestLogCategory =
   | 'push';
 
 /**
- * A single log line emitted by the native SDK. Android only.
+ * A single log line emitted by the native SDK.
  */
 export interface CarrotQuestLogEntry {
   /** Milliseconds since the Unix epoch. */
@@ -189,11 +190,11 @@ export interface CarrotQuestSetupOptions {
    * Android only.
    */
   notificationIconResourceName?: string;
-  /** SDK log level. Android only. */
+  /** SDK log level. */
   logLevel?: CarrotQuestLogLevel;
   /**
-   * Allow sensitive values (tokens, user ids) into SDK logs. Android only.
-   * Leave off in production.
+   * Allow sensitive values (tokens, user ids) into SDK logs. Leave off in
+   * production.
    */
   logIncludeSensitive?: boolean;
 }
@@ -464,15 +465,16 @@ export interface CarrotQuest extends HybridObject<{
   /**
    * A formatted dump of the SDK's internal state and recent logs.
    *
-   * Android only, via `getDiagnostics()`. Returns `undefined` on iOS.
+   * Backed by `getDiagnostics()` on both platforms. Safe to call before or
+   * after {@link setup} — including after it fails, when the dump is most
+   * useful.
    */
   getDiagnostics(): string | undefined;
 
   /**
    * Receive the SDK's log entries, e.g. to forward them to a crash reporter.
    *
-   * Android only, via `setLogSink`. Never fires on iOS, whose SDK exposes no
-   * logging hook.
+   * Backed by `setLogSink` on both platforms.
    *
    * Entries are filtered by {@link CarrotQuestSetupOptions.logLevel}, so leave
    * that at `info` or lower in production — `verbose` crosses the bridge for