@coralogix/react-native-plugin 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## 0.5.0 (2026-05-17)
+
+### 🚀 Features
+
+- bridge startTimeMeasure / endTimeMeasure to native (CX-40525)
+- expose excludeFromSampling on JS config + native bridges
+
+## Unreleased
+
+### 🚀 Features
+
+- Bridge `CoralogixRum.startTimeMeasure(name, labels?)` / `CoralogixRum.endTimeMeasure(name)` to the native iOS and Android SDKs as a fire-and-forget pass-through ([CX-40525](https://coralogix.atlassian.net/browse/CX-40525)). The JS side keeps no state — native owns the in-flight registry.
+
 ## 0.4.0 (2026-05-03)
 
 ### 🚀 Features

package/CxSdk.podspec

@@ -16,9 +16,9 @@ Pod::Spec.new do |s|
 
   s.source_files = "ios/**/*.{h,m,mm,swift}"
 
-  s.dependency 'Coralogix','2.6.2'
-  s.dependency 'CoralogixInternal','2.6.2'
-  s.dependency 'SessionReplay','2.6.2'
+  s.dependency 'Coralogix','2.6.4'
+  s.dependency 'CoralogixInternal','2.6.4'
+  s.dependency 'SessionReplay','2.6.4'
 
   # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
   # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.

package/README.md

@@ -156,6 +156,25 @@ await CoralogixRum.init({
 });
 ```
 
+### Exclude From Sampling
+
+By default, when a session is sampled out (via `sessionSampleRate`), nothing is
+emitted for that session. Use `excludeFromSampling` to keep emitting specific
+event categories even when the session is sampled out.
+
+```javascript
+import { CoralogixRum } from '@coralogix/react-native-plugin';
+
+await CoralogixRum.init({
+  // ...
+  sessionSampleRate: 10,
+  excludeFromSampling: ['errors', 'logs'], // always emitted, even for sampled-out sessions
+});
+```
+
+Allowed values: `'errors'`, `'logs'`, `'network'`, `'userInteractions'`,
+`'mobileVitals'`, `'customSpan'`, `'customMeasurement'`.
+
 ### Ignore Errors
 
 The ignoreErrors option allows you to exclude errors that meet specific criteria.
@@ -235,6 +254,30 @@ const tracer = CoralogixRum.getCustomTracer(['networkRequests', 'userInteraction
 
 > **Note:** Only one global span may be active at a time. `startGlobalSpan` returns `null` if a global span is already open.
 
+### Time Measurement
+
+Measure the duration of arbitrary flows with a pair of `startTimeMeasure(name, labels?)` / `endTimeMeasure(name)` calls. The native SDK records start/end timestamps and reports the delta as a custom-measurement span (milliseconds).
+
+```javascript
+import { CoralogixRum } from '@coralogix/react-native-plugin';
+
+CoralogixRum.startTimeMeasure('checkout', { flow: 'checkout' });
+
+await validateCart();
+await charge();
+await confirm();
+
+CoralogixRum.endTimeMeasure('checkout');
+```
+
+**Behaviour:**
+
+- Both calls are fire-and-forget — they cross the bridge directly into native and return immediately.
+- The JS side keeps no state; the native SDK owns the in-flight registry.
+- **You are responsible for pairing every `startTimeMeasure(name, labels?)` with exactly one `endTimeMeasure(name)`.** Leaked starts persist in memory until `CoralogixRum.shutdown()`.
+- Unmatched `endTimeMeasure` calls are dropped silently by the native SDK.
+- Calling `startTimeMeasure` again with an open `name` overwrites the previous start.
+
 ### Traces Exporter
 
 Receive OTLP-formatted trace batches from the native SDK in your JavaScript code. Use this to forward spans to an OTLP-compatible backend (e.g. Jaeger, custom collector) alongside Coralogix.

package/android/build.gradle

@@ -84,7 +84,7 @@ dependencies {
   implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
 
-  implementation "com.coralogix:android-sdk:2.11.2"
+  implementation "com.coralogix:android-sdk:2.12.0"
 
   testImplementation "org.jetbrains.kotlin:kotlin-test:$kotlin_version"
   testImplementation "org.mockito:mockito-core:5.12.0"

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

@@ -8,6 +8,7 @@ import com.coralogix.android.sdk.CoralogixRum
 import com.coralogix.android.sdk.customspans.CoralogixCustomSpan
 import com.coralogix.android.sdk.customspans.CoralogixGlobalSpan
 import com.coralogix.android.sdk.customspans.CoralogixIgnoredInstrument
+import com.coralogix.android.sdk.model.ExcludableInstrumentation
 import com.coralogix.android.sdk.traceexporter.CoralogixTraceExporterData
 import com.coralogix.android.sdk.internal.features.instrumentations.error.CoralogixErrorDecorator
 import com.coralogix.android.sdk.internal.features.instrumentations.network.NetworkRequestDetails
@@ -142,6 +143,16 @@ class CxSdkModule(reactContext: ReactApplicationContext) :
     CoralogixRum.sendCustomMeasurement(name, value)
   }
 
+  @ReactMethod
+  override fun startTimeMeasure(name: String, labels: ReadableMap?) {
+    CoralogixRum.startTimeMeasure(name, labels?.toStringAnyMap() ?: emptyMap())
+  }
+
+  @ReactMethod
+  override fun endTimeMeasure(name: String) {
+    CoralogixRum.endTimeMeasure(name)
+  }
+
   @ReactMethod
   override fun reportError(details: ReadableMap) {
     val errorType = details.getString("error_type").orEmpty()
@@ -425,6 +436,13 @@ class CxSdkModule(reactContext: ReactApplicationContext) :
       getArray("networkExtraConfig")?.toNetworkCaptureRuleList() ?: emptyList()
     else emptyList()
 
+    val excludeFromSampling = if (hasKey("excludeFromSampling") && !isNull("excludeFromSampling"))
+      getArray("excludeFromSampling")?.toExcludeFromSamplingList() ?: emptyList()
+    else emptyList()
+
+    val sessionSampleRate =
+      if (hasKey("sessionSampleRate") && !isNull("sessionSampleRate")) getInt("sessionSampleRate") else 100
+
     return CoralogixOptions(
       applicationName = applicationName,
       coralogixDomain = coralogixDomain,
@@ -438,7 +456,8 @@ class CxSdkModule(reactContext: ReactApplicationContext) :
       mobileVitalsOptions = getMap("mobileVitals")?.toMobileVitalsOptions() ?: mapOf(),
       ignoreUrls = getArray("ignoreUrls")?.handleStringOrRegexList() ?: listOf(),
       ignoreErrors = getArray("ignoreErrors")?.handleStringOrRegexList() ?: listOf(),
-      sessionSampleRate = 100,
+      sessionSampleRate = sessionSampleRate,
+      excludeFromSampling = excludeFromSampling,
       traceParentInHeader = traceParentInHeaderConfig,
       debug = if (hasKey("debug")) getBoolean("debug") else false,
       proxyUrl = getString("proxyUrl"),
@@ -851,6 +870,24 @@ class CxSdkModule(reactContext: ReactApplicationContext) :
     return set
   }
 
+  private fun ReadableArray.toExcludeFromSamplingList(): List<ExcludableInstrumentation> {
+    val set = LinkedHashSet<ExcludableInstrumentation>()
+    for (i in 0 until size()) {
+      val value = getString(i)
+      when (value) {
+        "errors" -> set.add(ExcludableInstrumentation.Errors)
+        "logs" -> set.add(ExcludableInstrumentation.Logs)
+        "network" -> set.add(ExcludableInstrumentation.Network)
+        "userInteractions" -> set.add(ExcludableInstrumentation.UserInteractions)
+        "mobileVitals" -> set.add(ExcludableInstrumentation.MobileVitals)
+        "customSpan" -> set.add(ExcludableInstrumentation.CustomSpan)
+        "customMeasurement" -> set.add(ExcludableInstrumentation.CustomMeasurement)
+        else -> Log.w("CxSdkModule", "excludeFromSampling: unrecognized value '$value' — native enum may have drifted")
+      }
+    }
+    return set.toList()
+  }
+
   private fun ReadableArray.toHybridMetricList(): List<HybridMetric> {
     val out = ArrayList<HybridMetric>(size())
     for (i in 0 until size()) {

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

@@ -16,6 +16,8 @@ interface RUMClient {
   fun log(severity: Int, message: String, data: ReadableMap, labels: ReadableMap)
   fun reportNetworkRequest(requestDetails: ReadableMap)
   fun sendCustomMeasurement(measurement: ReadableMap)
+  fun startTimeMeasure(name: String, labels: ReadableMap?)
+  fun endTimeMeasure(name: String)
   fun reportError(details: ReadableMap)
   fun sendCxSpanData(results: ReadableArray)
   fun reportMobileVitalsMeasurement(type: String, value: Double, units: String)

package/index.cjs.js

@@ -33,6 +33,12 @@ let CoralogixLogSeverity = /*#__PURE__*/function (CoralogixLogSeverity) {
  * being linked to spans created by that tracer.
  */
 
+/**
+ * Event categories that can opt out of session sampling. When the session is
+ * sampled out, events whose category is listed in `excludeFromSampling` are still
+ * emitted; everything else is dropped. Mirrors the iOS/Android native enums.
+ */
+
 /** OTLP JSON-format trace data delivered to the `tracesExporter` callback. */
 
 const ERROR_INSTRUMENTATION_NAME = 'errors';
@@ -531,7 +537,7 @@ function stopJsRefreshRateSampler() {
   appStateSub = null;
 }
 
-var version = "0.4.0";
+var version = "0.5.0";
 var pkg = {
 	version: version};
 
@@ -995,14 +1001,15 @@ const CoralogixRum = {
     return isInited;
   },
   init: async function (options) {
-    var _resolvedOptions$debu;
+    var _resolvedOptions$debu, _resolvedOptions$excl, _resolvedOptions$excl2;
     if (isInited) {
       console.warn('[Coralogix React Native SDK] - already initialized');
       return;
     }
     const resolvedOptions = resolveCoralogixOtelWebConfig(options);
     logger.shouldLog = (_resolvedOptions$debu = resolvedOptions.debug) != null ? _resolvedOptions$debu : false;
-    if (!isSamplingOn(resolvedOptions.sessionSampleRate)) {
+    const hasExcludeOverrides = ((_resolvedOptions$excl = (_resolvedOptions$excl2 = resolvedOptions.excludeFromSampling) == null ? void 0 : _resolvedOptions$excl2.length) != null ? _resolvedOptions$excl : 0) > 0;
+    if (!isSamplingOn(resolvedOptions.sessionSampleRate) && !hasExcludeOverrides) {
       logger.debug('CoralogixRum: Session tracking is disabled');
       return;
     }
@@ -1166,6 +1173,20 @@ const CoralogixRum = {
     }
     CxSdk.sendCustomMeasurement(measurement);
   },
+  startTimeMeasure: (name, labels) => {
+    if (!isInited) {
+      logger.debug('CoralogixRum must be initiated before startTimeMeasure');
+      return;
+    }
+    CxSdk.startTimeMeasure(name, labels != null ? labels : {});
+  },
+  endTimeMeasure: name => {
+    if (!isInited) {
+      logger.debug('CoralogixRum must be initiated before endTimeMeasure');
+      return;
+    }
+    CxSdk.endTimeMeasure(name);
+  },
   reportError: (error, isCrash) => {
     if (!isInited) {
       logger.debug('CoralogixRum must be initiated before error reporting');

package/index.esm.js

@@ -31,6 +31,12 @@ let CoralogixLogSeverity = /*#__PURE__*/function (CoralogixLogSeverity) {
  * being linked to spans created by that tracer.
  */
 
+/**
+ * Event categories that can opt out of session sampling. When the session is
+ * sampled out, events whose category is listed in `excludeFromSampling` are still
+ * emitted; everything else is dropped. Mirrors the iOS/Android native enums.
+ */
+
 /** OTLP JSON-format trace data delivered to the `tracesExporter` callback. */
 
 const ERROR_INSTRUMENTATION_NAME = 'errors';
@@ -529,7 +535,7 @@ function stopJsRefreshRateSampler() {
   appStateSub = null;
 }
 
-var version = "0.4.0";
+var version = "0.5.0";
 var pkg = {
 	version: version};
 
@@ -993,14 +999,15 @@ const CoralogixRum = {
     return isInited;
   },
   init: async function (options) {
-    var _resolvedOptions$debu;
+    var _resolvedOptions$debu, _resolvedOptions$excl, _resolvedOptions$excl2;
     if (isInited) {
       console.warn('[Coralogix React Native SDK] - already initialized');
       return;
     }
     const resolvedOptions = resolveCoralogixOtelWebConfig(options);
     logger.shouldLog = (_resolvedOptions$debu = resolvedOptions.debug) != null ? _resolvedOptions$debu : false;
-    if (!isSamplingOn(resolvedOptions.sessionSampleRate)) {
+    const hasExcludeOverrides = ((_resolvedOptions$excl = (_resolvedOptions$excl2 = resolvedOptions.excludeFromSampling) == null ? void 0 : _resolvedOptions$excl2.length) != null ? _resolvedOptions$excl : 0) > 0;
+    if (!isSamplingOn(resolvedOptions.sessionSampleRate) && !hasExcludeOverrides) {
       logger.debug('CoralogixRum: Session tracking is disabled');
       return;
     }
@@ -1164,6 +1171,20 @@ const CoralogixRum = {
     }
     CxSdk.sendCustomMeasurement(measurement);
   },
+  startTimeMeasure: (name, labels) => {
+    if (!isInited) {
+      logger.debug('CoralogixRum must be initiated before startTimeMeasure');
+      return;
+    }
+    CxSdk.startTimeMeasure(name, labels != null ? labels : {});
+  },
+  endTimeMeasure: name => {
+    if (!isInited) {
+      logger.debug('CoralogixRum must be initiated before endTimeMeasure');
+      return;
+    }
+    CxSdk.endTimeMeasure(name);
+  },
   reportError: (error, isCrash) => {
     if (!isInited) {
       logger.debug('CoralogixRum must be initiated before error reporting');

package/ios/CxSdk.mm

@@ -80,6 +80,11 @@ RCT_EXTERN_METHOD(sendCustomMeasurement:(NSDictionary *)measurement
                   withResolver:(RCTPromiseResolveBlock)resolve
                   withRejecter:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(startTimeMeasure:(NSString *)name
+                  labels:(NSDictionary *)labels)
+
+RCT_EXTERN_METHOD(endTimeMeasure:(NSString *)name)
+
 RCT_EXTERN_METHOD(initializeSessionReplay:(NSDictionary *)options
                   withResolver:(RCTPromiseResolveBlock)resolve
                   withRejecter:(RCTPromiseRejectBlock)reject)

package/ios/CxSdk.swift

@@ -368,6 +368,17 @@ class CxSdk: RCTEventEmitter {
     resolve("sendCustomMeasurement success")
   }
 
+  @objc(startTimeMeasure:labels:)
+  func startTimeMeasure(name: String, labels: NSDictionary) {
+    let labelsDict = labels as? [String: Any]
+    coralogixRum?.startTimeMeasure(name: name, labels: labelsDict)
+  }
+
+  @objc(endTimeMeasure:)
+  func endTimeMeasure(name: String) {
+    coralogixRum?.endTimeMeasure(name: name)
+  }
+
   private func toHybridMetricList(metrics: NSArray) -> [HybridMetric] {
     let array = metrics as? [[String: Any]] ?? []
 
@@ -472,6 +483,9 @@ class CxSdk: RCTEventEmitter {
     let ignoreError = (parameter["ignoreErrors"] as? [Any])?.compactMap { $0 as? String } ?? []
     let rawNetworkExtraConfig = parameter["networkExtraConfig"] as? [[String: Any]]
     let networkExtraConfig = toNetworkCaptureRuleList(rawNetworkExtraConfig)
+    let excludeFromSampling = toExcludeFromSampling(parameter["excludeFromSampling"] as? [Any])
+
+    let sessionSampleRate = (parameter["sessionSampleRate"] as? NSNumber)?.intValue ?? 100
 
     let options = CoralogixExporterOptions(
       coralogixDomain: coralogixDomain,
@@ -483,6 +497,8 @@ class CxSdk: RCTEventEmitter {
                                            ignoreUrls: ignoreUrls,
                                            ignoreErrors: ignoreError,
                                            labels: labels,
+                                           sessionSampleRate: sessionSampleRate,
+                                           excludeFromSampling: excludeFromSampling,
                                            instrumentations: instrumentationDict,
                                            collectIPData: parameter["collectIPData"] as? Bool ?? true,
                                           proxyUrl: parameter["proxyUrl"] as? String ?? nil,
@@ -594,6 +610,23 @@ class CxSdk: RCTEventEmitter {
     }
   }
 
+  private func toExcludeFromSampling(_ raw: [Any]?) -> Set<ExcludableInstrumentation> {
+    guard let raw = raw else { return [] }
+    var result: Set<ExcludableInstrumentation> = []
+    for value in raw {
+      guard let key = value as? String else {
+        debugPrint("[CxSdk] excludeFromSampling: ignoring non-string value \(value)")
+        continue
+      }
+      guard let instrumentation = ExcludableInstrumentation(rawValue: key) else {
+        debugPrint("[CxSdk] excludeFromSampling: unrecognized value '\(key)' — native enum may have drifted")
+        continue
+      }
+      result.insert(instrumentation)
+    }
+    return result
+  }
+
   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.4.0",
+  "version": "0.5.0",
   "description": "Official Coralogix React Native plugin",
   "license": "Apache-2.0",
   "author": "Coralogix",

package/src/index.d.ts

@@ -21,6 +21,8 @@ interface CxSdkClient {
     setViewContext(viewContext: string): void;
     log(severity: CoralogixLogSeverity, message: string, data: Record<string, any> | undefined | null, labels: Record<string, any> | undefined | null): void;
     sendCustomMeasurement(measurement: CustomMeasurement): void;
+    startTimeMeasure(name: string, labels: Record<string, unknown>): void;
+    endTimeMeasure(name: string): void;
     reportError(details: Record<string, string>): void;
     reportNetworkRequest(details: NetworkRequestDetails): void;
     shutdown(): Promise<boolean>;
@@ -57,7 +59,7 @@ export { type ApplicationContextConfig } from './model/ApplicationContextConfig'
 export { type ViewContextConfig } from './model/ViewContextConfig';
 export { CoralogixDomain } from './model/CoralogixDomain';
 export { type UserContextConfig } from './model/UserContextConfig';
-export { type CoralogixBrowserSdkConfig, type CoralogixIgnoredInstrument, type NetworkCaptureRule, type TraceExporterData, CoralogixLogSeverity, } from './model/Types';
+export { type CoralogixBrowserSdkConfig, type CoralogixIgnoredInstrument, type ExcludableInstrumentation, type NetworkCaptureRule, type TraceExporterData, CoralogixLogSeverity, } from './model/Types';
 export { type CoralogixOtelWebOptionsInstrumentations } from './model/CoralogixOtelWebOptionsInstrumentations';
 export { type CustomMeasurement } from './model/CustomMeasurement';
 export { type NetworkRequestDetails } from './model/NetworkRequestDetails';

package/src/model/CoralogixOtelWebType.d.ts

@@ -41,6 +41,19 @@ export interface CoralogixOtelWebType extends SendLog {
      * Send custom key value pair
      */
     sendCustomMeasurement: (measurement: CustomMeasurement) => void;
+    /**
+     * Start a time measurement for `name`. The native SDK records the start
+     * timestamp; the call is fire-and-forget. Pair every `startTimeMeasure`
+     * with exactly one `endTimeMeasure(name)` — leaked starts persist in
+     * memory until shutdown.
+     */
+    startTimeMeasure: (name: string, labels?: Record<string, unknown>) => void;
+    /**
+     * End a previously started time measurement. The native SDK computes the
+     * duration and reports it as a custom-measurement span (milliseconds).
+     * Unknown names are dropped silently by the native SDK.
+     */
+    endTimeMeasure: (name: string) => void;
     reportError: (error: Error, isCrash: boolean) => void;
     /**
      * Report a network request to the underlying Coralogix SDK

package/src/model/Types.d.ts

@@ -200,6 +200,11 @@ export interface CoralogixBrowserSdkConfig {
     environment?: string;
     /** Percentage of overall sessions being tracked, defaults to 100%  */
     sessionSampleRate?: number;
+    /**
+     * Event categories that bypass session sampling. Events of these categories are
+     * emitted even when the session is sampled out. Defaults to `[]`.
+     */
+    excludeFromSampling?: ExcludableInstrumentation[];
     /** Collect IP data */
     collectIPData?: boolean;
     /** Enable event access and modification before sending to Coralogix, supporting content modification, and event discarding. */
@@ -232,6 +237,12 @@ export type HybridMetric = {
  * being linked to spans created by that tracer.
  */
 export type CoralogixIgnoredInstrument = 'networkRequests' | 'userInteractions' | 'errors';
+/**
+ * Event categories that can opt out of session sampling. When the session is
+ * sampled out, events whose category is listed in `excludeFromSampling` are still
+ * emitted; everything else is dropped. Mirrors the iOS/Android native enums.
+ */
+export type ExcludableInstrumentation = 'errors' | 'logs' | 'network' | 'userInteractions' | 'mobileVitals' | 'customSpan' | 'customMeasurement';
 /** OTLP JSON-format trace data delivered to the `tracesExporter` callback. */
 export interface TraceExporterData {
     resource_spans: Record<string, unknown>[];