@coralogix/react-native-plugin 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+## 0.1.8 (2025-11-04)
+
+### 🩹 Fixes
+
+- the log can now get any type for the data and labels map parameters
+
+## 0.1.7 (2025-11-02)
+
+### 🚀 Features
+
+- added automatic navigation detection using the @react-navigation/native package
+
+### Patch
+- Bump android native version to 2.5.6
+
 ## 0.1.6 (2025-10-26)
 ### Patch
 - Bump android native version to 2.5.51

package/README.md

@@ -67,6 +67,31 @@ CoralogixRum.log(CoralogixLogSeverity.Error, 'this is a log', { key: 'value' });
 CoralogixRum.error('this is a log with error severity', { key: 'value' });
 ```
 
+### Custom Logs
+
+Send structured logs with optional data and labels.
+```javascript
+CoralogixRum.log(CoralogixLogSeverity.Error, 'this is a log', { key: 'value' });
+```
+
+Shorthand signatures exists for all log severities:
+```javascript
+CoralogixRum.debug('this is a debug log', {key: 'value', pi: 3.14});
+CoralogixRum.error('this is an error log', {error: 'yes', is_bad: 'no'});
+```
+
+> **Note:** Due to ReactNative limitations, not all value types are supported for the log data values,
+> our testing shows that ReactNative can't pass some types to the coralogix native layer, types we have identified as problematic are `Map`, `Set`, `Date` and `Function`
+> please note that there could be more, so for example:
+> ```javascript
+> // this would pass as an empty object to the coralogix native layer, same for Set and Date:
+> CoralogixRum.debug('this will be a problem', {key: new Map().set(1, 2)});
+> 
+> // this would pass as null to the coralogix native layer
+> CoralogixRum.debug('this will be a problem too', {key: () => {}});
+> ```
+> in the event that you need to use any of these types please stringify them before you pass it to the `log` method
+
 ### View Tracking
 
 To track views, set the view context whenever a view changes.
@@ -78,15 +103,16 @@ CoralogixRum.setViewContext({
 ```
 
 You can automatically track view changes by using [react-navigation](https://reactnavigation.org/docs/navigation-container/#onstatechange).
+Wrap your navigation ref with our `attachReactNavigationObserver` hook like so:
 
 ```javascript
+const navigationRef = createNavigationContainerRef();
+const navHooks = attachReactNavigationObserver(navigationRef);
+
 <NavigationContainer
   ref={navigationRef}
-  onStateChange={() => {
-    const currentRouteName = navigationRef.current.getCurrentRoute().name;
-
-    CoralogixRum.setViewContext({ view: currentRouteName });
-  }}
+  onReady={navHooks.onReady}
+  onStateChange={navHooks.onStateChange}
 >
   >{/* ... */}
 </NavigationContainer>

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.51"
+  implementation "com.coralogix:android-sdk:2.5.6"
 }
 
 react {

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

@@ -29,6 +29,8 @@ import com.facebook.react.bridge.ReadableType
 import com.facebook.react.bridge.WritableArray
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.modules.core.DeviceEventManagerModule
+import org.json.JSONArray
+import org.json.JSONObject
 import java.lang.Long.getLong
 
 class CxSdkModule(reactContext: ReactApplicationContext) :
@@ -425,13 +427,65 @@ class CxSdkModule(reactContext: ReactApplicationContext) :
   }
 
   private fun ReadableMap.toStringMap(): Map<String, String> {
-    val map = mutableMapOf<String, String>()
+    val result = mutableMapOf<String, String>()
     val iterator = keySetIterator()
     while (iterator.hasNextKey()) {
       val key = iterator.nextKey()
-      getString(key)?.let { map[key] = it }
+      val jsonValue = when (getType(key)) {
+        ReadableType.Null -> JSONObject.NULL
+        ReadableType.Boolean -> getBoolean(key)
+        ReadableType.Number -> getDouble(key)
+        ReadableType.String -> getString(key)
+        ReadableType.Map -> getMap(key)?.toJsonObject()
+        ReadableType.Array -> getArray(key)?.toJsonArray()
+        else -> JSONObject.NULL
+      }
+
+      // Always serialize as JSON string
+      result[key] = when (jsonValue) {
+        is JSONObject, is JSONArray -> jsonValue.toString()
+        JSONObject.NULL -> "null"
+        else -> JSONObject.wrap(jsonValue)?.toString() ?: "null"
+      }
     }
-    return map
+
+    return result
+  }
+
+  private fun ReadableMap.toJsonObject(): JSONObject {
+    val obj = JSONObject()
+    val iterator = keySetIterator()
+    while (iterator.hasNextKey()) {
+      val key = iterator.nextKey()
+      val value = when (getType(key)) {
+        ReadableType.Null -> JSONObject.NULL
+        ReadableType.Boolean -> getBoolean(key)
+        ReadableType.Number -> getDouble(key)
+        ReadableType.String -> getString(key)
+        ReadableType.Map -> getMap(key)?.toJsonObject()
+        ReadableType.Array -> getArray(key)?.toJsonArray()
+        else -> JSONObject.NULL
+      }
+      obj.put(key, value)
+    }
+    return obj
+  }
+
+  private fun ReadableArray.toJsonArray(): JSONArray {
+    val arr = JSONArray()
+    for (i in 0 until size()) {
+      val value = when (getType(i)) {
+        ReadableType.Null -> JSONObject.NULL
+        ReadableType.Boolean -> getBoolean(i)
+        ReadableType.Number -> getDouble(i)
+        ReadableType.String -> getString(i)
+        ReadableType.Map -> getMap(i)?.toJsonObject()
+        ReadableType.Array -> getArray(i)?.toJsonArray()
+        else -> JSONObject.NULL
+      }
+      arr.put(value)
+    }
+    return arr
   }
 
   private fun Map<String, String>.toWritableMap(): WritableMap {

package/index.cjs.js

@@ -219,7 +219,7 @@ function stopJsRefreshRateSampler() {
   appStateSub = null;
 }
 
-var version = "0.1.6";
+var version = "0.1.8";
 var pkg = {
 	version: version};
 
@@ -373,6 +373,34 @@ class CoralogixFetchInstrumentation extends instrumentationFetch.FetchInstrument
   }
 }
 
+let lastRouteName;
+function getLastNavigationRouteDetected() {
+  return lastRouteName;
+}
+function attachReactNavigationObserver(ref) {
+  const report = () => {
+    const route = ref.getCurrentRoute();
+    if (!route) return;
+    const name = route.name;
+    if (name !== lastRouteName) {
+      if (CoralogixRum.isInited) {
+        CoralogixRum.setViewContext({
+          view: name
+        });
+      }
+      lastRouteName = name;
+    }
+  };
+  const onReady = () => {
+    // Wait a tick to ensure the route is initialized
+    setTimeout(report, 0);
+  };
+  return {
+    onReady,
+    onStateChange: report
+  };
+}
+
 let CoralogixDomain = /*#__PURE__*/function (CoralogixDomain) {
   CoralogixDomain["EU1"] = "EU1";
   CoralogixDomain["EU2"] = "EU2";
@@ -418,7 +446,18 @@ const CoralogixRum = {
       return;
     }
     await registerCoralogixInstrumentations(resolvedOptions);
-    await CxSdk.initialize(_extends({}, resolvedOptions, {
+    let finalOptions;
+    const lastNavRoute = getLastNavigationRouteDetected();
+    if (lastNavRoute) {
+      finalOptions = _extends({}, resolvedOptions, {
+        view_context: {
+          view: lastNavRoute
+        }
+      });
+    } else {
+      finalOptions = resolvedOptions;
+    }
+    await CxSdk.initialize(_extends({}, finalOptions, {
       frameworkVersion: pkg.version
     }));
     isInited = true;
@@ -690,3 +729,4 @@ const subscription = eventEmitter.addListener('onBeforeSend', events => {
 exports.CoralogixDomain = CoralogixDomain;
 exports.CoralogixLogSeverity = CoralogixLogSeverity;
 exports.CoralogixRum = CoralogixRum;
+exports.attachReactNavigationObserver = attachReactNavigationObserver;

package/index.esm.js

@@ -217,7 +217,7 @@ function stopJsRefreshRateSampler() {
   appStateSub = null;
 }
 
-var version = "0.1.6";
+var version = "0.1.8";
 var pkg = {
 	version: version};
 
@@ -371,6 +371,34 @@ class CoralogixFetchInstrumentation extends FetchInstrumentation {
   }
 }
 
+let lastRouteName;
+function getLastNavigationRouteDetected() {
+  return lastRouteName;
+}
+function attachReactNavigationObserver(ref) {
+  const report = () => {
+    const route = ref.getCurrentRoute();
+    if (!route) return;
+    const name = route.name;
+    if (name !== lastRouteName) {
+      if (CoralogixRum.isInited) {
+        CoralogixRum.setViewContext({
+          view: name
+        });
+      }
+      lastRouteName = name;
+    }
+  };
+  const onReady = () => {
+    // Wait a tick to ensure the route is initialized
+    setTimeout(report, 0);
+  };
+  return {
+    onReady,
+    onStateChange: report
+  };
+}
+
 let CoralogixDomain = /*#__PURE__*/function (CoralogixDomain) {
   CoralogixDomain["EU1"] = "EU1";
   CoralogixDomain["EU2"] = "EU2";
@@ -416,7 +444,18 @@ const CoralogixRum = {
       return;
     }
     await registerCoralogixInstrumentations(resolvedOptions);
-    await CxSdk.initialize(_extends({}, resolvedOptions, {
+    let finalOptions;
+    const lastNavRoute = getLastNavigationRouteDetected();
+    if (lastNavRoute) {
+      finalOptions = _extends({}, resolvedOptions, {
+        view_context: {
+          view: lastNavRoute
+        }
+      });
+    } else {
+      finalOptions = resolvedOptions;
+    }
+    await CxSdk.initialize(_extends({}, finalOptions, {
       frameworkVersion: pkg.version
     }));
     isInited = true;
@@ -685,4 +724,4 @@ const subscription = eventEmitter.addListener('onBeforeSend', events => {
   }
 });
 
-export { CoralogixDomain, CoralogixLogSeverity, CoralogixRum };
+export { CoralogixDomain, CoralogixLogSeverity, CoralogixRum, attachReactNavigationObserver };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coralogix/react-native-plugin",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Official Coralogix React Native plugin",
   "license": "Apache-2.0",
   "author": "Coralogix",
@@ -25,8 +25,8 @@
   },
   "main": "./index.cjs.js",
   "dependencies": {
-    "@opentelemetry/instrumentation-fetch": "0.203.0",
     "@opentelemetry/instrumentation": "0.48.0",
+    "@opentelemetry/instrumentation-fetch": "0.203.0",
     "@opentelemetry/sdk-trace-web": "1.30.1"
   },
   "module": "./index.esm.js",

package/src/index.d.ts

@@ -9,3 +9,4 @@ export { type CoralogixOtelWebOptionsInstrumentations } from './model/CoralogixO
 export { type CustomMeasurement } from './model/CustomMeasurement';
 export { type NetworkRequestDetails } from './model/NetworkRequestDetails';
 export { type CoralogixMobileVitals } from './model/CoralogixMobileVitals';
+export { attachReactNavigationObserver } from './instrumentations/navigation/NavigationInstrumentation';

package/src/instrumentations/navigation/NavigationInstrumentation.d.ts

@@ -0,0 +1,8 @@
+export declare function getLastNavigationRouteDetected(): string | undefined;
+export type CurrentRouteProvider = {
+    getCurrentRoute: any;
+};
+export declare function attachReactNavigationObserver(ref: CurrentRouteProvider): {
+    onReady: () => void;
+    onStateChange: () => void;
+};