@datalyr/react-native 1.3.0 → 1.3.1

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to the Datalyr React Native SDK will be documented in this f
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.1] - 2026-01
+
+### Added
+- **iOS 18.4+ Features** - Geo-level postbacks, development postbacks, overlapping windows
+- **Privacy Manifest** (`ios/PrivacyInfo.xcprivacy`) - Required for App Store compliance
+- **Network Status Detection** - Automatic online/offline handling with queue sync
+- `SKAdNetworkBridge` iOS 18.4+ methods:
+  - `isGeoPostbackAvailable()` - Check for geo-level postback support
+  - `setPostbackEnvironment()` - Configure sandbox/production mode
+  - `getEnhancedAttributionInfo()` - Full feature matrix by iOS version
+  - `updatePostbackWithWindow()` - Overlapping window support
+  - `enableDevelopmentMode()` / `disableDevelopmentMode()` - Convenience methods
+- Migration guides from AppsFlyer and Adjust
+- Comprehensive troubleshooting section in README
+
+### Changed
+- Parallel SDK initialization for faster startup
+- Enhanced TypeScript types for iOS 18.4+ responses
+
 ## [1.2.1] - 2025-01
 
 ### Added

package/README.md

@@ -553,24 +553,160 @@ import {
 
 ---
 
+## Migrating from AppsFlyer / Adjust
+
+Datalyr provides similar functionality with a simpler integration.
+
+### From AppsFlyer
+
+```typescript
+// BEFORE: AppsFlyer
+import appsFlyer from 'react-native-appsflyer';
+appsFlyer.logEvent('af_purchase', { af_revenue: 99.99, af_currency: 'USD' });
+
+// AFTER: Datalyr
+import { Datalyr } from '@datalyr/react-native';
+await Datalyr.trackPurchase(99.99, 'USD', 'product_id');
+```
+
+### From Adjust
+
+```typescript
+// BEFORE: Adjust
+import { Adjust, AdjustEvent } from 'react-native-adjust';
+const event = new AdjustEvent('abc123');
+event.setRevenue(99.99, 'USD');
+Adjust.trackEvent(event);
+
+// AFTER: Datalyr
+import { Datalyr } from '@datalyr/react-native';
+await Datalyr.trackPurchase(99.99, 'USD');
+```
+
+### Event Mapping
+
+| AppsFlyer | Adjust | Datalyr |
+|-----------|--------|---------|
+| `af_purchase` | `PURCHASE` | `trackPurchase()` |
+| `af_add_to_cart` | `ADD_TO_CART` | `trackAddToCart()` |
+| `af_initiated_checkout` | `INITIATE_CHECKOUT` | `trackInitiateCheckout()` |
+| `af_complete_registration` | `COMPLETE_REGISTRATION` | `trackCompleteRegistration()` |
+| `af_content_view` | `VIEW_CONTENT` | `trackViewContent()` |
+| `af_subscribe` | `SUBSCRIBE` | `trackSubscription()` |
+
+### Migration Checklist
+
+- [ ] Remove old SDK: `npm uninstall react-native-appsflyer`
+- [ ] Install Datalyr: `npm install @datalyr/react-native`
+- [ ] Run `cd ios && pod install`
+- [ ] Replace initialization and event tracking code
+- [ ] Verify events in Datalyr dashboard
+
+---
+
 ## Troubleshooting
 
-### Events not appearing
+### Events Not Appearing
+
+**1. Check SDK Status**
+```typescript
+const status = Datalyr.getStatus();
+console.log('Initialized:', status.initialized);
+console.log('Queue size:', status.queueStats.queueSize);
+console.log('Online:', status.queueStats.isOnline);
+```
+
+**2. Enable Debug Mode**
+```typescript
+await Datalyr.initialize({
+  apiKey: 'dk_your_api_key',
+  debug: true,
+});
+```
+
+**3. Force Flush**
+```typescript
+await Datalyr.flush();
+```
+
+**4. Verify API Key** - Should start with `dk_`
 
-1. Check API key starts with `dk_`
-2. Enable `debug: true`
-3. Check `Datalyr.getStatus()` for queue info
-4. Verify network connectivity
+### iOS Build Errors
 
-### iOS build errors
+```bash
+cd ios
+pod deintegrate
+pod cache clean --all
+pod install
+```
 
+**Clean Reset**
 ```bash
-cd ios && pod deintegrate && pod install
+rm -rf node_modules ios/Pods ios/Podfile.lock
+npm install && cd ios && pod install
+```
+
+### Android Build Errors
+
+```bash
+cd android && ./gradlew clean
+npx react-native run-android
+```
+
+### Meta SDK Not Working
+
+Verify Info.plist:
+```xml
+<key>FacebookAppID</key>
+<string>YOUR_APP_ID</string>
+<key>FacebookClientToken</key>
+<string>YOUR_CLIENT_TOKEN</string>
+```
+
+Check status: `Datalyr.getPlatformIntegrationStatus()`
+
+### TikTok SDK Not Working
+
+```typescript
+await Datalyr.initialize({
+  apiKey: 'dk_your_api_key',
+  tiktok: {
+    appId: 'your_app_id',
+    tiktokAppId: '7123456789012345',
+  },
+});
+```
+
+### SKAdNetwork Not Updating
+
+1. iOS 14.0+ required (16.1+ for SKAN 4.0)
+2. Set `skadTemplate` in config
+3. Use `trackWithSKAdNetwork()` instead of `track()`
+
+### Attribution Not Captured
+
+```typescript
+await Datalyr.initialize({
+  apiKey: 'dk_your_api_key',
+  enableAttribution: true,
+});
+
+// Check data
+const attribution = Datalyr.getAttributionData();
+```
+
+### App Tracking Transparency (iOS 14.5+)
+
+```typescript
+import { requestTrackingPermissionsAsync } from 'expo-tracking-transparency';
+
+const { status } = await requestTrackingPermissionsAsync();
+await Datalyr.updateTrackingAuthorization(status === 'granted');
 ```
 
-### Meta/TikTok not working
+### Debug Logging
 
-Verify Info.plist contains required keys (see Installation).
+Look for `[Datalyr]` prefixed messages in console.
 
 ---
 

package/ios/DatalyrSKAdNetwork.m

@@ -24,12 +24,19 @@ RCT_EXPORT_METHOD(updateConversionValue:(NSInteger)value
     }
 }
 
