Adding test and update docs

Author: al-af

Docs/RN_API.md

@@ -824,12 +824,39 @@ appsFlyer.enableTCFDataCollection(true);
 ### setConsentData
 `setConsentData(consentObject): void`
 
-When GDPR applies to the user and your app does not use a CMP compatible with TCF v2.2, use this API to provide the consent data directly to the SDK.<br>
-The AppsFlyerConsent object has 2 methods:
+When GDPR applies to the user and your app does not use a CMP compatible with TCF v2.2, use this API to provide the consent data directly to the SDK.
 
-1. `AppsFlyerConsent.forNonGDPRUser`: Indicates that GDPR doesn’t apply to the user and generates nonGDPR consent object. This method doesn’t accept any parameters.
-2. `AppsFlyerConsent.forGDPRUser`: create an AppsFlyerConsent object with 2 parameters:
+**Recommended approach (since v6.16.2):**
+Use the `AppsFlyerConsent` constructor:
+
+```javascript
+import appsFlyer, {AppsFlyerConsent} from 'react-native-appsflyer';
+
+// Full consent for GDPR user
+const consent1 = new AppsFlyerConsent(true, true, true, true);
+
+// No consent for GDPR user
+const consent2 = new AppsFlyerConsent(true, false, false, false);
+
+// Non-GDPR user
+const consent3 = new AppsFlyerConsent(false);
 
+appsFlyer.setConsentData(consent1);
+```
+
+**Constructor parameters:**
+| parameter       | type     | description                      |
+| ----------      |----------|------------------                |
+| isUserSubjectToGDPR  | boolean  | Whether GDPR applies to the user (required)       |
+| hasConsentForDataUsage  | boolean  | Consent for data usage (optional)       |
+| hasConsentForAdsPersonalization  | boolean  | Consent for ads personalization (optional)       |
+| hasConsentForAdStorage  | boolean  | Consent for ad storage (optional)       |
+
+**Deprecated approach (still supported):**
+The AppsFlyerConsent object has 2 deprecated methods:
+
+1. `AppsFlyerConsent.forNonGDPRUser`: Indicates that GDPR doesn't apply to the user and generates nonGDPR consent object. This method doesn't accept any parameters.
+2. `AppsFlyerConsent.forGDPRUser`: create an AppsFlyerConsent object with 2 parameters:
 
 | parameter       | type     | description                      |
 | ----------      |----------|------------------                |

Docs/RN_EspIntegration.md

