insert-affiliate-react-native-sdk 1.12.0 → 1.14.0

package/dist/DeepLinkIapProvider.js

@@ -56,6 +56,7 @@ const ASYNC_KEYS = {
     AFFILIATE_STORED_DATE: '@app_affiliate_stored_date',
     SDK_INIT_REPORTED: '@app_sdk_init_reported',
     REPORTED_AFFILIATE_ASSOCIATIONS: '@app_reported_affiliate_associations',
+    SYSTEM_INFO_SENT: '@app_system_info_sent',
 };
 // STARTING CONTEXT IMPLEMENTATION
 exports.DeepLinkIapContext = (0, react_1.createContext)({
@@ -151,12 +152,20 @@ const DeepLinkIapProvider = ({ children, }) => {
             }
         }
         if (insertLinksEnabledParam && react_native_1.Platform.OS === 'ios') {
-            try {
-                const enhancedSystemInfo = yield getEnhancedSystemInfo();
-                yield sendSystemInfoToBackend(enhancedSystemInfo);
-            }
-            catch (error) {
-                verboseLog(`Error sending system info for clipboard check: ${error}`);
+            const systemInfoSent = yield getValueFromAsync(ASYNC_KEYS.SYSTEM_INFO_SENT);
+            verboseLog(`System info sent flag: ${systemInfoSent ? 'true (skipping)' : 'false (will send)'}`);
+            if (!systemInfoSent) {
+                // Set flag immediately to prevent concurrent init calls from sending twice
+                yield saveValueInAsync(ASYNC_KEYS.SYSTEM_INFO_SENT, 'pending');
+                try {
+                    const enhancedSystemInfo = yield getEnhancedSystemInfo();
+                    yield sendSystemInfoToBackend(enhancedSystemInfo);
+                }
+                catch (error) {
+                    // Remove flag on failure so it retries next launch
+                    yield async_storage_1.default.removeItem(ASYNC_KEYS.SYSTEM_INFO_SENT);
+                    verboseLog(`Error sending system info for clipboard check: ${error}`);
+                }
             }
         }
     });
@@ -561,14 +570,7 @@ const DeepLinkIapProvider = ({ children, }) => {
             }
             // If URL scheme is used, we can straight away store the short code as the referring link
             yield storeInsertAffiliateIdentifier({ link: shortCode, source: 'deep_link_ios' });
