@datalyr/react-native 1.5.0 → 1.6.0

package/lib/integrations/tiktok-integration.js

@@ -1,360 +0,0 @@
-/**
- * TikTok Business SDK Integration
- * Uses bundled native iOS SDK for event forwarding and user identification
- */
-import { Platform } from 'react-native';
-import { TikTokNativeBridge, isNativeModuleAvailable } from '../native/DatalyrNativeBridge';
-/**
- * TikTok standard event names (current as of 2025)
- * Note: CompletePayment and SubmitForm are legacy, use Purchase and Lead instead
- */
-const TikTokEvents = {
-    // Commerce events
-    PURCHASE: 'Purchase',
-    ADD_TO_CART: 'AddToCart',
-    ADD_TO_WISHLIST: 'AddToWishlist',
-    INITIATE_CHECKOUT: 'InitiateCheckout',
-    ADD_PAYMENT_INFO: 'AddPaymentInfo',
-    VIEW_CONTENT: 'ViewContent',
-    SEARCH: 'Search',
-    // User events
-    COMPLETE_REGISTRATION: 'CompleteRegistration',
-    SUBSCRIBE: 'Subscribe',
-    START_TRIAL: 'StartTrial',
-    LEAD: 'Lead',
-    CONTACT: 'Contact',
-    // App events
-    DOWNLOAD: 'Download',
-    SCHEDULE: 'Schedule',
-    SUBMIT_APPLICATION: 'SubmitApplication',
-};
-/**
- * TikTok Integration class for handling TikTok Business SDK operations
- * Uses native iOS SDK bundled via CocoaPods (no additional npm packages required)
- */
-export class TikTokIntegration {
-    constructor() {
-        this.config = null;
-        this.initialized = false;
-        this.available = false;
-        this.debug = false;
-    }
-    /**
-     * Initialize TikTok SDK with configuration
-     * Supported on both iOS and Android via native modules
-     */
-    async initialize(config, debug = false) {
-        this.debug = debug;
-        this.config = config;
-        // Only available on iOS and Android via native modules
-        if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
-            this.log('TikTok SDK only available on iOS and Android');
-            return;
-        }
-        this.available = isNativeModuleAvailable();
-        if (!this.available) {
-            this.log('TikTok native module not available');
-            return;
-        }
-        try {
-            const success = await TikTokNativeBridge.initialize(config.appId, config.tiktokAppId, config.accessToken, debug);
-            if (success) {
-                this.initialized = true;
-                this.log(`TikTok SDK initialized with App ID: ${config.tiktokAppId}`);
-            }
-            else {
-                console.warn('[Datalyr/TikTok] TikTok SDK not initialized (accessToken may be missing). Events will still be sent server-side via Datalyr postbacks.');
-            }
-        }
-        catch (error) {
-            console.warn('[Datalyr/TikTok] TikTok SDK init failed. Events will still be sent server-side via Datalyr postbacks.', error);
-        }
-    }
-    /**
-     * Update tracking authorization status (call after ATT prompt)
-     */
-    async updateTrackingAuthorization(enabled) {
-        if (!this.available || !this.initialized)
-            return;
-        try {
-            // TikTok SDK auto-handles ATT, but we track the event
-            if (enabled) {
-                await this.trackEvent('ATTAuthorized');
-            }
-            await TikTokNativeBridge.updateTrackingAuthorization(enabled);
-            this.log(`TikTok ATT status: ${enabled ? 'authorized' : 'not authorized'}`);
-        }
-        catch (error) {
-            this.logError('Failed to update TikTok tracking authorization:', error);
-        }
-    }
-    /**
-     * Log purchase event to TikTok (uses Purchase - TikTok's current standard event)
-     */
-    async logPurchase(value, currency, contentId, contentType, parameters) {
-        var _a;
-        if (!this.available || !this.initialized)
-            return;
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableAppEvents) === false)
-            return;
-        try {
-            const properties = {
-                value,
-                currency,
-                ...parameters,
-            };
-            if (contentId)
-                properties.content_id = contentId;
-            if (contentType)
-                properties.content_type = contentType;
-            await TikTokNativeBridge.trackEvent(TikTokEvents.PURCHASE, undefined, properties);
-            this.log(`TikTok Purchase event logged: ${value} ${currency}`);
-        }
-        catch (error) {
-            this.logError('Failed to log TikTok purchase:', error);
-        }
-    }
-    /**
-     * Log subscription event to TikTok
-     */
-    async logSubscription(value, currency, plan) {
-        var _a;
-        if (!this.available || !this.initialized)
-            return;
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableAppEvents) === false)
-            return;
-        try {
-            const properties = {
-                value,
-                currency,
-            };
-            if (plan) {
-                properties.content_id = plan;
-                properties.content_type = 'subscription';
-            }
-            await TikTokNativeBridge.trackEvent(TikTokEvents.SUBSCRIBE, undefined, properties);
-            this.log(`TikTok subscription event logged: ${value} ${currency}`);
-        }
-        catch (error) {
-            this.logError('Failed to log TikTok subscription:', error);
-        }
-    }
-    /**
-     * Log add to cart event
-     */
-    async logAddToCart(value, currency, contentId, contentType) {
-        var _a;
-        if (!this.available || !this.initialized)
-            return;
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableAppEvents) === false)
-            return;
-        try {
-            const properties = {
-                value,
-                currency,
-            };
-            if (contentId)
-                properties.content_id = contentId;
-            if (contentType)
-                properties.content_type = contentType;
-            await TikTokNativeBridge.trackEvent(TikTokEvents.ADD_TO_CART, undefined, properties);
-            this.log('TikTok add to cart event logged');
-        }
-        catch (error) {
-            this.logError('Failed to log TikTok add to cart:', error);
-        }
-    }
-    /**
-     * Log view content event
-     */
-    async logViewContent(contentId, contentName, contentType) {
-        var _a;
-        if (!this.available || !this.initialized)
-            return;
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableAppEvents) === false)
-            return;
-        try {
-            const properties = {};
-            if (contentId)
-                properties.content_id = contentId;
-            if (contentName)
-                properties.content_name = contentName;
-            if (contentType)
-                properties.content_type = contentType;
-            await TikTokNativeBridge.trackEvent(TikTokEvents.VIEW_CONTENT, undefined, properties);
-            this.log('TikTok view content event logged');
-        }
-        catch (error) {
-            this.logError('Failed to log TikTok view content:', error);
-        }
-    }
-    /**
-     * Log initiate checkout event
-     */
-    async logInitiateCheckout(value, currency, numItems) {
-        var _a;
-        if (!this.available || !this.initialized)
-            return;
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableAppEvents) === false)
-            return;
-        try {
-            const properties = {
-                value,
-                currency,
-            };
-            if (numItems)
-                properties.quantity = numItems;
-            await TikTokNativeBridge.trackEvent(TikTokEvents.INITIATE_CHECKOUT, undefined, properties);
-            this.log('TikTok initiate checkout event logged');
-        }
-        catch (error) {
-            this.logError('Failed to log TikTok initiate checkout:', error);
-        }
-    }
-    /**
-     * Log complete registration event
-     */
-    async logCompleteRegistration(method) {
-        var _a;
-        if (!this.available || !this.initialized)
-            return;
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableAppEvents) === false)
-            return;
-        try {
-            const properties = {};
-            if (method)
-                properties.registration_method = method;
-            await TikTokNativeBridge.trackEvent(TikTokEvents.COMPLETE_REGISTRATION, undefined, properties);
-            this.log('TikTok complete registration event logged');
-        }
-        catch (error) {
-            this.logError('Failed to log TikTok complete registration:', error);
-        }
-    }
-    /**
-     * Log search event
-     */
-    async logSearch(query) {
-        var _a;
-        if (!this.available || !this.initialized)
-            return;
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableAppEvents) === false)
-            return;
-        try {
-            await TikTokNativeBridge.trackEvent(TikTokEvents.SEARCH, undefined, { query });
-            this.log('TikTok search event logged');
-        }
-        catch (error) {
-            this.logError('Failed to log TikTok search:', error);
-        }
-    }
-    /**
-     * Log lead event (uses Lead - current standard, SubmitForm is legacy)
-     */
-    async logLead(value, currency) {
-        var _a;
-        if (!this.available || !this.initialized)
-            return;
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableAppEvents) === false)
-            return;
-        try {
-            const properties = {};
-            if (value !== undefined)
-                properties.value = value;
-            if (currency)
-                properties.currency = currency;
-            await TikTokNativeBridge.trackEvent(TikTokEvents.LEAD, undefined, properties);
-            this.log('TikTok lead event logged');
-        }
-        catch (error) {
-            this.logError('Failed to log TikTok lead:', error);
-        }
-    }
-    /**
-     * Log add payment info event
-     */
-    async logAddPaymentInfo(success) {
-        var _a;
-        if (!this.available || !this.initialized)
-            return;
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableAppEvents) === false)
-            return;
-        try {
-            await TikTokNativeBridge.trackEvent(TikTokEvents.ADD_PAYMENT_INFO, undefined, { success });
-            this.log('TikTok add payment info event logged');
-        }
-        catch (error) {
-            this.logError('Failed to log TikTok add payment info:', error);
-        }
-    }
-    /**
-     * Log custom event to TikTok
-     */
-    async trackEvent(eventName, properties) {
-        var _a;
-        if (!this.available || !this.initialized)
-            return;
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.enableAppEvents) === false)
-            return;
-        try {
-            await TikTokNativeBridge.trackEvent(eventName, undefined, properties || {});
-            this.log(`TikTok event logged: ${eventName}`);
-        }
-        catch (error) {
-            this.logError('Failed to log TikTok event:', error);
-        }
-    }
-    /**
-     * Identify user for improved attribution matching
-     */
-    async identify(email, phone, externalId) {
-        if (!this.available || !this.initialized)
-            return;
-        // Only call identify if we have at least one value
-        if (!email && !phone && !externalId)
-            return;
-        try {
-            await TikTokNativeBridge.identify(externalId, email, phone);
-            this.log('TikTok user identification set');
-        }
-        catch (error) {
-            this.logError('Failed to identify TikTok user:', error);
-        }
-    }
-    /**
-     * Clear user session (call on logout)
-     */
-    async logout() {
-        if (!this.available || !this.initialized)
-            return;
-        try {
-            await TikTokNativeBridge.logout();
-            this.log('TikTok user logged out');
-        }
-        catch (error) {
-            this.logError('Failed to logout TikTok user:', error);
-        }
-    }
-    /**
-     * Check if TikTok SDK is available and initialized
-     */
-    isAvailable() {
-        return this.available && this.initialized;
-    }
-    /**
-     * Check if TikTok SDK native module is installed
-     */
-    isInstalled() {
-        return this.available;
-    }
-    log(message, data) {
-        if (this.debug) {
-            console.log(`[Datalyr/TikTok] ${message}`, data || '');
-        }
-    }
-    logError(message, error) {
-        console.error(`[Datalyr/TikTok] ${message}`, error);
-    }
-}
-// Export singleton instance
-export const tiktokIntegration = new TikTokIntegration();

