feat(network-details): Add data holder classes for network detail capture

Based on design from sentry-java
  - SentryNetworkRequestData
      Top-level encapsulation of an entire network request
  - SentryReplayNetworkRequestOrResponse
      Full details for both requests and responses.
  - SentryNetworkBody:
      Body (incl. parsing logic) and warnings for both requests and responses.

  - SentryNetworkBodyWarning:
      Enum for warning codes

Author: 43jay

Sources/Sentry/SentryNetworkBody.m

@@ -0,0 +1,40 @@
+#import "SentryNetworkBody.h"
+
+@implementation SentryNetworkBody
+
+- (instancetype)initWithBody:(nullable id)body
+{
+    return [self initWithBody:body warnings:nil];
+}
+
+- (instancetype)initWithBody:(nullable id)body warnings:(nullable NSArray<NSNumber *> *)warnings
+{
+    if (self = [super init]) {
+        _body = body;
+        _warnings = warnings;
+    }
+    return self;
+}
+
+- (NSDictionary *)serialize
+{
+    NSMutableDictionary *result = [NSMutableDictionary dictionary];
+
+    if (self.body) {
+        result[@"body"] = self.body;
+    }
+
+    if (self.warnings && self.warnings.count > 0) {
+        NSMutableArray *warningStrings = [NSMutableArray arrayWithCapacity:self.warnings.count];
+        for (NSNumber *warningNumber in self.warnings) {
+            SentryNetworkBodyWarning warning
+                = (SentryNetworkBodyWarning)[warningNumber integerValue];
+            [warningStrings addObject:SentryNetworkBodyWarningToString(warning)];
+        }
+        result[@"warnings"] = warningStrings;
+    }
+
+    return result;
+}
+
+@end

Sources/Sentry/SentryNetworkBodyWarning.m

@@ -0,0 +1,16 @@
+#import "SentryNetworkBodyWarning.h"
+
+NSString *
+SentryNetworkBodyWarningToString(SentryNetworkBodyWarning warning)
+{
+    switch (warning) {
+    case SentryNetworkBodyWarningJsonTruncated:
+        return @"JSON_TRUNCATED";
+    case SentryNetworkBodyWarningTextTruncated:
+        return @"TEXT_TRUNCATED";
+    case SentryNetworkBodyWarningInvalidJson:
+        return @"INVALID_JSON";
+    case SentryNetworkBodyWarningBodyParseError:
+        return @"BODY_PARSE_ERROR";
+    }
+}

Sources/Sentry/SentryNetworkRequestData.m

@@ -0,0 +1,70 @@
+#import "SentryNetworkRequestData.h"
+
+NSString *const SentryReplayNetworkDetailsKey = @"_networkDetails";
+
+@interface SentryNetworkRequestData ()
+@property (nonatomic, copy, readwrite, nullable) NSString *method;
+@property (nonatomic, strong, readwrite, nullable) NSNumber *statusCode;
+@property (nonatomic, strong, readwrite, nullable) NSNumber *requestBodySize;
+@property (nonatomic, strong, readwrite, nullable) NSNumber *responseBodySize;
+@property (nonatomic, strong, readwrite, nullable) SentryReplayNetworkRequestOrResponse *request;
+@property (nonatomic, strong, readwrite, nullable) SentryReplayNetworkRequestOrResponse *response;
+@end
+
+@implementation SentryNetworkRequestData
+
+- (instancetype)initWithMethod:(nullable NSString *)method
+{
+    if (self = [super init]) {
+        _method = [method copy];
+    }
+    return self;
+}
+
+- (void)setRequestDetails:(SentryReplayNetworkRequestOrResponse *)requestData
+{
+    self.request = requestData;
+    self.requestBodySize = requestData.size;
+}
+
+- (void)setResponseDetails:(NSInteger)statusCode
+              responseData:(SentryReplayNetworkRequestOrResponse *)responseData
+{
+    self.statusCode = @(statusCode);
+    self.response = responseData;
+    self.responseBodySize = responseData.size;
+}
+
+- (NSDictionary *)serialize
+{
+    NSMutableDictionary *result = [NSMutableDictionary dictionary];
+
+    if (self.method) {
+        result[@"method"] = self.method;
+    }
+    if (self.statusCode) {
+        result[@"statusCode"] = self.statusCode;
+    }
+    if (self.requestBodySize) {
+        result[@"requestBodySize"] = self.requestBodySize;
+    }
+    if (self.responseBodySize) {
+        result[@"responseBodySize"] = self.responseBodySize;
+    }
+    if (self.request) {
+        result[@"request"] = [self.request serialize];
+    }
+    if (self.response) {
+        result[@"response"] = [self.response serialize];
+    }
+
+    return result;
+}
+
+- (NSString *)description
+{
+    NSDictionary *serialized = [self serialize];
+    return [NSString stringWithFormat:@"SentryNetworkRequestData: %@", serialized];
+}
+
+@end

