@coralogix/react-native-plugin 0.2.11 → 0.3.0

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## 0.3.0 (2026-03-10)
+
+### 🚀 Features
+
+- Add network payload and header capture support ([CX-32504](https://coralogix.atlassian.net/browse/CX-32504)): configure `networkExtraConfig` rules to capture request/response headers and payloads per URL pattern
+- Add `NetworkCaptureRule` type to public API for typed configuration
+- Android: pass `networkExtraConfig` rules through native bridge to Android SDK
+- JS: async fetch instrumentation with response payload capture via `Response.clone()`
+- Android version bumped to 2.9.3
+- iOS version bumped to 2.3.0
+
+### 🩹 Fixes
+
+- add explicit types to Headers.forEach callback
+- use Headers.forEach() instead of entries() for es2022 lib compat
+- cast serializeNetworkCaptureRules return type to any[] for native bridge
+- update CoralogixRum.init return type to Promise<void>
+
 ## 0.2.11 (2026-03-10)
 
 ### 🚀 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.2.0'
-  s.dependency 'CoralogixInternal','2.2.0'
-  s.dependency 'SessionReplay','2.2.0'
+  s.dependency 'Coralogix','2.3.0'
+  s.dependency 'CoralogixInternal','2.3.0'
+  s.dependency 'SessionReplay','2.3.0'
 
   # 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/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.9.0"
+  implementation "com.coralogix:android-sdk:2.9.3"
 }
 
 react {

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

@@ -17,6 +17,7 @@ import com.coralogix.android.sdk.model.HybridMetric
 import com.coralogix.android.sdk.model.UserInteractionDetails
 import com.coralogix.android.sdk.model.Instrumentation
 import com.coralogix.android.sdk.model.MobileVitalType
+import com.coralogix.android.sdk.model.NetworkCaptureRule
 import com.coralogix.android.sdk.model.TraceParentInHeaderConfig
 import com.coralogix.android.sdk.model.TraceParentInHeaderConfigOptions
 import com.coralogix.android.sdk.model.UserContext
@@ -349,6 +350,10 @@ class CxSdkModule(reactContext: ReactApplicationContext) :
 
     val collectIpData = if (hasKey("collectIPData")) getBoolean("collectIPData") else true
 
+    val networkExtraConfig = if (hasKey("networkExtraConfig") && !isNull("networkExtraConfig"))
+      getArray("networkExtraConfig")?.toNetworkCaptureRuleList() ?: emptyList()
+    else emptyList()
+
     return CoralogixOptions(
       applicationName = applicationName,
       coralogixDomain = coralogixDomain,
@@ -367,7 +372,8 @@ class CxSdkModule(reactContext: ReactApplicationContext) :
       debug = if (hasKey("debug")) getBoolean("debug") else false,
       proxyUrl = getString("proxyUrl"),
       beforeSendCallback = ::beforeSendCallback,
-      collectIPData = collectIpData
+      collectIPData = collectIpData,
+      networkCaptureConfig = networkExtraConfig
     )
   }
 
@@ -713,9 +719,45 @@ class CxSdkModule(reactContext: ReactApplicationContext) :
       getDouble("responseContentLength").toLong() else 0,
     errorMessage = getString("errorMessage"),
     traceId = getString("customTraceId"),
-    spanId = getString("customSpanId")
+    spanId = getString("customSpanId"),
+    requestHeaders = if (hasKey("request_headers") && !isNull("request_headers"))
+      getMap("request_headers")?.toStringMap() else null,
+    responseHeaders = if (hasKey("response_headers") && !isNull("response_headers"))
+      getMap("response_headers")?.toStringMap() else null,
+    requestPayload = if (hasKey("request_payload") && !isNull("request_payload"))
+      getString("request_payload") else null,
+    responsePayload = if (hasKey("response_payload") && !isNull("response_payload"))
+      getString("response_payload") else null
   ).also { Log.d("CxSdkModule", "toNetworkRequestDetails: $it") }
 
