@coralogix/react-native-plugin 0.1.5 → 0.1.6

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## 0.1.6 (2025-10-26)
+### Patch
+- Bump android native version to 2.5.51
+- Bump ios native version to 1.3.0
+
+### 🚀 Features
+- Integrate support for the Coralogix Gradle Plugin for automatic network instrumentation
+- Added granular control for disabling only specific mobile vitals detectors
+
 ## 0.1.5 (2025-10-13)
 
 ### 🩹 Fixes

package/CxSdk.podspec

@@ -16,8 +16,8 @@ Pod::Spec.new do |s|
 
   s.source_files = "ios/**/*.{h,m,mm,swift}"
 
-  s.dependency 'Coralogix','1.2.3'
-  s.dependency 'CoralogixInternal','1.2.3'
+  s.dependency 'Coralogix','1.3.0'
+  s.dependency 'CoralogixInternal','1.3.0'
 
 
   # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.

package/README.md

@@ -112,6 +112,24 @@ await CoralogixRum.init({
 });
 ```
 
+### Mobile Vital Detectors
+
+Disable specific mobile vitals detection and collection
+
+```javascript
+await CoralogixRum.init({
+  // ...
+  mobileVitals: {
+    warm: true,
+    cold: true,
+    cpu: true,
+    memory: true,
+    rendering: true,
+    slowFrozenFrames: true,
+  }
+});
+```
+
 ### Ignore Errors
 
 The ignoreErrors option allows you to exclude errors that meet specific criteria.
@@ -177,6 +195,52 @@ await CoralogixRum.init({
 });
 ```
 
+### Optional - Coralogix Gradle Plugin (Android)
+
+The Coralogix Gradle Plugin automatically instruments all OkHttp clients in your app (including third-party SDKs) at build time.
+This ensures that all network traffic is automatically traced and reported to Coralogix, with no manual setup or code changes required.
+This plugin is especially useful for instrumenting networking libraries that create their own OkHttpClient instances internally and would otherwise be impossible to monitor.
+
+#### Apply the plugin
+
+1. Add the plugin to your project classpath <br /> In your project-level `build.gradle` file:
+    ```groovy
+    buildscript {
+        dependencies {
+            classpath "com.coralogix.gradle.plugin:gradle-plugin:0.0.2"
+        }
+    }
+    ```
+
+2. Apply the plugin in your app module <br /> At the top of your app-level build.gradle file:
+
+    ```groovy
+    apply plugin: "com.coralogix.gradle.plugin"
+    ```
+
+#### Configure the plugin
+
+The plugin exposes a simple Gradle extension you can use in your app module:
+
+```groovy
+coralogix {
+  // Enable or disable instrumentation (default: true)
+  enabled = true
+
+  // Print debug logs during the build process (default: false)
+  log = false
+}
+```
+
+If the default configuration suits your needs, you can safely omit this block — the defaults will apply automatically.
+
+#### Note
+
+This plugin is optional.
+Regular JavaScript `fetch` calls and standard network requests will still be instrumented without it.
+
+However, the plugin is the only way to capture network activity from third-party libraries or SDKs that use their own `OkHttpClient` instances internally.
+
 ### Troubleshooting
 
 #### URL.origin is not implemented

package/android/build.gradle

@@ -75,7 +75,7 @@ dependencies {
   implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
 
-  implementation "com.coralogix:android-sdk:2.5.2"
+  implementation "com.coralogix:android-sdk:2.5.51"
 }
 
 react {

package/android/src/main/java/com/cxsdk/CxSdkModule.kt

@@ -15,6 +15,7 @@ import com.coralogix.android.sdk.model.CoralogixOptions
 import com.coralogix.android.sdk.model.Framework
 import com.coralogix.android.sdk.model.HybridMetric
 import com.coralogix.android.sdk.model.Instrumentation
+import com.coralogix.android.sdk.model.MobileVitalType
 import com.coralogix.android.sdk.model.UserContext
 import com.coralogix.android.sdk.model.ViewContext
 import com.facebook.react.bridge.Arguments
@@ -171,6 +172,12 @@ class CxSdkModule(reactContext: ReactApplicationContext) :
     CoralogixRum.reportMobileVitalsMeasurement(type, list)
   }
 