-            // Collect and send enhanced system info to backend
-            try {
-                const enhancedSystemInfo = yield getEnhancedSystemInfo();
-                yield sendSystemInfoToBackend(enhancedSystemInfo);
-            }
-            catch (error) {
-                verboseLog(`Error sending system info for deep link: ${error}`);
-            }
+            // System info not needed here - affiliate code already received via URL scheme
             return true;
         }
         catch (error) {
@@ -1162,6 +1164,7 @@ const DeepLinkIapProvider = ({ children, }) => {
             }
             // Check for a successful response
             if (response.status >= 200 && response.status <= 299) {
+                yield saveValueInAsync(ASYNC_KEYS.SYSTEM_INFO_SENT, 'true');
                 verboseLog('System info sent successfully');
             }
             else {
@@ -1182,7 +1185,7 @@ const DeepLinkIapProvider = ({ children, }) => {
         const isValidCharacters = /^[a-zA-Z0-9_]+$/.test(referringLink);
         return isValidCharacters && referringLink.length >= 3 && referringLink.length <= 25;
     };
-    const checkAffiliateExists = (affiliateCode) => __awaiter(void 0, void 0, void 0, function* () {
+    const checkAffiliateExists = (affiliateCode_1, ...args_1) => __awaiter(void 0, [affiliateCode_1, ...args_1], void 0, function* (affiliateCode, trackUsage = false) {
         try {
             const activeCompanyCode = yield getActiveCompanyCode();
             if (!activeCompanyCode) {
@@ -1194,6 +1197,9 @@ const DeepLinkIapProvider = ({ children, }) => {
                 companyId: activeCompanyCode,
                 affiliateCode: affiliateCode
             };
+            if (trackUsage) {
+                payload.trackUsage = true;
+            }
             verboseLog(`Checking if affiliate exists: ${affiliateCode}`);
             const response = yield axios_1.default.post(url, payload, {
                 headers: {
@@ -1267,7 +1273,7 @@ const DeepLinkIapProvider = ({ children, }) => {
         const capitalisedShortCode = shortCode.toUpperCase();
         isShortCode(capitalisedShortCode);
         // Check if the affiliate exists before storing
-        const exists = yield checkAffiliateExists(capitalisedShortCode);
+        const exists = yield checkAffiliateExists(capitalisedShortCode, true);
         if (exists) {
             // If affiliate exists, set the Insert Affiliate Identifier
             yield storeInsertAffiliateIdentifier({ link: capitalisedShortCode, source: 'short_code_manual' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "insert-affiliate-react-native-sdk",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "A package for connecting with the Insert Affiliate Platform to add app based affiliate marketing.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/readme.md

@@ -1011,6 +1011,29 @@ const rawIdentifier = await returnInsertAffiliateIdentifier(true);
 
 </details>
 
+### Prevent Affiliate Transfer
+
+By default, clicking a new affiliate link will overwrite any existing attribution. Enable `preventAffiliateTransfer` to lock the first affiliate:
+
+```javascript
+initialize(
+  "YOUR_COMPANY_CODE",
+  false,   // verboseLogging
+  false,   // insertLinksEnabled
+  false,   // insertLinksClipboardEnabled
+  604800,  // affiliateAttributionActiveTime (7 days)
+  true     // preventAffiliateTransfer - locks first affiliate
+);
+```
+
+**How it works:**
+- When enabled, once a user is attributed to an affiliate, that attribution is locked
+- New affiliate links will not overwrite the existing attribution
+- The callback still fires with the existing affiliate data (not the new one)
+- Useful for preventing "affiliate stealing" where users click competitor links
+
+Learn more: [Prevent Affiliate Transfer Documentation](https://docs.insertaffiliate.com/prevent-affiliate-transfer)
+
 ---
 
 ## 🔍 Troubleshooting

package/src/DeepLinkIapProvider.tsx

@@ -83,6 +83,7 @@ const ASYNC_KEYS = {
   AFFILIATE_STORED_DATE: '@app_affiliate_stored_date',
   SDK_INIT_REPORTED: '@app_sdk_init_reported',
   REPORTED_AFFILIATE_ASSOCIATIONS: '@app_reported_affiliate_associations',
+  SYSTEM_INFO_SENT: '@app_system_info_sent',
 };
 
 // Source types for affiliate association tracking
@@ -207,11 +208,19 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
     }
 
     if (insertLinksEnabledParam && Platform.OS === 'ios') {
-      try {
-        const enhancedSystemInfo = await getEnhancedSystemInfo();
-        await sendSystemInfoToBackend(enhancedSystemInfo);
-      } catch (error) {
-        verboseLog(`Error sending system info for clipboard check: ${error}`);
+      const systemInfoSent = await getValueFromAsync(ASYNC_KEYS.SYSTEM_INFO_SENT);
+      verboseLog(`System info sent flag: ${systemInfoSent ? 'true (skipping)' : 'false (will send)'}`);
+      if (!systemInfoSent) {
+        // Set flag immediately to prevent concurrent init calls from sending twice
+        await saveValueInAsync(ASYNC_KEYS.SYSTEM_INFO_SENT, 'pending');
+        try {
+          const enhancedSystemInfo = await getEnhancedSystemInfo();
+          await sendSystemInfoToBackend(enhancedSystemInfo);
+        } catch (error) {
+          // Remove flag on failure so it retries next launch
+          await AsyncStorage.removeItem(ASYNC_KEYS.SYSTEM_INFO_SENT);
+          verboseLog(`Error sending system info for clipboard check: ${error}`);
+        }
       }
     }
   };
@@ -664,13 +673,7 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
       // If URL scheme is used, we can straight away store the short code as the referring link
       await storeInsertAffiliateIdentifier({ link: shortCode, source: 'deep_link_ios' });
 
-      // Collect and send enhanced system info to backend
-      try {
-        const enhancedSystemInfo = await getEnhancedSystemInfo();
-        await sendSystemInfoToBackend(enhancedSystemInfo);
-      } catch (error) {
-        verboseLog(`Error sending system info for deep link: ${error}`);
-      }
+      // System info not needed here - affiliate code already received via URL scheme
 
       return true;
     } catch (error) {
@@ -1347,6 +1350,7 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
       
       // Check for a successful response
       if (response.status >= 200 && response.status <= 299) {
+        await saveValueInAsync(ASYNC_KEYS.SYSTEM_INFO_SENT, 'true');
         verboseLog('System info sent successfully');
       } else {
         verboseLog(`Failed to send system info with status code: ${response.status}`);
@@ -1367,7 +1371,7 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
     return isValidCharacters && referringLink.length >= 3 && referringLink.length <= 25;
   };
 
-  const checkAffiliateExists = async (affiliateCode: string): Promise<boolean> => {
+  const checkAffiliateExists = async (affiliateCode: string, trackUsage: boolean = false): Promise<boolean> => {
     try {
       const activeCompanyCode = await getActiveCompanyCode();
       if (!activeCompanyCode) {
@@ -1376,11 +1380,15 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
       }
 
       const url = 'https://api.insertaffiliate.com/V1/checkAffiliateExists';
-      const payload = {
+      const payload: Record<string, any> = {
         companyId: activeCompanyCode,
         affiliateCode: affiliateCode
       };
 
+      if (trackUsage) {
+        payload.trackUsage = true;
+      }
+
       verboseLog(`Checking if affiliate exists: ${affiliateCode}`);
 
       const response = await axios.post(url, payload, {
@@ -1463,7 +1471,7 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
     isShortCode(capitalisedShortCode);
 
     // Check if the affiliate exists before storing
-    const exists = await checkAffiliateExists(capitalisedShortCode);
+    const exists = await checkAffiliateExists(capitalisedShortCode, true);
 
     if (exists) {
       // If affiliate exists, set the Insert Affiliate Identifier