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

package/dist/DeepLinkIapProvider.js

@@ -1182,7 +1182,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 +1194,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 +1270,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.13.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

@@ -1367,7 +1367,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 +1376,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 +1467,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