@influto/react-native-sdk 1.0.0 → 1.2.0

package/README.md

@@ -234,11 +234,59 @@ if (attribution.attributed) {
 - Make sure you call `identifyUser()` after user completes onboarding
 - Verify user ID matches what RevenueCat sends in webhooks
 
+## Promo Code Integration
+
+InfluTo supports **manual promo code entry** for users who hear about codes via social media, podcasts, or word-of-mouth.
+
+### Quick Example (Pre-built UI)
+
+```typescript
+import { ReferralCodeInput } from '@influto/react-native-sdk/ui';
+
+<ReferralCodeInput
+  onValidated={(result) => {
+    if (result.valid) {
+      navigation.navigate('Paywall');
+    }
+  }}
+  onSkip={() => navigation.navigate('Paywall')}
+/>
+```
+
+### Quick Example (Headless)
+
+```typescript
+import InfluTo from '@influto/react-native-sdk';
+
+// User enters code
+const result = await InfluTo.applyCode('FITGURU30', userId);
+
+if (result.valid && result.applied) {
+  // Code is validated AND set in RevenueCat automatically
+  showPaywall(result.campaign);
+}
+```
+
+**📚 [Complete Promo Code Guide](./PROMO_CODES.md)** - Examples, customization, best practices
+
+---
+
+## New in v1.1.0
+
+✅ **Manual promo code entry** - Users can type codes in your app
+✅ **Pre-built UI component** - `<ReferralCodeInput />` with full customization
+✅ **Headless API** - Build your own UI with `validateCode()`, `setReferralCode()`, `applyCode()`
+✅ **Auto-prefill** - Automatically fills code if user came via link
+✅ **Custom callbacks** - React to validation results
+✅ **Full internationalization** - Customize all labels and messages
+
+---
+
 ## Support
 
 - **Documentation:** https://docs.influ.to
-- **Email:** support@influ.to
-- **Discord:** https://discord.gg/influto
+- **Help Center:** https://influ.to/help
+- **Email:** hello@influ.to
 
 ## License
 

package/lib/InfluTo.d.ts

@@ -20,7 +20,7 @@
  * }
  * ```
  */
-import type { InfluToConfig, AttributionResult, Campaign, TrackEventOptions } from './types';
+import type { InfluToConfig, AttributionResult, Campaign, TrackEventOptions, CodeValidationResult, SetCodeResult } from './types';
 declare class InfluToSDK {
     private config;
     private apiUrl;
@@ -62,6 +62,87 @@ declare class InfluToSDK {
      * Get stored referral code (if any)
      */
     getReferralCode(): Promise<string | null>;
+    /**
+     * 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
+     */
+    getPrefilledCode(): Promise<string | 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);
+     * }
+     * ```
+     */
+    validateCode(code: string): Promise<CodeValidationResult>;
+    /**
+     * 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
+     * }
+     * ```
+     */
+    setReferralCode(code: string, appUserId?: string): Promise<SetCodeResult>;
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    applyCode(code: string, appUserId?: string): Promise<CodeValidationResult & {
+        applied?: boolean;
+    }>;
     /**
      * Clear stored attribution data
      *

package/lib/InfluTo.js

@@ -37,7 +37,7 @@ const STORAGE_KEYS = {
 class InfluToSDK {
     constructor() {
         this.config = null;
-        this.apiUrl = 'https://api.influ.to/api';
+        this.apiUrl = 'https://influ.to/api';
         this.isInitialized = false;
     }
     /**
@@ -117,6 +117,25 @@ class InfluToSDK {
                 // Store for future use
                 await async_storage_1.default.setItem(STORAGE_KEYS.ATTRIBUTION, JSON.stringify(attribution));
                 await async_storage_1.default.setItem(STORAGE_KEYS.REFERRAL_CODE, response.referral_code);
+                // 🎯 AUTO-INTEGRATION: Set RevenueCat attribute if available
+                try {
+                    // @ts-ignore - RevenueCat might not be installed
+                    const Purchases = require('react-native-purchases').default;
+                    if (Purchases && Purchases.setAttributes) {
+                        await Purchases.setAttributes({
+                            referral_code: response.referral_code
+                        });
+                        if (this.config?.debug) {
+                            console.log('[InfluTo] ✅ Referral code set in RevenueCat automatically');
+                        }
+                    }
+                }
+                catch (e) {
+                    // RevenueCat not installed - that's okay, developer can set manually
+                    if (this.config?.debug) {
+                        console.log('[InfluTo] RevenueCat not found - set referral_code manually');
+                    }
+                }
                 if (this.config?.debug) {
                     console.log('[InfluTo] ✅ Attribution found:', response.referral_code);
                 }
@@ -214,6 +233,185 @@ class InfluToSDK {
     async getReferralCode() {
         return await async_storage_1.default.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() {
+        const attribution = await async_storage_1.default.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) {
+        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;
+        }
+        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, appUserId) {
+        if (!this.isInitialized) {
+            return {
+                success: false,
+                message: 'SDK not initialized'
+            };
+        }
+        const normalizedCode = code.trim().toUpperCase();
+        try {
+            // Store locally
+            await async_storage_1.default.setItem(STORAGE_KEYS.REFERRAL_CODE, normalizedCode);
+            // Store attribution record
+            const attribution = {
+                attributed: true,
+                referralCode: normalizedCode,
+                attributionMethod: 'manual_entry',
+                clickedAt: new Date().toISOString(),
+                message: 'Manually entered code'
+            };
+            await async_storage_1.default.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;
+        }
+        catch (error) {
+            if (this.config?.debug) {
+                console.error('[InfluTo] Failed to set referral code:', error);
+            }
+            return {
+                success: false,
+                message: 'Failed to set code: ' + 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, appUserId) {
+        // 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
      *

package/lib/components/ReferralCodeInput.d.ts

@@ -0,0 +1,125 @@
+/**
+ * ReferralCodeInput - Pre-built UI component for promo code entry
+ *
+ * Features:
+ * - Auto-prefills if user came via attribution link
+ * - Real-time validation
+ * - Customizable styling (colors, fonts, spacing)
+ * - Loading & success/error states
+ * - Optional skip button
+ * - Callback on validation
+ * - Fully accessible
+ *
+ * @example
+ * ```typescript
+ * import { ReferralCodeInput } from '@influto/react-native-sdk/ui';
+ *
+ * <ReferralCodeInput
+ *   onValidated={(result) => {
+ *     if (result.valid) {
+ *       navigation.navigate('Paywall', { campaign: result.campaign });
+ *     }
+ *   }}
+ *   onSkip={() => navigation.navigate('Paywall')}
+ * />
+ * ```
+ */
+import React from 'react';
+import { ViewStyle, TextStyle } from 'react-native';
+import type { CodeValidationResult } from '../types';
+export interface ReferralCodeInputProps {
+    /**
+     * Auto-prefill code if user came via attribution link
+     * @default true
+     */
+    autoPrefill?: boolean;
+    /**
+     * Auto-validate code on mount (if prefilled)
+     * @default false
+     */
+    autoValidate?: boolean;
+    /**
+     * Callback when code is validated (valid or invalid)
+     */
+    onValidated?: (result: CodeValidationResult) => void;
+    /**
+     * Callback when user skips code entry
+     */
+    onSkip?: () => void;
+    /**
+     * Callback when code is successfully applied
+     */
+    onApplied?: (result: CodeValidationResult) => void;
+    /**
+     * App user ID (if available) - used for attribution tracking
+     */
+    appUserId?: string;
+    /**
+     * Custom color scheme
+     */
+    colors?: {
+        primary?: string;
+        success?: string;
+        error?: string;
+        text?: string;
+        textSecondary?: string;
+        background?: string;
+        border?: string;
+        inputBackground?: string;
+    };
+    /**
+     * Custom fonts
+     */
+    fonts?: {
+        family?: string;
+        sizeTitle?: number;
+        sizeInput?: number;
+        sizeButton?: number;
+        sizeMessage?: number;
+    };
+    /**
+     * Custom text labels (for internationalization)
+     */
+    labels?: {
+        title?: string;
+        subtitle?: string;
+        placeholder?: string;
+        validateButton?: string;
+        skipButton?: string;
+        validatingMessage?: string;
+        validMessage?: string;
+        invalidMessage?: string;
+        errorMessage?: string;
+        prefilledMessage?: string;
+    };
+    /**
+     * Custom styles for fine-grained control
+     */
+    style?: {
+        container?: ViewStyle;
+        titleContainer?: ViewStyle;
+        title?: TextStyle;
+        subtitle?: TextStyle;
+        inputContainer?: ViewStyle;
+        input?: TextStyle;
+        buttonContainer?: ViewStyle;
+        validateButton?: ViewStyle;
+        validateButtonText?: TextStyle;
+        skipButton?: ViewStyle;
+        skipButtonText?: TextStyle;
+        messageContainer?: ViewStyle;
+        messageText?: TextStyle;
+    };
+    /**
+     * Show skip button
+     * @default true
+     */
+    showSkipButton?: boolean;
+    /**
+     * Validate on blur (when user leaves input)
+     * @default true
+     */
+    validateOnBlur?: boolean;
+}
+export declare const ReferralCodeInput: React.FC<ReferralCodeInputProps>;
+export default ReferralCodeInput;