@coralogix/react-native-plugin 0.2.10 → 0.3.0

package/ios/CxSdk.swift

@@ -163,11 +163,38 @@ class CxSdk: RCTEventEmitter {
       reject("Invalid networkRequestDictionary", "networkRequestDictionary is not a dictionary", nil)
       return
     }
+   
     let cxNetworkDict = toCoralogixNetwork(dictionary: dictionary)
+    print("[CX DEBUG] cxNetworkDict response_payload: \( cxNetworkDict)")
     coralogixRum?.setNetworkRequestContext(dictionary: cxNetworkDict)
     resolve("reportNetworkRequest success")
   }
 
+  @objc(reportUserInteraction:)
+  func reportUserInteraction(interaction: NSDictionary) {
+    var dictionary: [String: Any] = [:]
+
+    if let type = interaction["type"] as? String { dictionary["event_name"] = type }
+    if let targetElement = interaction["target_element"] as? String { dictionary["target_element"] = targetElement }
+    if let elementClasses = interaction["element_classes"] as? String { dictionary["element_classes"] = elementClasses }
+    if let targetId = interaction["target_id"] as? String { dictionary["element_id"] = targetId }
+    if let innerText = interaction["inner_text"] as? String { dictionary["target_element_inner_text"] = innerText }
+    if let direction = interaction["direction"] as? String { dictionary["scroll_direction"] = direction }
+    if let attributes = interaction["attributes"] as? [String: Any] {
+      if let x = attributes["x"] as? Double { dictionary["x"] = x }
+      if let y = attributes["y"] as? Double { dictionary["y"] = y }
+    }
+
+    let payload = dictionary
+    DispatchQueue.main.async { [weak self] in
+      guard let rum = self?.coralogixRum else {
+        print("[CxSdk] reportUserInteraction called before CoralogixRum is initialized, dropping interaction")
+        return
+      }
+      rum.setUserInteraction(payload)
+    }
+  }
+
   @objc(shutdown:withRejecter:)
   func shutdown(resolve:RCTPromiseResolveBlock,
                 reject:RCTPromiseRejectBlock) -> Void {
@@ -187,7 +214,7 @@ class CxSdk: RCTEventEmitter {
     let message = dictionary[Keys.errorMessage.rawValue] as? String ?? ""
     let errorType = dictionary[Keys.errorType.rawValue] as? String ?? "5"
     let isCrash = dictionary[Keys.isCrash.rawValue] as? Bool ?? false
-    
+
     coralogixRum?.reportError(message: message,
                               stackTrace: stackTrace,
                               errorType: errorType,
@@ -229,15 +256,19 @@ class CxSdk: RCTEventEmitter {
   func initializeSessionReplay(options: NSDictionary,
                                resolve:RCTPromiseResolveBlock,
                                reject:RCTPromiseRejectBlock) -> Void {
+    guard coralogixRum != nil else {
+      reject("CX_SDK_ERROR", "Coralogix RUM must be initialized before Session Replay. Call CoralogixRum.init() first and await it.", nil)
+      return
+    }
     do {
       let sessionReplayOptions = try self.toSessionReplayOptions(parameter: options)
       SessionReplay.initializeWithOptions(sessionReplayOptions:sessionReplayOptions)
+      resolve("initializeSessionReplay success")
     } catch let error as CxSdkError {
       reject("CX_SDK_ERROR", error.localizedDescription, error)
     } catch {
       reject("UNEXPECTED_ERROR", "An unexpected error occurred: \(error.localizedDescription)", error)
     }
-    resolve("initializeSessionReplay success")
   }
 
   @objc(shutdownSessionReplay:withRejecter:)
@@ -288,7 +319,7 @@ class CxSdk: RCTEventEmitter {
     }
     resolve("captureScreenshot success")
   }
-  
+
   @objc(maskViewByTag:withResolver:withRejecter:)
   func maskViewByTag(viewTag: NSNumber,
                      resolve:@escaping RCTPromiseResolveBlock,
@@ -300,7 +331,7 @@ class CxSdk: RCTEventEmitter {
       reject("MASK_VIEW_ERROR", "no ui manager found, aborting maskViewByTag", nil)
       return
     }
-    
+
     RCTExecuteOnUIManagerQueue {
       uiManager.addUIBlock { (_, viewRegistry) in
         if let view = viewRegistry?[viewTag] as? UIView {
@@ -336,6 +367,38 @@ class CxSdk: RCTEventEmitter {
     }
   }
 
+  private func toNetworkCaptureRuleList(_ rules: [[String: Any]]?) -> [NetworkCaptureRule] {
+    guard let rules = rules else { return [] }
+    let result = rules.compactMap { dict -> NetworkCaptureRule? in
+      let reqHeaders = dict["reqHeaders"] as? [String]
+      let resHeaders = dict["resHeaders"] as? [String]
+      let collectReqPayload = dict["collectReqPayload"] as? Bool ?? false
+      let collectResPayload = dict["collectResPayload"] as? Bool ?? false
+      if let source = dict["urlPattern"] as? String {
+        let flags = dict["urlPatternFlags"] as? String ?? ""
+        var options: NSRegularExpression.Options = []
+        if flags.contains("i") { options.insert(.caseInsensitive) }
+        if flags.contains("m") { options.insert(.anchorsMatchLines) }
+        guard let regex = try? NSRegularExpression(pattern: source, options: options) else {
+          return nil
+        }
+        return NetworkCaptureRule(urlPattern: regex,
+                                  reqHeaders: reqHeaders,
+                                  resHeaders: resHeaders,
+                                  collectReqPayload: collectReqPayload,
+                                  collectResPayload: collectResPayload)
+      } else if let url = dict["url"] as? String {
+        return NetworkCaptureRule(url: url,
+                                  reqHeaders: reqHeaders,
+                                  resHeaders: resHeaders,
+                                  collectReqPayload: collectReqPayload,
+                                  collectResPayload: collectResPayload)
+      }
+      return nil
+    }
+    return result
+  }
+
   private func toCoralogixNetwork(dictionary: [String: Any]) -> [String: Any] {
     var result = [String: Any]()
     result["url"] = dictionary["url"] as? String ?? ""
@@ -347,6 +410,10 @@ class CxSdk: RCTEventEmitter {
     result["schema"] = dictionary["schema"] as? String ?? ""
     result["customTraceId"] = dictionary["customTraceId"] as? String ?? ""
     result["customSpanId"] = dictionary["customSpanId"] as? String ?? ""
+    if let v = dictionary["request_headers"]  as? [String: String] { result["request_headers"]  = v }
+    if let v = dictionary["response_headers"] as? [String: String] { result["response_headers"] = v }
+    if let v = dictionary["request_payload"]  as? String           { result["request_payload"]  = v }
+    if let v = dictionary["response_payload"] as? String           { result["response_payload"] = v }
     return result
   }
 
@@ -391,7 +458,11 @@ class CxSdk: RCTEventEmitter {
                                     userMetadata: userMetadata)
     let ignoreUrls = (parameter["ignoreUrls"] as? [Any])?.compactMap { $0 as? String } ?? []
     let ignoreError = (parameter["ignoreErrors"] as? [Any])?.compactMap { $0 as? String } ?? []
-    let options = CoralogixExporterOptions(coralogixDomain: coralogixDomain,
+    let rawNetworkExtraConfig = parameter["networkExtraConfig"] as? [[String: Any]]
+    let networkExtraConfig = toNetworkCaptureRuleList(rawNetworkExtraConfig)
+
+    let options = CoralogixExporterOptions(
+      coralogixDomain: coralogixDomain,
                                            userContext: coralogixUser,
                                            environment: parameter["environment"] as? String ?? "",
                                            application: application,
@@ -400,12 +471,12 @@ class CxSdk: RCTEventEmitter {
                                            ignoreUrls: ignoreUrls,
                                            ignoreErrors: ignoreError,
                                            labels: labels,
-                                           fpsSampleRate: parameter["fpsSamplingSeconds"] as? TimeInterval ?? 300,
                                            instrumentations: instrumentationDict,
                                            collectIPData: parameter["collectIPData"] as? Bool ?? true,
                                           proxyUrl: parameter["proxyUrl"] as? String ?? nil,
                                           traceParentInHeader: mapTraceParentInHeader(parameter["traceParentInHeader"] as? [String: Any]),
                                            mobileVitals: mobileVitalsDict,
+                                           networkExtraConfig: networkExtraConfig,
                                            debug: parameter["debug"] as? Bool ?? true)
 
     return options
@@ -449,9 +520,9 @@ class CxSdk: RCTEventEmitter {
 
   private func mapTraceParentInHeader(_ rnConfig: [String: Any]?) -> [String: Any]? {
     guard let rnConfig = rnConfig else { return nil }
-    
+
     var nativeConfig: [String: Any] = [:]
-    
+
     // Copy all keys, but rename "enabled" to "enable"
     for (key, value) in rnConfig {
       if key == "enabled" {
@@ -460,7 +531,7 @@ class CxSdk: RCTEventEmitter {
         nativeConfig[key] = value
       }
     }
-    
+
     return nativeConfig.isEmpty ? nil : nativeConfig
   }
 

package/package.json

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

package/src/index.d.ts

@@ -1,7 +1,7 @@
 import type { UserContextConfig } from './model/UserContextConfig';
 import type { ApplicationContextConfig } from './model/ApplicationContextConfig';
 import type { CoralogixOtelWebType } from './model/CoralogixOtelWebType';
-import type { CoralogixBrowserSdkConfig, CoralogixStackFrame, CxSpan, HybridMetric } from './model/Types';
+import type { CoralogixBrowserSdkConfig, CoralogixStackFrame, CxSpan, HybridMetric, InteractionContext } from './model/Types';
 import { CoralogixLogSeverity } from './model/Types';
 import type { NetworkRequestDetails } from './model/NetworkRequestDetails';
 import type { CustomMeasurement } from './model/CustomMeasurement';
@@ -36,6 +36,7 @@ interface CxSdkClient {
     stopSessionRecording(): void;
     captureScreenshot(): void;
     maskViewByTag(viewTag: number): void;
+    reportUserInteraction(interaction: InteractionContext): void;
 }
 export declare const CxSdk: CxSdkClient;
 export declare const CoralogixRum: CoralogixOtelWebType;
@@ -45,7 +46,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, CoralogixLogSeverity, } from './model/Types';
+export { type CoralogixBrowserSdkConfig, type NetworkCaptureRule, CoralogixLogSeverity, } from './model/Types';
 export { type CoralogixOtelWebOptionsInstrumentations } from './model/CoralogixOtelWebOptionsInstrumentations';
 export { type CustomMeasurement } from './model/CustomMeasurement';
 export { type NetworkRequestDetails } from './model/NetworkRequestDetails';

package/src/instrumentations/network/networkCaptureUtils.d.ts

@@ -0,0 +1,22 @@
+import { NetworkCaptureRule } from '../../model/Types';
+/**
+ * Returns the first rule whose `urlPattern` regex or exact `url` matches the
+ * given URL. Returns undefined if no rule matches or the list is empty.
+ */
+export declare function resolveNetworkCaptureRule(url: string, rules: NetworkCaptureRule[]): NetworkCaptureRule | undefined;
+/**
+ * Filters a headers map to only the keys present in `allowlist`.
+ * Matching is case-insensitive; output keys use the casing from `allowlist`.
+ */
+export declare function filterHeaders(headers: Record<string, string>, allowlist: string[]): Record<string, string>;
+/**
+ * Returns `body` if it is within `maxChars`, otherwise returns `undefined`.
+ * Bodies over the limit are dropped entirely — never truncated.
+ */
+export declare function applyPayloadLimit(body: string, maxChars?: number): string | undefined;
+/**
+ * Converts NetworkCaptureRule[] to a form that can cross the JS→native bridge.
+ * RegExp cannot be serialized directly, so `urlPattern` is split into its
+ * `source` and `flags` strings; the native side reconstructs the regex.
+ */
+export declare function serializeNetworkCaptureRules(rules: NetworkCaptureRule[]): any[];

package/src/instrumentations/user-interaction/UserInteractionInstrumentation.d.ts

@@ -0,0 +1,10 @@
+import { InstrumentationBase } from '@opentelemetry/instrumentation';
+import type { InteractionContext } from '../../model/Types';
+export declare class UserInteractionInstrumentation extends InstrumentationBase {
+    constructor(config: {
+        onInteraction: (ctx: InteractionContext) => void;
+    });
+    init(): void;
+    enable(): void;
+    disable(): void;
+}

package/src/instrumentations/user-interaction/consts.d.ts

@@ -0,0 +1,4 @@
+export declare const USER_INTERACTION_INSTRUMENTATION_NAME = "user-interaction";
+export declare const USER_INTERACTION_INSTRUMENTATION_VERSION = "1";
+export declare const SWIPE_MOMENTUM_TIMEOUT_MS = 80;
+export declare const SWIPE_VELOCITY_THRESHOLD = 0.5;

package/src/instrumentations/user-interaction/gestureUtils.d.ts

@@ -0,0 +1,3 @@
+export type Direction = 'up' | 'down' | 'left' | 'right';
+export declare function inferDirectionFromDelta(dx: number, dy: number): Direction;
+export declare function extractInnerText(children: any): string | undefined;

package/src/instrumentations/user-interaction/index.d.ts

@@ -0,0 +1 @@
+export { UserInteractionInstrumentation } from './UserInteractionInstrumentation';

package/src/model/CoralogixOtelWebType.d.ts

@@ -9,8 +9,9 @@ import { NetworkRequestDetails } from './NetworkRequestDetails';
 export interface CoralogixOtelWebType extends SendLog {
     /**
      * Init CoralogixRum.
+     * Returns a Promise that resolves when initialization is complete.
      */
-    init: (options: CoralogixBrowserSdkConfig) => void;
+    init: (options: CoralogixBrowserSdkConfig) => Promise<void>;
     /**
      * Turn CoralogixRum off.
      */

package/src/model/NetworkRequestDetails.d.ts

@@ -11,4 +11,8 @@ export type NetworkRequestDetails = {
     errorMessage?: string | null;
     customTraceId: string;
     customSpanId: string;
+    request_headers?: Record<string, string>;
+    response_headers?: Record<string, string>;
+    request_payload?: string;
+    response_payload?: string;
 };

package/src/model/Types.d.ts

@@ -133,10 +133,24 @@ export interface CxRumEvent {
     timestamp: number;
     isSnapshotEvent?: boolean;
 }
-export interface EditableCxRumEvent extends Omit<CxRumEvent, 'session_context' | 'timestamp'> {
+export interface EditableCxRumEvent extends Omit<CxRumEvent, 'session_context' | 'timestamp' | 'snapshot_context'> {
     session_context: Pick<SessionContext, keyof UserMetadata>;
 }
 export type BeforeSendResult = EditableCxRumEvent | null;
+export interface NetworkCaptureRule {
+    /** Exact-string URL match. One of `url` or `urlPattern` is required. */
+    url?: string;
+    /** Regex URL match. One of `url` or `urlPattern` is required. */
+    urlPattern?: RegExp;
+    /** Allowlisted request header names to capture (case-insensitive). */
+    reqHeaders?: string[];
+    /** Allowlisted response header names to capture (case-insensitive). */
+    resHeaders?: string[];
+    /** Capture request body (string bodies only, ≤1024 chars). Default: false. */
+    collectReqPayload?: boolean;
+    /** Capture response body (best-effort, ≤1024 chars). Default: false. */
+    collectResPayload?: boolean;
+}
 export interface TraceParentInHeader {
     enabled: boolean;
     options?: {
@@ -192,6 +206,8 @@ export interface CoralogixBrowserSdkConfig {
     beforeSend?: (event: EditableCxRumEvent) => BeforeSendResult;
     /** Send requests through a proxy */
     proxyUrl?: string;
+    /** Rules for capturing request/response headers and payloads per URL. */
+    networkExtraConfig?: NetworkCaptureRule[];
     /**
      * JS refresh rate metric collection configuration.
      */
@@ -208,4 +224,17 @@ export type HybridMetric = {
     value: number;
     units: string;
 };
+export interface InteractionContext {
+    type: 'click' | 'scroll' | 'swipe';
+    /** Required. Element identifier: accessibilityLabel ?? componentName for clicks; 'ScrollView' for scroll/swipe. */
+    target_element: string;
+    direction?: 'up' | 'down' | 'left' | 'right';
+    element_classes?: string;
+    target_id?: string;
+    inner_text?: string;
+    attributes?: {
+        x?: number;
+        y?: number;
+    };
+}
 export {};