+  @ReactMethod
+  override fun isCoralogixGradlePluginApplied(promise: Promise) {
+    val applied = CoralogixRum.isCoralogixGradlePluginApplied(reactApplicationContext)
+    promise.resolve(applied)
+  }
+
   @ReactMethod
   override fun shutdown(promise: Promise) {
     Handler(Looper.getMainLooper()).post {
@@ -222,11 +229,11 @@ class CxSdkModule(reactContext: ReactApplicationContext) :
       userContext = getMap("user_context")?.toUserContext() ?: UserContext(),
       viewContext = ViewContext(getMap("view_context")?.getString("view") ?: ""),
       instrumentations = getMap("instrumentations")?.toInstrumentationMap() ?: mapOf(),
+      mobileVitalsOptions = getMap("mobileVitals")?.toMobileVitalsOptions() ?: mapOf(),
       ignoreUrls = getArray("ignoreUrls")?.handleStringOrRegexList() ?: listOf(),
       ignoreErrors = getArray("ignoreErrors")?.handleStringOrRegexList() ?: listOf(),
       sessionSampleRate = 100,
       traceParentInHeader = isTraceParentInHeaderEnabled,
-      fpsSamplingSeconds = if (hasKey("fpsSamplingSeconds")) getLong("fpsSamplingSeconds") else 300,
       debug = if (hasKey("debug")) getBoolean("debug") else false,
       proxyUrl = getString("proxyUrl"),
       beforeSendCallback = ::beforeSendCallback,
@@ -234,6 +241,25 @@ class CxSdkModule(reactContext: ReactApplicationContext) :
     )
   }
 