-// SKAN 4.0 - New method for iOS 16.1+ with coarse value and lock window support
+// SKAN 4.0 / AdAttributionKit - Method for iOS 16.1+ with coarse value and lock window support
+// On iOS 17.4+, this uses AdAttributionKit under the hood
 RCT_EXPORT_METHOD(updatePostbackConversionValue:(NSInteger)fineValue
                   coarseValue:(NSString *)coarseValue
                   lockWindow:(BOOL)lockWindow
                   resolve:(RCTPromiseResolveBlock)resolve
                   reject:(RCTPromiseRejectBlock)reject) {
+    // Validate fine value range
+    if (fineValue < 0 || fineValue > 63) {
+        reject(@"invalid_value", @"Conversion value must be between 0 and 63", nil);
+        return;
+    }
+
     if (@available(iOS 16.1, *)) {
         // Convert string to SKAdNetwork.CoarseConversionValue
         SKAdNetworkCoarseConversionValue coarse;
@@ -48,14 +55,31 @@ RCT_EXPORT_METHOD(updatePostbackConversionValue:(NSInteger)fineValue
             if (error) {
                 reject(@"skadnetwork_error", error.localizedDescription, error);
             } else {
-                resolve(@(YES));
+                // Return framework info along with success
+                NSString *framework = @"SKAdNetwork";
+                if (@available(iOS 17.4, *)) {
+                    framework = @"AdAttributionKit";
+                }
+                resolve(@{
+                    @"success": @(YES),
+                    @"framework": framework,
+                    @"fineValue": @(fineValue),
+                    @"coarseValue": coarseValue,
+                    @"lockWindow": @(lockWindow)
+                });
             }
         }];
     } else if (@available(iOS 14.0, *)) {
         // Fallback to SKAN 3.0 for iOS 14.0-16.0
         @try {
             [SKAdNetwork updateConversionValue:fineValue];
-            resolve(@(YES));
+            resolve(@{
+                @"success": @(YES),
+                @"framework": @"SKAdNetwork",
+                @"fineValue": @(fineValue),
+                @"coarseValue": @"n/a",
+                @"lockWindow": @(NO)
+            });
         } @catch (NSException *exception) {
             reject(@"skadnetwork_error", exception.reason, nil);
         }
@@ -74,4 +98,328 @@ RCT_EXPORT_METHOD(isSKAN4Available:(RCTPromiseResolveBlock)resolve
     }
 }
 
