@influto/react-native-sdk 1.1.0 → 1.2.0

package/src/InfluTo.ts

@@ -28,7 +28,9 @@ import type {
   AttributionResult,
   Campaign,
   TrackEventOptions,
-  DeviceInfo
+  DeviceInfo,
+  CodeValidationResult,
+  SetCodeResult
 } from './types';
 
 const STORAGE_PREFIX = '@influto/';
@@ -256,6 +258,202 @@ class InfluToSDK {
     return await AsyncStorage.getItem(STORAGE_KEYS.REFERRAL_CODE);
   }
 
+  /**
+   * Get prefilled referral code (if user came via attribution link)
+   *
+   * Use this to pre-fill a promo code input field
+   *
+   * @returns Referral code if attribution exists, null otherwise
+   */
+  async getPrefilledCode(): Promise<string | null> {
+    const attribution = await AsyncStorage.getItem(STORAGE_KEYS.ATTRIBUTION);
+
+    if (attribution) {
+      const parsed = JSON.parse(attribution);
+      return parsed.attributed ? parsed.referralCode : null;
+    }
+
+    return null;
+  }
+
+  /**
+   * Validate a referral/promo code
+   *
+   * Check if a code is valid without applying it.
+   * Use this when user manually enters a code in your app.
+   *
+   * @param code - The referral code to validate
+   * @returns Validation result with campaign info if valid
+   *
+   * @example
+   * ```typescript
+   * const result = await InfluTo.validateCode('FITGURU30');
+   *
+   * if (result.valid) {
+   *   console.log('Campaign:', result.campaign.name);
+   *   console.log('Commission:', result.campaign.commission_percentage + '%');
+   *   // Show custom offer based on campaign
+   * } else {
+   *   console.log('Invalid code:', result.error);
+   * }
+   * ```
+   */
+  async validateCode(code: string): Promise<CodeValidationResult> {
+    if (!this.isInitialized) {
+      return {
+        valid: false,
+        error: 'SDK not initialized',
+        error_code: 'NETWORK_ERROR'
+      };
+    }
+
+    try {
+      const response = await this.apiRequest('/sdk/validate-code', {
+        method: 'POST',
+        body: JSON.stringify({ code: code.trim().toUpperCase() })
+      });
+
+      return response as CodeValidationResult;
+    } catch (error) {
+      if (this.config?.debug) {
+        console.error('[InfluTo] Code validation failed:', error);
+      }
+
+      return {
+        valid: false,
+        error: 'Network error or invalid response',
+        error_code: 'NETWORK_ERROR'
+      };
+    }
+  }
+
+  /**
+   * Manually set a referral code
+   *
+   * Use this when user enters a promo code manually (not from link click).
+   * This will:
+   * 1. Store the code locally
+   * 2. Set it in RevenueCat attributes automatically
+   * 3. Record the attribution with backend
+   *
+   * @param code - The referral code to set
+   * @param appUserId - Optional user ID (if available)
+   * @returns Result with success status
+   *
+   * @example
+   * ```typescript
+   * // User enters code manually
+   * const result = await InfluTo.setReferralCode('FITGURU30');
+   *
+   * if (result.success) {
+   *   console.log('Code applied successfully');
+   *   // Show appropriate paywall/offer
+   * }
+   * ```
+   */
+  async setReferralCode(code: string, appUserId?: string): Promise<SetCodeResult> {
+    if (!this.isInitialized) {
+      return {
+        success: false,
+        message: 'SDK not initialized'
+      };
+    }
+
+    const normalizedCode = code.trim().toUpperCase();
+
+    try {
+      // Store locally
+      await AsyncStorage.setItem(STORAGE_KEYS.REFERRAL_CODE, normalizedCode);
+
+      // Store attribution record
+      const attribution: AttributionResult = {
+        attributed: true,
+        referralCode: normalizedCode,
+        attributionMethod: 'manual_entry',
+        clickedAt: new Date().toISOString(),
+        message: 'Manually entered code'
+      };
+      await AsyncStorage.setItem(STORAGE_KEYS.ATTRIBUTION, JSON.stringify(attribution));
+
+      // Set in RevenueCat automatically
+      try {
+        const Purchases = require('react-native-purchases').default;
+        if (Purchases && Purchases.setAttributes) {
+          await Purchases.setAttributes({
+            referral_code: normalizedCode
+          });
+
+          if (this.config?.debug) {
+            console.log('[InfluTo] ✅ Referral code set in RevenueCat');
+          }
+        }
+      } catch (e) {
+        if (this.config?.debug) {
+          console.warn('[InfluTo] RevenueCat not available - set manually');
+        }
+      }
+
+      // Record with backend
+      const response = await this.apiRequest('/sdk/set-referral-code', {
+        method: 'POST',
+        body: JSON.stringify({
+          code: normalizedCode,
+          app_user_id: appUserId
+        })
+      });
+
+      return response as SetCodeResult;
+    } catch (error) {
+      if (this.config?.debug) {
+        console.error('[InfluTo] Failed to set referral code:', error);
+      }
+
+      return {
+        success: false,
+        message: 'Failed to set code: ' + (error as Error).message
+      };
+    }
+  }
+
+  /**
+   * Validate and apply a referral code (combined operation)
+   *
+   * This is a convenience method that validates a code and applies it if valid.
+   * Use this for one-step validation + application.
+   *
+   * @param code - The referral code to validate and apply
+   * @param appUserId - Optional user ID
+   * @returns Validation result. If valid, code is automatically applied.
+   *
+   * @example
+   * ```typescript
+   * const result = await InfluTo.applyCode('FITGURU30', userId);
+   *
+   * if (result.valid) {
+   *   // Code validated AND applied automatically
+   *   showCustomOffer(result.campaign);
+   * } else {
+   *   Alert.alert('Invalid Code', result.error);
+   * }
+   * ```
+   */
+  async applyCode(code: string, appUserId?: string): Promise<CodeValidationResult & { applied?: boolean }> {
+    // First validate
+    const validation = await this.validateCode(code);
+
+    if (!validation.valid) {
+      return { ...validation, applied: false };
+    }
+
+    // If valid, apply it
+    const setResult = await this.setReferralCode(code, appUserId);
+
+    return {
+      ...validation,
+      applied: setResult.success
+    };
+  }
+
   /**
    * Clear stored attribution data
    *