Sources/Sentry/SentryReplayNetworkRequestOrResponse.m

@@ -0,0 +1,34 @@
+#import "SentryReplayNetworkRequestOrResponse.h"
+
+@implementation SentryReplayNetworkRequestOrResponse
+
+- (instancetype)initWithSize:(nullable NSNumber *)size
+                        body:(nullable SentryNetworkBody *)body
+                     headers:(NSDictionary<NSString *, NSString *> *)headers
+{
+    if (self = [super init]) {
+        _size = size;
+        _body = body;
+        _headers = [headers copy] ?: @{};
+    }
+    return self;
+}
+
+- (NSDictionary *)serialize
+{
+    NSMutableDictionary *result = [NSMutableDictionary dictionary];
+
+    if (self.size) {
+        result[@"size"] = self.size;
+    }
+
+    if (self.body) {
+        result[@"body"] = [self.body serialize];
+    }
+
+    result[@"headers"] = self.headers;
+
+    return result;
+}
+
+@end

Sources/Sentry/include/SentryNetworkBody.h

@@ -0,0 +1,35 @@
+#import "SentryNetworkBodyWarning.h"
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Represents a captured network request or response body with optional warnings.
+ * Mirrors sentry-java NetworkBody class.
+ */
+@interface SentryNetworkBody : NSObject
+
+/**
+ * The captured body content. May be nil if body could not be captured.
+ * For JSON: NSDictionary or NSArray (parsed JSON)
+ * For text: NSString
+ * For form-urlencoded: NSDictionary
+ */
+@property (nonatomic, strong, readonly, nullable)
+    id body; // OK: Can hold multiple body types (NSString, NSDictionary, NSData)
+
+/** List of warnings encountered during body capture/parsing. May be nil. */
+@property (nonatomic, strong, readonly, nullable) NSArray<NSNumber *> *warnings;
+
+- (instancetype)initWithBody:(nullable id)body;
+- (instancetype)initWithBody:(nullable id)body
+                    warnings:(nullable NSArray<NSNumber *> *)warnings NS_DESIGNATED_INITIALIZER;
+
+- (instancetype)init NS_UNAVAILABLE;
+
+/** Serializes to dictionary for inclusion in breadcrumb data. */
+- (NSDictionary *)serialize;
+
+@end
+
+NS_ASSUME_NONNULL_END

Sources/Sentry/include/SentryNetworkBodyWarning.h

@@ -0,0 +1,29 @@
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Warning codes for network body capture issues.
+ * Mirrors sentry-java NetworkBody.NetworkBodyWarning enum.
+ */
+typedef NS_ENUM(NSInteger, SentryNetworkBodyWarning) {
+    /** JSON body was truncated mid-parse */
+    SentryNetworkBodyWarningJsonTruncated,
+
+    /** Text body was truncated */
+    SentryNetworkBodyWarningTextTruncated,
+
+    /** JSON parsing failed - body is malformed */
+    SentryNetworkBodyWarningInvalidJson,
+
+    /** Generic body parse error */
+    SentryNetworkBodyWarningBodyParseError
+};
+
+/**
+ * Converts a warning enum value to its string representation for serialization.
+ */
+FOUNDATION_EXPORT NSString *_Nonnull SentryNetworkBodyWarningToString(
+    SentryNetworkBodyWarning warning);
+
+NS_ASSUME_NONNULL_END

Sources/Sentry/include/SentryNetworkRequestData.h