+// Check if AdAttributionKit is available (iOS 17.4+)
+RCT_EXPORT_METHOD(isAdAttributionKitAvailable:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject) {
+    if (@available(iOS 17.4, *)) {
+        resolve(@(YES));
+    } else {
+        resolve(@(NO));
+    }
+}
+
+// Check if overlapping windows are available (iOS 18.4+)
+RCT_EXPORT_METHOD(isOverlappingWindowsAvailable:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject) {
+    if (@available(iOS 18.4, *)) {
+        resolve(@(YES));
+    } else {
+        resolve(@(NO));
+    }
+}
+
+// Register for ad network attribution (supports both AdAttributionKit and SKAdNetwork)
+RCT_EXPORT_METHOD(registerForAttribution:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject) {
+    if (@available(iOS 17.4, *)) {
+        // AdAttributionKit registration via initial conversion value update
+        [SKAdNetwork updatePostbackConversionValue:0
+                                       coarseValue:SKAdNetworkCoarseConversionValueLow
+                                        lockWindow:NO
+                                 completionHandler:^(NSError * _Nullable error) {
+            if (error) {
+                reject(@"attribution_error", error.localizedDescription, error);
+            } else {
+                resolve(@{@"framework": @"AdAttributionKit", @"registered": @(YES)});
+            }
+        }];
+    } else if (@available(iOS 14.0, *)) {
+        // Legacy SKAdNetwork registration
+        [SKAdNetwork registerAppForAdNetworkAttribution];
+        resolve(@{@"framework": @"SKAdNetwork", @"registered": @(YES)});
+    } else {
+        reject(@"ios_version_error", @"Attribution requires iOS 14.0+", nil);
+    }
+}
+
+// Get attribution framework info
+RCT_EXPORT_METHOD(getAttributionInfo:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject) {
+    NSMutableDictionary *info = [NSMutableDictionary dictionary];
+
+    if (@available(iOS 17.4, *)) {
+        info[@"framework"] = @"AdAttributionKit";
+        info[@"version"] = @"1.0";
+        info[@"reengagement_available"] = @(YES);
+        info[@"fine_value_range"] = @{@"min": @0, @"max": @63};
+        info[@"coarse_values"] = @[@"low", @"medium", @"high"];
+        if (@available(iOS 18.4, *)) {
+            info[@"overlapping_windows"] = @(YES);
+        } else {
+            info[@"overlapping_windows"] = @(NO);
+        }
+    } else if (@available(iOS 16.1, *)) {
+        info[@"framework"] = @"SKAdNetwork";
+        info[@"version"] = @"4.0";
+        info[@"reengagement_available"] = @(NO);
+        info[@"overlapping_windows"] = @(NO);
+        info[@"fine_value_range"] = @{@"min": @0, @"max": @63};
+        info[@"coarse_values"] = @[@"low", @"medium", @"high"];
+    } else if (@available(iOS 14.0, *)) {
+        info[@"framework"] = @"SKAdNetwork";
+        info[@"version"] = @"3.0";
+        info[@"reengagement_available"] = @(NO);
+        info[@"overlapping_windows"] = @(NO);
+        info[@"fine_value_range"] = @{@"min": @0, @"max": @63};
+        info[@"coarse_values"] = @[];
+    } else {
+        info[@"framework"] = @"none";
+        info[@"version"] = @"0";
+        info[@"reengagement_available"] = @(NO);
+        info[@"overlapping_windows"] = @(NO);
+        info[@"fine_value_range"] = @{@"min": @0, @"max": @0};
+        info[@"coarse_values"] = @[];
+    }
+
+    resolve(info);
+}
+
+// Update conversion value for re-engagement (AdAttributionKit iOS 17.4+ only)
+// Re-engagement tracks users who return to the app via an ad after initial install
+RCT_EXPORT_METHOD(updateReengagementConversionValue:(NSInteger)fineValue
+                  coarseValue:(NSString *)coarseValue
+                  lockWindow:(BOOL)lockWindow
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject) {
+    if (@available(iOS 17.4, *)) {
+        // Validate fine value range
+        if (fineValue < 0 || fineValue > 63) {
+            reject(@"invalid_value", @"Conversion value must be between 0 and 63", nil);
+            return;
+        }
+
+        // Convert string to SKAdNetwork.CoarseConversionValue
+        SKAdNetworkCoarseConversionValue coarse;
+        if ([coarseValue isEqualToString:@"high"]) {
+            coarse = SKAdNetworkCoarseConversionValueHigh;
+        } else if ([coarseValue isEqualToString:@"medium"]) {
+            coarse = SKAdNetworkCoarseConversionValueMedium;
+        } else {
+            coarse = SKAdNetworkCoarseConversionValueLow;
+        }
+
+        // In AdAttributionKit, re-engagement uses the same API
+        // The framework distinguishes based on user attribution state
+        [SKAdNetwork updatePostbackConversionValue:fineValue
+                                       coarseValue:coarse
+                                        lockWindow:lockWindow
+                                 completionHandler:^(NSError * _Nullable error) {
+            if (error) {
+                reject(@"reengagement_error", error.localizedDescription, error);
+            } else {
+                resolve(@{
+                    @"success": @(YES),
+                    @"type": @"reengagement",
+                    @"framework": @"AdAttributionKit",
+                    @"fineValue": @(fineValue),
+                    @"coarseValue": coarseValue,
+                    @"lockWindow": @(lockWindow)
+                });
+            }
+        }];
+    } else {
+        reject(@"unsupported", @"Re-engagement attribution requires iOS 17.4+ (AdAttributionKit)", nil);
+    }
+}
+
+// iOS 18.4+ - Check if geo-level postback data is available
+RCT_EXPORT_METHOD(isGeoPostbackAvailable:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject) {
+    if (@available(iOS 18.4, *)) {
+        resolve(@(YES));
+    } else {
+        resolve(@(NO));
+    }
+}
+
+// iOS 18.4+ - Set postback environment for testing
+// environment: "production" or "sandbox"
+RCT_EXPORT_METHOD(setPostbackEnvironment:(NSString *)environment
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject) {
+    if (@available(iOS 18.4, *)) {
+        // Note: In iOS 18.4+, development postbacks are controlled via
+        // the developer mode setting in device settings, not programmatically.
+        // This method validates the environment string and logs for debugging.
+        BOOL isSandbox = [environment isEqualToString:@"sandbox"];
+        NSLog(@"[Datalyr] Postback environment set to: %@ (note: actual sandbox mode is controlled via device Developer Mode)", environment);
+        resolve(@{
+            @"environment": environment,
+            @"isSandbox": @(isSandbox),
+            @"note": @"Enable Developer Mode in iOS Settings for sandbox postbacks"
+        });
+    } else {
+        reject(@"unsupported", @"Development postbacks require iOS 18.4+", nil);
+    }
+}
+
+// iOS 18.4+ - Get enhanced attribution info including geo availability
+RCT_EXPORT_METHOD(getEnhancedAttributionInfo:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject) {
+    NSMutableDictionary *info = [NSMutableDictionary dictionary];
+
+    if (@available(iOS 18.4, *)) {
+        info[@"framework"] = @"AdAttributionKit";
+        info[@"version"] = @"2.0";
+        info[@"reengagement_available"] = @(YES);
+        info[@"overlapping_windows"] = @(YES);
+        info[@"geo_postback_available"] = @(YES);
+        info[@"development_postbacks"] = @(YES);
+        info[@"fine_value_range"] = @{@"min": @0, @"max": @63};
+        info[@"coarse_values"] = @[@"low", @"medium", @"high"];
+        info[@"features"] = @[
+            @"overlapping_windows",
+            @"geo_level_postbacks",
+            @"development_postbacks",
+            @"reengagement"
+        ];
+    } else if (@available(iOS 17.4, *)) {
+        info[@"framework"] = @"AdAttributionKit";
+        info[@"version"] = @"1.0";
+        info[@"reengagement_available"] = @(YES);
+        info[@"overlapping_windows"] = @(NO);
+        info[@"geo_postback_available"] = @(NO);
+        info[@"development_postbacks"] = @(NO);
+        info[@"fine_value_range"] = @{@"min": @0, @"max": @63};
+        info[@"coarse_values"] = @[@"low", @"medium", @"high"];
+        info[@"features"] = @[@"reengagement"];
+    } else if (@available(iOS 16.1, *)) {
+        info[@"framework"] = @"SKAdNetwork";
+        info[@"version"] = @"4.0";
+        info[@"reengagement_available"] = @(NO);
+        info[@"overlapping_windows"] = @(NO);
+        info[@"geo_postback_available"] = @(NO);
+        info[@"development_postbacks"] = @(NO);
+        info[@"fine_value_range"] = @{@"min": @0, @"max": @63};
+        info[@"coarse_values"] = @[@"low", @"medium", @"high"];
+        info[@"features"] = @[];
+    } else if (@available(iOS 14.0, *)) {
+        info[@"framework"] = @"SKAdNetwork";
+        info[@"version"] = @"3.0";
+        info[@"reengagement_available"] = @(NO);
+        info[@"overlapping_windows"] = @(NO);
+        info[@"geo_postback_available"] = @(NO);
+        info[@"development_postbacks"] = @(NO);
+        info[@"fine_value_range"] = @{@"min": @0, @"max": @63};
+        info[@"coarse_values"] = @[];
+        info[@"features"] = @[];
+    } else {
+        info[@"framework"] = @"none";
+        info[@"version"] = @"0";
+        info[@"reengagement_available"] = @(NO);
+        info[@"overlapping_windows"] = @(NO);
+        info[@"geo_postback_available"] = @(NO);
+        info[@"development_postbacks"] = @(NO);
+        info[@"fine_value_range"] = @{@"min": @0, @"max": @0};
+        info[@"coarse_values"] = @[];
+        info[@"features"] = @[];
+    }
+
+    resolve(info);
+}
+
+// iOS 18.4+ - Update postback with overlapping window support
+// windowIndex: 0 = first window (0-2 days), 1 = second window (3-7 days), 2 = third window (8-35 days)
+RCT_EXPORT_METHOD(updatePostbackWithWindow:(NSInteger)fineValue
+                  coarseValue:(NSString *)coarseValue
+                  lockWindow:(BOOL)lockWindow
+                  windowIndex:(NSInteger)windowIndex
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject) {
+    // Validate fine value range
+    if (fineValue < 0 || fineValue > 63) {
+        reject(@"invalid_value", @"Conversion value must be between 0 and 63", nil);
+        return;
+    }
+
+    // Validate window index
+    if (windowIndex < 0 || windowIndex > 2) {
+        reject(@"invalid_window", @"Window index must be 0, 1, or 2", nil);
+        return;
+    }
+
+    if (@available(iOS 18.4, *)) {
+        // Convert string to SKAdNetwork.CoarseConversionValue
+        SKAdNetworkCoarseConversionValue coarse;
+        if ([coarseValue isEqualToString:@"high"]) {
+            coarse = SKAdNetworkCoarseConversionValueHigh;
+        } else if ([coarseValue isEqualToString:@"medium"]) {
+            coarse = SKAdNetworkCoarseConversionValueMedium;
+        } else {
+            coarse = SKAdNetworkCoarseConversionValueLow;
+        }
+
+        // iOS 18.4 uses the same API but handles overlapping windows automatically
+        // based on timing. The windowIndex is for SDK tracking purposes.
+        [SKAdNetwork updatePostbackConversionValue:fineValue
+                                       coarseValue:coarse
+                                        lockWindow:lockWindow
+                                 completionHandler:^(NSError * _Nullable error) {
+            if (error) {
+                reject(@"postback_error", error.localizedDescription, error);
+            } else {
+                resolve(@{
+                    @"success": @(YES),
+                    @"framework": @"AdAttributionKit",
+                    @"version": @"2.0",
+                    @"fineValue": @(fineValue),
+                    @"coarseValue": coarseValue,
+                    @"lockWindow": @(lockWindow),
+                    @"windowIndex": @(windowIndex),
+                    @"overlappingWindows": @(YES)
+                });
+            }
+        }];
+    } else if (@available(iOS 16.1, *)) {
+        // Fallback for iOS 16.1-18.3 (no overlapping windows)
+        SKAdNetworkCoarseConversionValue coarse;
+        if ([coarseValue isEqualToString:@"high"]) {
+            coarse = SKAdNetworkCoarseConversionValueHigh;
+        } else if ([coarseValue isEqualToString:@"medium"]) {
+            coarse = SKAdNetworkCoarseConversionValueMedium;
+        } else {
+            coarse = SKAdNetworkCoarseConversionValueLow;
+        }
+
+        [SKAdNetwork updatePostbackConversionValue:fineValue
+                                       coarseValue:coarse
+                                        lockWindow:lockWindow
+                                 completionHandler:^(NSError * _Nullable error) {
+            if (error) {
+                reject(@"postback_error", error.localizedDescription, error);
+            } else {
+                NSString *framework = @"SKAdNetwork";
+                NSString *version = @"4.0";
+                if (@available(iOS 17.4, *)) {
+                    framework = @"AdAttributionKit";
+                    version = @"1.0";
+                }
+                resolve(@{
+                    @"success": @(YES),
+                    @"framework": framework,
+                    @"version": version,
+                    @"fineValue": @(fineValue),
+                    @"coarseValue": coarseValue,
+                    @"lockWindow": @(lockWindow),
+                    @"windowIndex": @(windowIndex),
+                    @"overlappingWindows": @(NO),
+                    @"note": @"Overlapping windows require iOS 18.4+"
+                });
+            }
+        }];
+    } else {
+        reject(@"unsupported", @"This method requires iOS 16.1+", nil);
+    }
+}
+
 @end