+  private fun ReadableMap.toMobileVitalsOptions(): Map<MobileVitalType, Boolean> {
+    val mapping = mapOf(
+      "cold" to MobileVitalType.ColdStartTime,
+      "warm" to MobileVitalType.WarmStartTime,
+      "cpu" to MobileVitalType.CpuUsage,
+      "memory" to MobileVitalType.MemoryUsage,
+      "slowFrozenFrames" to MobileVitalType.SlowFrozenFrames,
+      "rendering" to MobileVitalType.Fps
+    )
+
+    return buildMap {
+      for ((key, type) in mapping) {
+        if (hasKey(key) && !isNull(key)) {
+          put(type, getBoolean(key))
+        }
+      }
+    }
+  }
+
   private fun beforeSendCallback(data: List<Map<String, Any?>>) {
     val args = convertAnyListToWritableArray(data)
     if (!reactApplicationContext.hasActiveReactInstance()) return

package/android/src/main/java/com/cxsdk/ICxSdkModule.kt

@@ -20,5 +20,6 @@ interface ICxSdkModule {
   fun sendCxSpanData(results: ReadableArray)
   fun reportMobileVitalsMeasurement(type: String, value: Double, units: String)
   fun reportMobileVitalsMeasurementSet(type: String, metrics: ReadableArray)
+  fun isCoralogixGradlePluginApplied(promise: Promise)
   fun shutdown(promise: Promise)
 }

package/index.cjs.js

@@ -219,7 +219,7 @@ function stopJsRefreshRateSampler() {
   appStateSub = null;
 }
 
-var version = "0.1.5";
+var version = "0.1.6";
 var pkg = {
 	version: version};
 
@@ -417,7 +417,7 @@ const CoralogixRum = {
       logger.debug('CoralogixRum: Session tracking is disabled');
       return;
     }
-    registerCoralogixInstrumentations(resolvedOptions);
+    await registerCoralogixInstrumentations(resolvedOptions);
     await CxSdk.initialize(_extends({}, resolvedOptions, {
       frameworkVersion: pkg.version
     }));
@@ -544,11 +544,15 @@ const CoralogixRum = {
   }
 };
 function trackMobileVitals(options) {
-  startJsRefreshRateSampler(_extends({}, options.jsRefreshRateSampleRate, {
-    onSample: jsRefreshRate => {
-      CxSdk.reportMobileVitalsMeasurement('js_refresh_rate', Math.round(jsRefreshRate), 'fps');
-    }
-  }));
+  var _options$mobileVitals;
+  const shouldEnableJsRefreshRateDetector = ((_options$mobileVitals = options.mobileVitals) == null ? void 0 : _options$mobileVitals.jsRefreshRate) !== false;
+  if (shouldEnableJsRefreshRateDetector) {
+    startJsRefreshRateSampler(_extends({}, options.jsRefreshRateSampleRate, {
+      onSample: jsRefreshRate => {
+        CxSdk.reportMobileVitalsMeasurement('js_refresh_rate', Math.round(jsRefreshRate), 'fps');
+      }
+    }));
+  }
 
   // startJSLoopDetector({
   //   ...options.jsLoopDetection,
@@ -575,7 +579,7 @@ function cleanupResources() {
   stopJsRefreshRateSampler();
   // stopJSLoopDetector();
 }
-function registerCoralogixInstrumentations(options) {
+async function registerCoralogixInstrumentations(options) {
   if (options.beforeSend) {
     beforeSendCallback = options.beforeSend;
   }
@@ -583,8 +587,13 @@ function registerCoralogixInstrumentations(options) {
   const instrumentations = [];
   const instrumentationsOptions = options.instrumentations;
 
-  // disable network for ios, since swizzle will capture the fetch requests
-  const shouldInterceptNetowrk = reactNative.Platform.OS === 'android' && (!instrumentationsOptions || instrumentationsOptions.network !== false);
+  // disable network for ios, since swizzle will capture the fetch requests, and for android if gradle plugin is applied
+  const isAndroid = reactNative.Platform.OS === 'android';
+  let pluginApplied = false;
+  if (isAndroid) {
+    pluginApplied = await CxSdk.isCoralogixGradlePluginApplied();
+  }
+  const shouldInterceptNetowrk = isAndroid && !pluginApplied && (!instrumentationsOptions || instrumentationsOptions.network !== false);
   const shouldInterceptErrors = !instrumentationsOptions || instrumentationsOptions.errors !== false;
   const shouldInterceptMobileVitals = !instrumentationsOptions || instrumentationsOptions.mobile_vitals !== false;
 

package/index.esm.js

@@ -217,7 +217,7 @@ function stopJsRefreshRateSampler() {
   appStateSub = null;
 }
 
-var version = "0.1.5";
+var version = "0.1.6";
 var pkg = {
 	version: version};
 
@@ -415,7 +415,7 @@ const CoralogixRum = {
       logger.debug('CoralogixRum: Session tracking is disabled');
       return;
     }
-    registerCoralogixInstrumentations(resolvedOptions);
+    await registerCoralogixInstrumentations(resolvedOptions);
     await CxSdk.initialize(_extends({}, resolvedOptions, {
       frameworkVersion: pkg.version
     }));
@@ -542,11 +542,15 @@ const CoralogixRum = {
   }
 };
 function trackMobileVitals(options) {
-  startJsRefreshRateSampler(_extends({}, options.jsRefreshRateSampleRate, {
-    onSample: jsRefreshRate => {
-      CxSdk.reportMobileVitalsMeasurement('js_refresh_rate', Math.round(jsRefreshRate), 'fps');
-    }
-  }));
+  var _options$mobileVitals;
+  const shouldEnableJsRefreshRateDetector = ((_options$mobileVitals = options.mobileVitals) == null ? void 0 : _options$mobileVitals.jsRefreshRate) !== false;
+  if (shouldEnableJsRefreshRateDetector) {
+    startJsRefreshRateSampler(_extends({}, options.jsRefreshRateSampleRate, {
+      onSample: jsRefreshRate => {
+        CxSdk.reportMobileVitalsMeasurement('js_refresh_rate', Math.round(jsRefreshRate), 'fps');
+      }
+    }));
+  }
 
   // startJSLoopDetector({
   //   ...options.jsLoopDetection,
@@ -573,7 +577,7 @@ function cleanupResources() {
   stopJsRefreshRateSampler();
   // stopJSLoopDetector();
 }
-function registerCoralogixInstrumentations(options) {
+async function registerCoralogixInstrumentations(options) {
   if (options.beforeSend) {
     beforeSendCallback = options.beforeSend;
   }
@@ -581,8 +585,13 @@ function registerCoralogixInstrumentations(options) {
   const instrumentations = [];
   const instrumentationsOptions = options.instrumentations;
 
-  // disable network for ios, since swizzle will capture the fetch requests
-  const shouldInterceptNetowrk = Platform.OS === 'android' && (!instrumentationsOptions || instrumentationsOptions.network !== false);
+  // disable network for ios, since swizzle will capture the fetch requests, and for android if gradle plugin is applied
+  const isAndroid = Platform.OS === 'android';
+  let pluginApplied = false;
+  if (isAndroid) {
+    pluginApplied = await CxSdk.isCoralogixGradlePluginApplied();
+  }
+  const shouldInterceptNetowrk = isAndroid && !pluginApplied && (!instrumentationsOptions || instrumentationsOptions.network !== false);
   const shouldInterceptErrors = !instrumentationsOptions || instrumentationsOptions.errors !== false;
   const shouldInterceptMobileVitals = !instrumentationsOptions || instrumentationsOptions.mobile_vitals !== false;
 

package/ios/CxSdk.swift

@@ -63,7 +63,7 @@ class CxSdk: RCTEventEmitter {
   @objc(getUserContext:withRejecter:)
   func getUserContext(resolve: @escaping RCTPromiseResolveBlock,
                       reject: @escaping RCTPromiseRejectBlock) {
-    let userContext = coralogixRum?.getUserContext()
+    let userContext = coralogixRum?.userContext
     resolve(userContext?.getDictionary())
   }
 
@@ -72,13 +72,13 @@ class CxSdk: RCTEventEmitter {
                  resolve:RCTPromiseResolveBlock,
                  reject:RCTPromiseRejectBlock) -> Void {
     let labels = labelsMap as? [String: String] ?? [String: String]()
-    resolve(coralogixRum?.setLabels(labels: labels))
+    resolve(coralogixRum?.set(labels: labels))
   }
 
   @objc(getLabels:withRejecter:)
   func getLabels(resolve: @escaping RCTPromiseResolveBlock,
                  reject: @escaping RCTPromiseRejectBlock) {
-    if let labels = coralogixRum?.getLabels() {
+    if let labels = coralogixRum?.labels {
       resolve(labels) // Assuming labels is a Dictionary or Array
     } else {
       reject("GET_LABELS_ERROR", "Failed to retrieve labels", nil)
@@ -100,7 +100,7 @@ class CxSdk: RCTEventEmitter {
   @objc(isInited:withRejecter:)
   func isInited(resolve: @escaping RCTPromiseResolveBlock,
                 reject: @escaping RCTPromiseRejectBlock) {
-    if let isInit = coralogixRum?.isInitialized() {
+    if let isInit = coralogixRum?.isInitialized {
       resolve(isInit)
     } else {
       reject("IS_INITED", "Failed to retrieve isInited", nil)
@@ -149,7 +149,7 @@ class CxSdk: RCTEventEmitter {
   @objc(getSessionId:withRejecter:)
   func getSessionId(resolve: @escaping RCTPromiseResolveBlock,
                     reject: @escaping RCTPromiseRejectBlock) -> Void {
-    let sessionId = coralogixRum?.getSessionId()
+    let sessionId = coralogixRum?.getSessionId
     resolve(sessionId)
   }
 
@@ -199,7 +199,7 @@ class CxSdk: RCTEventEmitter {
       reject("Invalid sendBeforeSendData", "sendBeforeSendData is not a dictionary", nil)
       return
     }
-    coralogixRum?.sendBeforeSendData(data: beforeSendResults)
+    coralogixRum?.sendBeforeSendData(beforeSendResults)
     resolve("sendBeforeSendData success")
   }
 
@@ -270,6 +270,14 @@ class CxSdk: RCTEventEmitter {
       }
     }
 
+    let mobileVitals = parameter["mobileVitals"] as? [String: Int] ?? [String: Int]()
+    var mobileVitalsDict: [CoralogixExporterOptions.MobileVitalsType: Bool] = [:]
+    for (key, value) in mobileVitals {
+      if let mobileVitalsKey = mobileVitalsType(from: key) {
+        mobileVitalsDict[mobileVitalsKey] = value == 0 ? false : true
+      }
+    }
+
     let userContext = parameter["user_context"] as? [String: Any]
     let userMetadata = userContext?["user_metadata"] as? [String: String] ?? [String: String]()
     let coralogixUser = UserContext(userId: userContext?["user_id"] as? String ?? "",
@@ -287,12 +295,12 @@ class CxSdk: RCTEventEmitter {
                                            ignoreUrls: ignoreUrls,
                                            ignoreErrors: ignoreError,
                                            labels: labels,
-                                           sampleRate: 100,
-                                           mobileVitalsFPSSamplingRate: parameter["fpsSamplingSeconds"] as? Int ?? 300,
+                                           fpsSampleRate: parameter["fpsSamplingSeconds"] as? TimeInterval ?? 300,
                                            instrumentations: instrumentationDict,
                                            collectIPData: parameter["collectIPData"] as? Bool ?? true,
                                            proxyUrl: parameter["proxyUrl"] as? String ?? nil,
                                            traceParentInHeader: parameter["traceParentInHeader"] as? [String: Any] ?? nil,
+                                           mobileVitals: mobileVitalsDict,
                                            debug: parameter["debug"] as? Bool ?? true)
 
     return options
@@ -326,6 +334,25 @@ class CxSdk: RCTEventEmitter {
                        userMetadata: userMetadata)
   }
 
+  private func mobileVitalsType(from string: String) -> CoralogixExporterOptions.MobileVitalsType? {
+    switch string {
+    case "warm":
+      return .warmDetector
+    case "cold":
+      return .coldDetector
+    case "rendering":
+      return .renderingDetector
+    case "cpu":
+      return .cpuDetector
+    case "memory":
+      return .memoryDetector
+    case "slowFrozenFrames":
+      return .slowFrozenFramesDetector
+    default:
+      return nil
+    }
+  }
+  
   private func instrumentationType(from string: String) -> CoralogixExporterOptions.InstrumentationType? {
     switch string {
     case "mobile_vitals":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coralogix/react-native-plugin",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Official Coralogix React Native plugin",
   "license": "Apache-2.0",
   "author": "Coralogix",

package/src/index.d.ts

@@ -8,3 +8,4 @@ export { type CoralogixBrowserSdkConfig, CoralogixLogSeverity, } from './model/T
 export { type CoralogixOtelWebOptionsInstrumentations } from './model/CoralogixOtelWebOptionsInstrumentations';
 export { type CustomMeasurement } from './model/CustomMeasurement';
 export { type NetworkRequestDetails } from './model/NetworkRequestDetails';
+export { type CoralogixMobileVitals } from './model/CoralogixMobileVitals';

package/src/model/CoralogixMobileVitals.d.ts

@@ -0,0 +1,9 @@
+export interface CoralogixMobileVitals {
+    warm?: boolean;
+    cold?: boolean;
+    cpu?: boolean;
+    memory?: boolean;
+    rendering?: boolean;
+    slowFrozenFrames?: boolean;
+    jsRefreshRate?: boolean;
+}

package/src/model/Types.d.ts

@@ -3,6 +3,7 @@ import type { CoralogixOtelWebOptionsInstrumentations } from './CoralogixOtelWeb
 import { CoralogixDomain } from './CoralogixDomain';
 import { UserContextConfig } from './UserContextConfig';
 import { ViewContextConfig } from './ViewContextConfig';
+import type { CoralogixMobileVitals } from './CoralogixMobileVitals.ts';
 export interface CxSpan {
     version_metadata: VersionMetaData;
     applicationName: string;
@@ -200,6 +201,7 @@ export interface CoralogixBrowserSdkConfig {
         /** Interval between FPS measurements in milliseconds (default: 300000 = 5 minutes) */
         sampleIntervalMs?: number;
     };
+    mobileVitals?: CoralogixMobileVitals;
 }
 export type HybridMetric = {
     name: string;