+  private fun ReadableArray.toNetworkCaptureRuleList(): List<NetworkCaptureRule> {
+    val result = mutableListOf<NetworkCaptureRule>()
+    for (i in 0 until size()) {
+      val map = getMap(i) ?: continue
+      result.add(NetworkCaptureRule(
+        url = if (map.hasKey("url") && !map.isNull("url")) map.getString("url") else null,
+        urlPattern = if (map.hasKey("urlPattern") && !map.isNull("urlPattern")) {
+          val source = map.getString("urlPattern") ?: ""
+          val flags = if (map.hasKey("urlPatternFlags") && !map.isNull("urlPatternFlags"))
+            map.getString("urlPatternFlags") ?: "" else ""
+          val options = mutableSetOf<RegexOption>()
+          if (flags.contains('i')) options.add(RegexOption.IGNORE_CASE)
+          if (flags.contains('m')) options.add(RegexOption.MULTILINE)
+          source.toRegex(options)
+        } else null,
+        reqHeaders = if (map.hasKey("reqHeaders") && !map.isNull("reqHeaders"))
+          map.getArray("reqHeaders")?.toStringList() ?: emptyList()
+        else emptyList(),
+        resHeaders = if (map.hasKey("resHeaders") && !map.isNull("resHeaders"))
+          map.getArray("resHeaders")?.toStringList() ?: emptyList()
+        else emptyList(),
+        collectReqPayload = if (map.hasKey("collectReqPayload")) map.getBoolean("collectReqPayload") else false,
+        collectResPayload = if (map.hasKey("collectResPayload")) map.getBoolean("collectResPayload") else false,
+      ))
+    }
+    return result
+  }
+
   private fun ReadableArray.toHybridMetricList(): List<HybridMetric> {
     val out = ArrayList<HybridMetric>(size())
     for (i in 0 until size()) {

package/index.cjs.js

@@ -523,7 +523,7 @@ function stopJsRefreshRateSampler() {
   appStateSub = null;
 }
 
-var version = "0.2.11";
+var version = "0.3.0";
 var pkg = {
 	version: version};
 
@@ -622,6 +622,52 @@ let OtelNetworkAttrs = /*#__PURE__*/function (OtelNetworkAttrs) {
   return OtelNetworkAttrs;
 }({});
 
+/**
+ * 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.
+ */
+function resolveNetworkCaptureRule(url, rules) {
+  return rules.find(rule => rule.urlPattern ? rule.urlPattern.test(url) : rule.url === url);
+}
+
+/**
+ * Filters a headers map to only the keys present in `allowlist`.
+ * Matching is case-insensitive; output keys use the casing from `allowlist`.
+ */
+function filterHeaders(headers, allowlist) {
+  const result = {};
+  for (const [key, value] of Object.entries(headers)) {
+    const configKey = allowlist.find(k => k.toLowerCase() === key.toLowerCase());
+    if (configKey !== undefined) result[configKey] = value;
+  }
+  return result;
+}
+
+/**
+ * Returns `body` if it is within `maxChars`, otherwise returns `undefined`.
+ * Bodies over the limit are dropped entirely — never truncated.
+ */
+function applyPayloadLimit(body, maxChars = 1024) {
+  return body.length <= maxChars ? body : 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.
+ */
+function serializeNetworkCaptureRules(rules) {
+  return rules.map(rule => {
+    var _rule$urlPattern, _rule$urlPattern2;
+    return _extends({}, rule, {
+      urlPattern: (_rule$urlPattern = rule.urlPattern) == null ? void 0 : _rule$urlPattern.source,
+      // Strip 'g' and 'y' flags — stateful flags cause RegExp.lastIndex side-effects
+      // when the native side calls .test() repeatedly on a shared instance.
+      urlPatternFlags: (_rule$urlPattern2 = rule.urlPattern) == null ? void 0 : _rule$urlPattern2.flags.replace(/[gy]/g, '')
+    });
+  });
+}
+
 class CoralogixFetchInstrumentation extends instrumentationFetch.FetchInstrumentation {
   constructor(config) {
     var _traceParentInHeader$;
@@ -635,7 +681,9 @@ class CoralogixFetchInstrumentation extends instrumentationFetch.FetchInstrument
       // If enabled and user didn't provide urls -> match all
       propagateTraceHeaderCorsUrls: enabled ? urls != null ? urls : /.*/ : allowNone()
     };
-    fetchConfig.applyCustomAttributesOnSpan = (span, request, result) => {
+    fetchConfig.applyCustomAttributesOnSpan = async function (span, request, result) {
+      // span.end() must remain synchronous and first — this completes the OTel span
+      // regardless of any async work that follows for capture enrichment.
       span.end();
       const readableSpan = span;
       const attrs = readableSpan.attributes;
@@ -667,6 +715,66 @@ class CoralogixFetchInstrumentation extends instrumentationFetch.FetchInstrument
         customTraceId,
         customSpanId
       };
+      const networkExtraConfig = config.networkExtraConfig;
+      if (networkExtraConfig != null && networkExtraConfig.length) {
+        const rule = resolveNetworkCaptureRule(url, networkExtraConfig);
+        if (rule) {
+          var _rule$reqHeaders, _rule$resHeaders;
+          // Request headers
+          if ((_rule$reqHeaders = rule.reqHeaders) != null && _rule$reqHeaders.length) {
+            let rawHeaders;
+            if (request instanceof Request) {
+              rawHeaders = headersToRecord(request.headers);
+            } else {
+              const h = request.headers;
+              if (h instanceof Headers) {
+                rawHeaders = headersToRecord(h);
+              } else if (Array.isArray(h)) {
+                rawHeaders = Object.fromEntries(h);
+              } else {
+                var _ref;
+                rawHeaders = (_ref = h) != null ? _ref : {};
+              }
+            }
+            const filtered = filterHeaders(rawHeaders, rule.reqHeaders);
+            if (Object.keys(filtered).length > 0) details.request_headers = filtered;
+          }
+
+          // Response headers
+          if ((_rule$resHeaders = rule.resHeaders) != null && _rule$resHeaders.length && result instanceof Response) {
+            const filtered = filterHeaders(headersToRecord(result.headers), rule.resHeaders);
+            if (Object.keys(filtered).length > 0) details.response_headers = filtered;
+          }
+
+          // Request payload — string bodies only (FormData/Blob/ReadableStream skipped)
+          if (rule.collectReqPayload) {
+            let reqBody;
+            if (request instanceof Request) {
+              try {
+                reqBody = await request.clone().text();
+              } catch (_unused) {/* consumed or unavailable */}
+            } else {
+              const body = request == null ? void 0 : request.body;
+              if (typeof body === 'string') reqBody = body;
+            }
+            if (reqBody !== undefined) {
+              const limited = applyPayloadLimit(reqBody);
+              if (limited !== undefined) details.request_payload = limited;
+            }
+          }
+
+          // Response payload — clone before body is consumed by app code (best-effort)
+          if (rule.collectResPayload && result instanceof Response && !result.bodyUsed) {
+            try {
+              const text = await result.clone().text();
+              const limited = applyPayloadLimit(text);
+              if (limited !== undefined) details.response_payload = limited;
+            } catch (_unused2) {/* consumed or unavailable */}
+          }
+        }
+      }
+
+      // reportNetworkRequest must always be last, after all awaits
       CoralogixRum.reportNetworkRequest(details);
     };
     super(fetchConfig);
@@ -679,6 +787,13 @@ function allowNone() {
   // matches nothing
   return /^$/;
 }
+function headersToRecord(headers) {
+  const result = {};
+  headers.forEach((value, key) => {
+    result[key] = value;
+  });
+  return result;
+}
 
 function isSessionReplayOptionsValid(options) {
   const scaleValid = options.captureScale > 0 && options.captureScale <= 1;
@@ -772,7 +887,8 @@ const CoralogixRum = {
       finalOptions = resolvedOptions;
     }
     await CxSdk.initialize(_extends({}, finalOptions, {
-      frameworkVersion: pkg.version
+      frameworkVersion: pkg.version,
+      networkExtraConfig: finalOptions.networkExtraConfig ? serializeNetworkCaptureRules(finalOptions.networkExtraConfig) : undefined
     }));
     isInited = true;
   },

package/index.esm.js

@@ -521,7 +521,7 @@ function stopJsRefreshRateSampler() {
   appStateSub = null;
 }
 
-var version = "0.2.11";
+var version = "0.3.0";
 var pkg = {
 	version: version};
 
@@ -620,6 +620,52 @@ let OtelNetworkAttrs = /*#__PURE__*/function (OtelNetworkAttrs) {
   return OtelNetworkAttrs;
 }({});
 
+/**
+ * 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.
+ */
+function resolveNetworkCaptureRule(url, rules) {
+  return rules.find(rule => rule.urlPattern ? rule.urlPattern.test(url) : rule.url === url);
+}
+
+/**
+ * Filters a headers map to only the keys present in `allowlist`.
+ * Matching is case-insensitive; output keys use the casing from `allowlist`.
+ */
+function filterHeaders(headers, allowlist) {
+  const result = {};
+  for (const [key, value] of Object.entries(headers)) {
+    const configKey = allowlist.find(k => k.toLowerCase() === key.toLowerCase());
+    if (configKey !== undefined) result[configKey] = value;
+  }
+  return result;
+}
+
+/**
+ * Returns `body` if it is within `maxChars`, otherwise returns `undefined`.
+ * Bodies over the limit are dropped entirely — never truncated.
+ */
+function applyPayloadLimit(body, maxChars = 1024) {
+  return body.length <= maxChars ? body : 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.
+ */
+function serializeNetworkCaptureRules(rules) {
+  return rules.map(rule => {
+    var _rule$urlPattern, _rule$urlPattern2;
+    return _extends({}, rule, {
+      urlPattern: (_rule$urlPattern = rule.urlPattern) == null ? void 0 : _rule$urlPattern.source,
+      // Strip 'g' and 'y' flags — stateful flags cause RegExp.lastIndex side-effects
+      // when the native side calls .test() repeatedly on a shared instance.
+      urlPatternFlags: (_rule$urlPattern2 = rule.urlPattern) == null ? void 0 : _rule$urlPattern2.flags.replace(/[gy]/g, '')
+    });
+  });
+}
+
 class CoralogixFetchInstrumentation extends FetchInstrumentation {
   constructor(config) {
     var _traceParentInHeader$;
@@ -633,7 +679,9 @@ class CoralogixFetchInstrumentation extends FetchInstrumentation {
       // If enabled and user didn't provide urls -> match all
       propagateTraceHeaderCorsUrls: enabled ? urls != null ? urls : /.*/ : allowNone()
     };
-    fetchConfig.applyCustomAttributesOnSpan = (span, request, result) => {
+    fetchConfig.applyCustomAttributesOnSpan = async function (span, request, result) {
+      // span.end() must remain synchronous and first — this completes the OTel span
+      // regardless of any async work that follows for capture enrichment.
       span.end();
       const readableSpan = span;
       const attrs = readableSpan.attributes;
@@ -665,6 +713,66 @@ class CoralogixFetchInstrumentation extends FetchInstrumentation {
         customTraceId,
         customSpanId
       };
+      const networkExtraConfig = config.networkExtraConfig;
+      if (networkExtraConfig != null && networkExtraConfig.length) {
+        const rule = resolveNetworkCaptureRule(url, networkExtraConfig);
+        if (rule) {
+          var _rule$reqHeaders, _rule$resHeaders;
+          // Request headers
+          if ((_rule$reqHeaders = rule.reqHeaders) != null && _rule$reqHeaders.length) {
+            let rawHeaders;
+            if (request instanceof Request) {
+              rawHeaders = headersToRecord(request.headers);
+            } else {
+              const h = request.headers;
+              if (h instanceof Headers) {
+                rawHeaders = headersToRecord(h);
+              } else if (Array.isArray(h)) {
+                rawHeaders = Object.fromEntries(h);
+              } else {
+                var _ref;
+                rawHeaders = (_ref = h) != null ? _ref : {};
+              }
+            }
+            const filtered = filterHeaders(rawHeaders, rule.reqHeaders);
+            if (Object.keys(filtered).length > 0) details.request_headers = filtered;
+          }
+
+          // Response headers
+          if ((_rule$resHeaders = rule.resHeaders) != null && _rule$resHeaders.length && result instanceof Response) {
+            const filtered = filterHeaders(headersToRecord(result.headers), rule.resHeaders);
+            if (Object.keys(filtered).length > 0) details.response_headers = filtered;
+          }
+
+          // Request payload — string bodies only (FormData/Blob/ReadableStream skipped)
+          if (rule.collectReqPayload) {
+            let reqBody;
+            if (request instanceof Request) {
+              try {
+                reqBody = await request.clone().text();
+              } catch (_unused) {/* consumed or unavailable */}
+            } else {
+              const body = request == null ? void 0 : request.body;
+              if (typeof body === 'string') reqBody = body;
+            }
+            if (reqBody !== undefined) {
+              const limited = applyPayloadLimit(reqBody);
+              if (limited !== undefined) details.request_payload = limited;
+            }
+          }
+
+          // Response payload — clone before body is consumed by app code (best-effort)
+          if (rule.collectResPayload && result instanceof Response && !result.bodyUsed) {
+            try {
+              const text = await result.clone().text();
+              const limited = applyPayloadLimit(text);
+              if (limited !== undefined) details.response_payload = limited;
+            } catch (_unused2) {/* consumed or unavailable */}
+          }
+        }
+      }
+
+      // reportNetworkRequest must always be last, after all awaits
       CoralogixRum.reportNetworkRequest(details);
     };
     super(fetchConfig);
@@ -677,6 +785,13 @@ function allowNone() {
   // matches nothing
   return /^$/;
 }
+function headersToRecord(headers) {
+  const result = {};
+  headers.forEach((value, key) => {
+    result[key] = value;
+  });
+  return result;
+}
 
 function isSessionReplayOptionsValid(options) {
   const scaleValid = options.captureScale > 0 && options.captureScale <= 1;
@@ -770,7 +885,8 @@ const CoralogixRum = {
       finalOptions = resolvedOptions;
     }
     await CxSdk.initialize(_extends({}, finalOptions, {
-      frameworkVersion: pkg.version
+      frameworkVersion: pkg.version,
+      networkExtraConfig: finalOptions.networkExtraConfig ? serializeNetworkCaptureRules(finalOptions.networkExtraConfig) : undefined
     }));
     isInited = true;
   },

package/ios/CxSdk.swift

@@ -163,7 +163,9 @@ 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")
   }
@@ -365,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 ?? ""
@@ -376,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
   }
 
@@ -420,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,
@@ -434,6 +476,7 @@ class CxSdk: RCTEventEmitter {
                                           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

package/package.json

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

package/src/index.d.ts

@@ -46,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/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.
      */