package/ios/PrivacyInfo.xcprivacy

@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>NSPrivacyTracking</key>
+    <false/>
+    <key>NSPrivacyTrackingDomains</key>
+    <array/>
+    <key>NSPrivacyCollectedDataTypes</key>
+    <array>
+        <dict>
+            <key>NSPrivacyCollectedDataType</key>
+            <string>NSPrivacyCollectedDataTypeDeviceID</string>
+            <key>NSPrivacyCollectedDataTypeLinked</key>
+            <false/>
+            <key>NSPrivacyCollectedDataTypeTracking</key>
+            <false/>
+            <key>NSPrivacyCollectedDataTypePurposes</key>
+            <array>
+                <string>NSPrivacyCollectedDataTypePurposeAnalytics</string>
+            </array>
+        </dict>
+        <dict>
+            <key>NSPrivacyCollectedDataType</key>
+            <string>NSPrivacyCollectedDataTypeProductInteraction</string>
+            <key>NSPrivacyCollectedDataTypeLinked</key>
+            <false/>
+            <key>NSPrivacyCollectedDataTypeTracking</key>
+            <false/>
+            <key>NSPrivacyCollectedDataTypePurposes</key>
+            <array>
+                <string>NSPrivacyCollectedDataTypePurposeAnalytics</string>
+            </array>
+        </dict>
+    </array>
+    <key>NSPrivacyAccessedAPITypes</key>
+    <array>
+        <dict>
+            <key>NSPrivacyAccessedAPIType</key>
+            <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
+            <key>NSPrivacyAccessedAPITypeReasons</key>
+            <array>
+                <string>CA92.1</string>
+            </array>
+        </dict>
+    </array>
+</dict>
+</plist>

package/lib/datalyr-sdk.d.ts

@@ -8,6 +8,7 @@ export declare class DatalyrSDK {
     private eventQueue;
     private autoEventsManager;
     private appStateSubscription;
+    private networkStatusUnsubscribe;
     private static conversionEncoder?;
     private static debugEnabled;
     constructor();
@@ -193,6 +194,11 @@ export declare class DatalyrSDK {
      * Persist user data to storage
      */
     private persistUserData;
+    /**
+     * Initialize network status monitoring
+     * Automatically updates event queue when network status changes
+     */
+    private initializeNetworkMonitoring;
     /**
      * Set up app state monitoring for lifecycle events (optimized)
      */