@@ -477,6 +477,7 @@ adb shell am start -W -a android.intent.action.VIEW -d "https://your-onelink-dom
 <manifest xmlns:tools="http://schemas.android.com/tools">
   <application android:allowBackup="false" tools:replace="android:allowBackup">
 ```
+See [AppsFlyer Android SDK documentation](https://dev.appsflyer.com/hc/docs/install-android-sdk#backup-rules) for more details.
 
 **4. Package attribute deprecated:**
 - Remove `package="com.yourapp"` from AndroidManifest.xml

__tests__/compatibility.test.js

@@ -0,0 +1,146 @@
+/**
+ * Backward Compatibility Tests
+ * 
+ * These tests verify that changes in this branch don't break existing client code patterns.
+ * Focus: Runtime compatibility and type safety.
+ */
+
+import appsFlyer, { AppsFlyerConsent, StoreKitVersion } from '../index';
+
+describe('Backward Compatibility Tests', () => {
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+
+  describe('setConsentData - Runtime Compatibility', () => {
+    test('setConsentData accepts AppsFlyerConsentType-like plain object at runtime', () => {
+      // Simulate old code using plain object (AppsFlyerConsentType shape)
+      const consent = {
+        isUserSubjectToGDPR: true,
+        hasConsentForDataUsage: true,
+        hasConsentForAdsPersonalization: false
+      };
+      
+      // Should not throw - native code accepts ReadableMap/NSDictionary
+      expect(() => appsFlyer.setConsentData(consent)).not.toThrow();
+      expect(require('../node_modules/react-native/Libraries/BatchedBridge/NativeModules').RNAppsFlyer.setConsentData).toHaveBeenCalled();
+    });
+
+    test('setConsentData accepts AppsFlyerConsent class instance', () => {
+      // New code using AppsFlyerConsent class
+      const consent = new AppsFlyerConsent(true, true, false, true);
+      
+      expect(() => appsFlyer.setConsentData(consent)).not.toThrow();
+      expect(require('../node_modules/react-native/Libraries/BatchedBridge/NativeModules').RNAppsFlyer.setConsentData).toHaveBeenCalled();
+    });
+
+    test('setConsentData accepts minimal consent object (non-GDPR)', () => {
+      // Minimal object for non-GDPR user
+      const consent = {
+        isUserSubjectToGDPR: false
+      };
+      
+      expect(() => appsFlyer.setConsentData(consent)).not.toThrow();
+    });
+
+    test('setConsentData accepts AppsFlyerConsent with all optional fields', () => {
+      const consent = new AppsFlyerConsent(
+        true,  // isUserSubjectToGDPR
+        true,  // hasConsentForDataUsage
+        false, // hasConsentForAdsPersonalization
+        true   // hasConsentForAdStorage
+      );
+      
+      expect(() => appsFlyer.setConsentData(consent)).not.toThrow();
+    });
+  });
+
+  describe('StoreKitVersion - Runtime Access', () => {
+    test('StoreKitVersion is accessible at runtime as object', () => {
+      expect(StoreKitVersion).toBeDefined();
+      expect(typeof StoreKitVersion).toBe('object');
+      expect(StoreKitVersion.SK1).toBe('SK1');
+      expect(StoreKitVersion.SK2).toBe('SK2');
+    });
+
+    test('StoreKitVersion can be used in PurchaseConnectorConfig', () => {
+      const config = {
+        logSubscriptions: true,
+        logInApps: true,
+        sandbox: false,
+        storeKitVersion: StoreKitVersion.SK1
+      };
+      
+      expect(config.storeKitVersion).toBe('SK1');
+      expect(config.storeKitVersion).toBe(StoreKitVersion.SK1);
+    });
+
+    test('StoreKitVersion values are correct strings', () => {
+      expect(StoreKitVersion.SK1).toBe('SK1');
+      expect(StoreKitVersion.SK2).toBe('SK2');
+      expect(typeof StoreKitVersion.SK1).toBe('string');
+      expect(typeof StoreKitVersion.SK2).toBe('string');
+    });
+  });
+
+  describe('AppsFlyerConsent - Deprecated Static Methods', () => {
+    test('AppsFlyerConsent.forGDPRUser still works at runtime', () => {
+      const consent = AppsFlyerConsent.forGDPRUser(true, false);
+      
+      expect(consent).toBeInstanceOf(AppsFlyerConsent);
+      expect(consent.isUserSubjectToGDPR).toBe(true);
+      expect(consent.hasConsentForDataUsage).toBe(true);
+      expect(consent.hasConsentForAdsPersonalization).toBe(false);
+      
+      // Should work with setConsentData
+      expect(() => appsFlyer.setConsentData(consent)).not.toThrow();
+    });
+
+    test('AppsFlyerConsent.forNonGDPRUser still works at runtime', () => {
+      const consent = AppsFlyerConsent.forNonGDPRUser();
+      
+      expect(consent).toBeInstanceOf(AppsFlyerConsent);
+      expect(consent.isUserSubjectToGDPR).toBe(false);
+      
+      // Should work with setConsentData
+      expect(() => appsFlyer.setConsentData(consent)).not.toThrow();
+    });
+  });
+
+  describe('Callback Behavior - Android CallbackGuard (Transparent)', () => {
+    test('Callbacks still work with initSdk', () => {
+      const successCallback = jest.fn();
+      const errorCallback = jest.fn();
+      
+      const options = {
+        devKey: 'test',
+        appId: '123',
+        isDebug: true
+      };
+      
+      appsFlyer.initSdk(options, successCallback, errorCallback);
+      
+      // CallbackGuard should be transparent - callbacks should still be callable
+      expect(require('../node_modules/react-native/Libraries/BatchedBridge/NativeModules').RNAppsFlyer.initSdkWithCallBack).toHaveBeenCalled();
+    });
+
+    test('Callbacks still work with logEvent', () => {
+      const successCallback = jest.fn();
+      const errorCallback = jest.fn();
+      
+      appsFlyer.logEvent('test_event', {}, successCallback, errorCallback);
+      
+      expect(require('../node_modules/react-native/Libraries/BatchedBridge/NativeModules').RNAppsFlyer.logEvent).toHaveBeenCalled();
+    });
+  });
+
+  describe('Type Exports - ESLint Compatibility', () => {
+    test('All expected exports are available', () => {
+      expect(appsFlyer).toBeDefined();
+      expect(StoreKitVersion).toBeDefined();
+      // Note: AppsFlyerPurchaseConnector may not be available if Purchase Connector is disabled
+      // This test verifies the exports exist, not that they're functional
+    });
+  });
+});
+

jest.config.js

@@ -15,7 +15,7 @@ module.exports = {
   modulePathIgnorePatterns: ['<rootDir>/demos/'],
   testMatch: [
     '<rootDir>/__tests__/**/*.test.ts?(x)',
-    '<rootDir>/__tests__/index.test.js?(x)',
+    '<rootDir>/__tests__/**/*.test.js?(x)',
   ],
   setupFiles: ['<rootDir>/__tests__/setup.js'],
 };