@@ -0,0 +1,52 @@
+#import "SentryDefines.h"
+#import "SentryReplayNetworkRequestOrResponse.h"
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Key used to store network details in breadcrumb data dictionary.
+ */
+SENTRY_EXTERN NSString *const SentryReplayNetworkDetailsKey;
+
+/**
+ * Main container for network request/response tracking.
+ * Mirrors sentry-java NetworkRequestData class.
+ */
+@interface SentryNetworkRequestData : NSObject
+
+/** HTTP method (nullable) */
+@property (nonatomic, copy, readonly, nullable) NSString *method;
+
+/** HTTP status code (nullable) */
+@property (nonatomic, strong, readonly, nullable) NSNumber *statusCode;
+
+/** Request body size in bytes (nullable) */
+@property (nonatomic, strong, readonly, nullable) NSNumber *requestBodySize;
+
+/** Response body size in bytes (nullable) */
+@property (nonatomic, strong, readonly, nullable) NSNumber *responseBodySize;
+
+/** Request details (nullable) */
+@property (nonatomic, strong, readonly, nullable) SentryReplayNetworkRequestOrResponse *request;
+
+/** Response details (nullable) */
+@property (nonatomic, strong, readonly, nullable) SentryReplayNetworkRequestOrResponse *response;
+
+- (instancetype)initWithMethod:(nullable NSString *)method NS_DESIGNATED_INITIALIZER;
+
+- (instancetype)init NS_UNAVAILABLE;
+
+/** Sets request details and updates requestBodySize */
+- (void)setRequestDetails:(SentryReplayNetworkRequestOrResponse *)requestData;
+
+/** Sets response details, statusCode, and updates responseBodySize */
+- (void)setResponseDetails:(NSInteger)statusCode
+              responseData:(SentryReplayNetworkRequestOrResponse *)responseData;
+
+/** Serializes to dictionary for inclusion in breadcrumb data. */
+- (NSDictionary *)serialize;
+
+@end
+
+NS_ASSUME_NONNULL_END

Sources/Sentry/include/SentryReplayNetworkRequestOrResponse.h

@@ -0,0 +1,33 @@
+#import "SentryNetworkBody.h"
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Represents captured HTTP request or response details.
+ * Mirrors sentry-java ReplayNetworkRequestOrResponse class.
+ */
+@interface SentryReplayNetworkRequestOrResponse : NSObject
+
+/** Content size in bytes (nullable) */
+@property (nonatomic, strong, readonly, nullable) NSNumber *size;
+
+/** Body content (nullable) */
+@property (nonatomic, strong, readonly, nullable) SentryNetworkBody *body;
+
+/** HTTP headers (non-null) */
+@property (nonatomic, copy, readonly) NSDictionary<NSString *, NSString *> *headers;
+
+- (instancetype)initWithSize:(nullable NSNumber *)size
+                        body:(nullable SentryNetworkBody *)body
+                     headers:(NSDictionary<NSString *, NSString *> *)headers
+    NS_DESIGNATED_INITIALIZER;
+
+- (instancetype)init NS_UNAVAILABLE;
+
+/** Serializes to dictionary for inclusion in breadcrumb data. */
+- (NSDictionary *)serialize;
+
+@end
+
+NS_ASSUME_NONNULL_END

Sources/Swift/Integrations/SessionReplay/SentryReplayOptions.swift

@@ -720,26 +720,22 @@ public class SentryReplayOptions: NSObject, SentryRedactOptions {
      *
      * - Parameter userHeaders: Headers specified by the user (can be nil)
      * - Parameter defaults: Default headers that must always be included
-     * - Returns: Array containing both user headers and default headers (with duplicates removed)
+     * - Returns: Array containing both user headers and default headers with duplicates removed.
      */
     private static func mergeWithDefaultHeaders(_ userHeaders: [String]?, defaults: [String]) -> [String] {
         let providedHeaders = userHeaders ?? []
 
-        // Use Set to remove duplicates, then convert back to Array
-        // Case-insensitive comparison to avoid duplicate headers with different casing
         var seenHeaders = Set<String>()
         var result: [String] = []
-        
-        // Add default headers first
+
         for header in defaults {
             let lowercased = header.lowercased()
             if !seenHeaders.contains(lowercased) {
                 seenHeaders.insert(lowercased)
                 result.append(header)
             }
         }
-        
-        // Add user-provided headers
+
         for header in providedHeaders {
             let lowercased = header.lowercased()
             if !seenHeaders.contains(lowercased) {

Tests/SentryTests/SentryTests-Bridging-Header.h

@@ -106,13 +106,17 @@
 #import "SentryNSDictionarySanitize.h"
 #import "SentryNSError.h"
 #import "SentryNSURLSessionTaskSearch.h"
+#import "SentryNetworkBody.h"
+#import "SentryNetworkBodyWarning.h"
+#import "SentryNetworkRequestData.h"
 #import "SentryNetworkTracker.h"
 #import "SentryNoOpSpan.h"
 #import "SentryOptionsInternal.h"
 #import "SentryPerformanceTracker+Testing.h"
 #import "SentryPerformanceTracker.h"
 #import "SentryProfilingConditionals.h"
 #import "SentryQueueableRequestManager.h"
+#import "SentryReplayNetworkRequestOrResponse.h"
 #import "SentrySDK+Private.h"
 #import "SentrySDKInternal+Tests.h"
 #import "SentrySampleDecision+Private.h"