package/src/integrations/meta-integration.ts

@@ -1,239 +0,0 @@
-/**
- * Meta (Facebook) SDK Integration
- * Uses bundled native iOS SDK for deferred deep linking, event forwarding, and Advanced Matching
- */
-
-import { Platform } from 'react-native';
-import { MetaConfig, DeferredDeepLinkResult } from '../types';
-import { MetaNativeBridge, isNativeModuleAvailable } from '../native/DatalyrNativeBridge';
-
-/**
- * Meta Integration class for handling Facebook SDK operations
- * Uses native iOS SDK bundled via CocoaPods (no additional npm packages required)
- */
-export class MetaIntegration {
-  private config: MetaConfig | null = null;
-  private initialized: boolean = false;
-  private available: boolean = false;
-  private debug: boolean = false;
-  private deferredDeepLinkData: DeferredDeepLinkResult | null = null;
-
-  /**
-   * Initialize Meta SDK with configuration
-   * Supported on both iOS and Android via native modules
-   */
-  async initialize(config: MetaConfig, debug: boolean = false): Promise<void> {
-    this.debug = debug;
-    this.config = config;
-
-    // Only available on iOS and Android via native modules
-    if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
-      this.log('Meta SDK only available on iOS and Android');
-      return;
-    }
-
-    this.available = isNativeModuleAvailable();
-
-    if (!this.available) {
-      this.log('Meta native module not available');
-      return;
-    }
-
-    try {
-      const success = await MetaNativeBridge.initialize(
-        config.appId,
-        config.clientToken,
-        config.advertiserTrackingEnabled ?? false
-      );
-
-      if (success) {
-        this.initialized = true;
-        this.log(`Meta SDK initialized with App ID: ${config.appId}`);
-      }
-    } catch (error) {
-      this.logError('Failed to initialize Meta SDK:', error);
-    }
-  }
-
-  /**
-   * Update tracking authorization status (call after ATT prompt)
-   */
-  async updateTrackingAuthorization(enabled: boolean): Promise<void> {
-    if (!this.available || !this.initialized) return;
-
-    try {
-      await MetaNativeBridge.updateTrackingAuthorization(enabled);
-      this.log(`Meta ATT status updated: ${enabled ? 'authorized' : 'not authorized'}`);
-    } catch (error) {
-      this.logError('Failed to update Meta tracking authorization:', error);
-    }
-  }
-
-  /**
-   * Fetch deferred deep link from Meta SDK
-   * This captures fbclid for installs that went through App Store
-   */
-  async fetchDeferredDeepLink(): Promise<DeferredDeepLinkResult | null> {
-    if (!this.available || !this.initialized) {
-      return null;
-    }
-
-    if (this.config?.enableDeferredDeepLink === false) {
-      return null;
-    }
-
-    try {
-      const url = await MetaNativeBridge.fetchDeferredAppLink();
-
-      if (!url) {
-        this.log('No deferred deep link available from Meta');
-        return null;
-      }
-
-      // Parse the URL for attribution parameters
-      const result = this.parseDeepLinkUrl(url);
-      this.deferredDeepLinkData = result;
-
-      this.log(`Meta deferred deep link fetched: ${url}`);
-      return result;
-    } catch (error) {
-      // This is expected to fail in some scenarios - log but don't treat as error
-      this.log('Could not fetch Meta deferred deep link (may not be available)');
-      return null;
-    }
-  }
-
-  /**
-   * Parse deep link URL to extract attribution parameters
-   */
-  private parseDeepLinkUrl(urlString: string): DeferredDeepLinkResult {
-    const result: DeferredDeepLinkResult = {
-      url: urlString,
-      source: 'meta',
-    };
-
-    try {
-      const url = new URL(urlString);
-      const params = url.searchParams;
-
-      // Extract known parameters
-      if (params.get('fbclid')) result.fbclid = params.get('fbclid')!;
-      if (params.get('utm_source')) result.utmSource = params.get('utm_source')!;
-      if (params.get('utm_medium')) result.utmMedium = params.get('utm_medium')!;
-      if (params.get('utm_campaign')) result.utmCampaign = params.get('utm_campaign')!;
-      if (params.get('utm_content')) result.utmContent = params.get('utm_content')!;
-      if (params.get('utm_term')) result.utmTerm = params.get('utm_term')!;
-      if (params.get('campaign_id')) result.campaignId = params.get('campaign_id')!;
-      if (params.get('adset_id')) result.adsetId = params.get('adset_id')!;
-      if (params.get('ad_id')) result.adId = params.get('ad_id')!;
-    } catch (error) {
-      this.logError('Failed to parse deep link URL:', error);
-    }
-
-    return result;
-  }
-
-  /**
-   * Log purchase event to Meta
-   */
-  async logPurchase(value: number, currency: string, parameters?: Record<string, any>): Promise<void> {
-    if (!this.available || !this.initialized) return;
-    if (this.config?.enableAppEvents === false) return;
-
-    try {
-      await MetaNativeBridge.logPurchase(value, currency, parameters);
-      this.log(`Meta purchase event logged: ${value} ${currency}`);
-    } catch (error) {
-      this.logError('Failed to log Meta purchase:', error);
-    }
-  }
-
-  /**
-   * Log custom event to Meta
-   */
-  async logEvent(eventName: string, valueToSum?: number, parameters?: Record<string, any>): Promise<void> {
-    if (!this.available || !this.initialized) return;
-    if (this.config?.enableAppEvents === false) return;
-
-    try {
-      await MetaNativeBridge.logEvent(eventName, valueToSum, parameters);
-      this.log(`Meta event logged: ${eventName}`);
-    } catch (error) {
-      this.logError('Failed to log Meta event:', error);
-    }
-  }
-
-  /**
-   * Set user data for Advanced Matching (improves conversion attribution)
-   * Note: Meta's Advanced Matching uses these specific fields - externalId is not supported
-   */
-  async setUserData(userData: {
-    email?: string;
-    firstName?: string;
-    lastName?: string;
-    phone?: string;
-    dateOfBirth?: string;
-    gender?: string;
-    city?: string;
-    state?: string;
-    zip?: string;
-    country?: string;
-  }): Promise<void> {
-    if (!this.available || !this.initialized) return;
-
-    try {
-      await MetaNativeBridge.setUserData(userData);
-      this.log('Meta user data set for Advanced Matching');
-    } catch (error) {
-      this.logError('Failed to set Meta user data:', error);
-    }
-  }
-
-  /**
-   * Clear user data (call on logout)
-   */
-  async clearUserData(): Promise<void> {
-    if (!this.available || !this.initialized) return;
-
-    try {
-      await MetaNativeBridge.clearUserData();
-      this.log('Meta user data cleared');
-    } catch (error) {
-      this.logError('Failed to clear Meta user data:', error);
-    }
-  }
-
-  /**
-   * Get cached deferred deep link data
-   */
-  getDeferredDeepLinkData(): DeferredDeepLinkResult | null {
-    return this.deferredDeepLinkData;
-  }
-
-  /**
-   * Check if Meta SDK is available and initialized
-   */
-  isAvailable(): boolean {
-    return this.available && this.initialized;
-  }
-
-  /**
-   * Check if Meta SDK native module is installed
-   */
-  isInstalled(): boolean {
-    return this.available;
-  }
-
-  private log(message: string, data?: any): void {
-    if (this.debug) {
-      console.log(`[Datalyr/Meta] ${message}`, data || '');
-    }
-  }
-
-  private logError(message: string, error: any): void {
-    console.error(`[Datalyr/Meta] ${message}`, error);
-  }
-}
-
-// Export singleton instance
-export const metaIntegration = new MetaIntegration();