@datalyr/react-native 1.5.0 → 1.6.0

package/src/types.ts

@@ -7,29 +7,13 @@ export interface AutoEventConfig {
   sessionTimeoutMs?: number;
 }
 
-// Meta (Facebook) SDK Configuration
-export interface MetaConfig {
-  appId: string;                     // Facebook App ID
-  clientToken?: string;              // Client Token for advanced features
-  enableDeferredDeepLink?: boolean;  // Default: true
-  enableAppEvents?: boolean;         // Default: true
-  advertiserTrackingEnabled?: boolean; // iOS ATT status (auto-detected if not set)
-}
-
-// TikTok SDK Configuration
-export interface TikTokConfig {
-  appId: string;                     // Your App ID (for Datalyr)
-  tiktokAppId: string;               // TikTok App ID
-  accessToken?: string;              // Access Token for Events API
-  enableAppEvents?: boolean;         // Default: true
-}
-
-// Deferred Deep Link Result (from platform SDKs)
+// Deferred Deep Link Result (from Play Install Referrer on Android)
 export interface DeferredDeepLinkResult {
   url?: string;
   source?: string;
   fbclid?: string;
   ttclid?: string;
+  gclid?: string;
   utmSource?: string;
   utmMedium?: string;
   utmCampaign?: string;
@@ -51,8 +35,6 @@ export interface DeferredDeepLinkResult {
  *   enableAutoEvents: true,
  *   enableAttribution: true,
  *   skadTemplate: 'ecommerce',
- *   meta: { appId: 'FB_APP_ID' },
- *   tiktok: { appId: 'APP_ID', tiktokAppId: 'TIKTOK_APP_ID' },
  * });
  * ```
  */
@@ -135,11 +117,6 @@ export interface DatalyrConfig {
   /** SKAdNetwork template for automatic conversion value encoding (iOS only) */
   skadTemplate?: 'ecommerce' | 'gaming' | 'subscription';
 
-  /** Meta (Facebook) SDK Configuration */
-  meta?: MetaConfig;
-
-  /** TikTok SDK Configuration */
-  tiktok?: TikTokConfig;
 }
 // Event Types
 export interface EventData {

package/src/utils-expo.ts

@@ -319,8 +319,8 @@ export const validateEventName = (eventName: string): boolean => {
     return false;
   }
   
-  // Allow letters, numbers, underscores, and hyphens
-  const validPattern = /^[a-zA-Z0-9_-]+$/;
+  // Allow letters, numbers, underscores, hyphens, and $ prefix (for system events like $identify)
+  const validPattern = /^\$?[a-zA-Z0-9_-]+$/;
   return validPattern.test(eventName);
 };
 

package/ios/DatalyrObjCExceptionCatcher.h

@@ -1,14 +0,0 @@
-#import <Foundation/Foundation.h>
-
-NS_ASSUME_NONNULL_BEGIN
-
-/// Catches ObjC NSExceptions (from Meta/TikTok SDKs) and converts them to NSErrors.
-/// Swift's do/try/catch cannot catch NSExceptions — they propagate through Hermes
-/// and cause EXC_BAD_ACCESS (SIGSEGV) crashes.
-@interface DatalyrObjCExceptionCatcher : NSObject
-
-+ (BOOL)tryBlock:(void(NS_NOESCAPE ^)(void))block error:(NSError *_Nullable *_Nullable)error;
-
-@end
-
-NS_ASSUME_NONNULL_END

package/ios/DatalyrObjCExceptionCatcher.m

@@ -1,30 +0,0 @@
-#import "DatalyrObjCExceptionCatcher.h"
-
-@implementation DatalyrObjCExceptionCatcher
-
-+ (BOOL)tryBlock:(void(NS_NOESCAPE ^)(void))block error:(NSError **)error {
-    @try {
-        block();
-        return YES;
-    }
-    @catch (NSException *exception) {
-        if (error) {
-            NSString *description = exception.reason ?: exception.name;
-            NSDictionary *userInfo = @{
-                NSLocalizedDescriptionKey: description,
-                @"ExceptionName": exception.name ?: @"Unknown",
-            };
-            if (exception.userInfo) {
-                NSMutableDictionary *merged = [userInfo mutableCopy];
-                [merged addEntriesFromDictionary:exception.userInfo];
-                userInfo = merged;
-            }
-            *error = [NSError errorWithDomain:@"com.datalyr.objc-exception"
-                                         code:-1
-                                     userInfo:userInfo];
-        }
-        return NO;
-    }
-}
-
-@end

package/lib/integrations/meta-integration.d.ts

@@ -1,77 +0,0 @@
-/**
- * Meta (Facebook) SDK Integration
- * Uses bundled native iOS SDK for deferred deep linking, event forwarding, and Advanced Matching
- */
-import { MetaConfig, DeferredDeepLinkResult } from '../types';
-/**
- * Meta Integration class for handling Facebook SDK operations
- * Uses native iOS SDK bundled via CocoaPods (no additional npm packages required)
- */
-export declare class MetaIntegration {
-    private config;
-    private initialized;
-    private available;
-    private debug;
-    private deferredDeepLinkData;
-    /**
-     * Initialize Meta SDK with configuration
-     * Supported on both iOS and Android via native modules
-     */
-    initialize(config: MetaConfig, debug?: boolean): Promise<void>;
-    /**
-     * Update tracking authorization status (call after ATT prompt)
-     */
-    updateTrackingAuthorization(enabled: boolean): Promise<void>;
-    /**
-     * Fetch deferred deep link from Meta SDK
-     * This captures fbclid for installs that went through App Store
-     */
-    fetchDeferredDeepLink(): Promise<DeferredDeepLinkResult | null>;
-    /**
-     * Parse deep link URL to extract attribution parameters
-     */
-    private parseDeepLinkUrl;
-    /**
-     * Log purchase event to Meta
-     */
-    logPurchase(value: number, currency: string, parameters?: Record<string, any>): Promise<void>;
-    /**
-     * Log custom event to Meta
-     */
-    logEvent(eventName: string, valueToSum?: number, parameters?: Record<string, any>): Promise<void>;
-    /**
-     * Set user data for Advanced Matching (improves conversion attribution)
-     * Note: Meta's Advanced Matching uses these specific fields - externalId is not supported
-     */
-    setUserData(userData: {
-        email?: string;
-        firstName?: string;
-        lastName?: string;
-        phone?: string;
-        dateOfBirth?: string;
-        gender?: string;
-        city?: string;
-        state?: string;
-        zip?: string;
-        country?: string;
-    }): Promise<void>;
-    /**
-     * Clear user data (call on logout)
-     */
-    clearUserData(): Promise<void>;
-    /**
-     * Get cached deferred deep link data
-     */
-    getDeferredDeepLinkData(): DeferredDeepLinkResult | null;
-    /**
-     * Check if Meta SDK is available and initialized
-     */
-    isAvailable(): boolean;
-    /**
-     * Check if Meta SDK native module is installed
-     */
-    isInstalled(): boolean;
-    private log;
-    private logError;
-}
-export declare const metaIntegration: MetaIntegration;

package/lib/integrations/meta-integration.js

@@ -1,219 +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 { 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 {
-    constructor() {
-        this.config = null;
-        this.initialized = false;
-        this.available = false;
-        this.debug = false;
-        this.deferredDeepLinkData = null;
-    }
-    /**
-     * Initialize Meta SDK with configuration
-     * Supported on both iOS and Android via native modules
-     */
-    async initialize(config, debug = false) {
-        var _a;
-        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, (_a = config.advertiserTrackingEnabled) !== null && _a !== void 0 ? _a : 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) {
-        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() {
-        var _a;
-        if (!this.available || !this.initialized) {
-            return null;
-        }
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.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
-     */
-    parseDeepLinkUrl(urlString) {
-        const result = {
-            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, currency, parameters) {
-        var _a;
-        if (!this.available || !this.initialized)
-            return;
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.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, valueToSum, parameters) {
-        var _a;
-        if (!this.available || !this.initialized)
-            return;
-        if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.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) {
-        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() {
-        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() {
-        return this.deferredDeepLinkData;
-    }
-    /**
-     * Check if Meta SDK is available and initialized
-     */
-    isAvailable() {
-        return this.available && this.initialized;
-    }
-    /**
-     * Check if Meta SDK native module is installed
-     */
-    isInstalled() {
-        return this.available;
-    }
-    log(message, data) {
-        if (this.debug) {
-            console.log(`[Datalyr/Meta] ${message}`, data || '');
-        }
-    }
-    logError(message, error) {
-        console.error(`[Datalyr/Meta] ${message}`, error);
-    }
-}
-// Export singleton instance
-export const metaIntegration = new MetaIntegration();

package/lib/integrations/tiktok-integration.d.ts

@@ -1,83 +0,0 @@
-/**
- * TikTok Business SDK Integration
- * Uses bundled native iOS SDK for event forwarding and user identification
- */
-import { TikTokConfig } from '../types';
-/**
- * TikTok Integration class for handling TikTok Business SDK operations
- * Uses native iOS SDK bundled via CocoaPods (no additional npm packages required)
- */
-export declare class TikTokIntegration {
-    private config;
-    private initialized;
-    private available;
-    private debug;
-    /**
-     * Initialize TikTok SDK with configuration
-     * Supported on both iOS and Android via native modules
-     */
-    initialize(config: TikTokConfig, debug?: boolean): Promise<void>;
-    /**
-     * Update tracking authorization status (call after ATT prompt)
-     */
-    updateTrackingAuthorization(enabled: boolean): Promise<void>;
-    /**
-     * Log purchase event to TikTok (uses Purchase - TikTok's current standard event)
-     */
-    logPurchase(value: number, currency: string, contentId?: string, contentType?: string, parameters?: Record<string, any>): Promise<void>;
-    /**
-     * Log subscription event to TikTok
-     */
-    logSubscription(value: number, currency: string, plan?: string): Promise<void>;
-    /**
-     * Log add to cart event
-     */
-    logAddToCart(value: number, currency: string, contentId?: string, contentType?: string): Promise<void>;
-    /**
-     * Log view content event
-     */
-    logViewContent(contentId?: string, contentName?: string, contentType?: string): Promise<void>;
-    /**
-     * Log initiate checkout event
-     */
-    logInitiateCheckout(value: number, currency: string, numItems?: number): Promise<void>;
-    /**
-     * Log complete registration event
-     */
-    logCompleteRegistration(method?: string): Promise<void>;
-    /**
-     * Log search event
-     */
-    logSearch(query: string): Promise<void>;
-    /**
-     * Log lead event (uses Lead - current standard, SubmitForm is legacy)
-     */
-    logLead(value?: number, currency?: string): Promise<void>;
-    /**
-     * Log add payment info event
-     */
-    logAddPaymentInfo(success: boolean): Promise<void>;
-    /**
-     * Log custom event to TikTok
-     */
-    trackEvent(eventName: string, properties?: Record<string, any>): Promise<void>;
-    /**
-     * Identify user for improved attribution matching
-     */
-    identify(email?: string, phone?: string, externalId?: string): Promise<void>;
-    /**
-     * Clear user session (call on logout)
-     */
-    logout(): Promise<void>;
-    /**
-     * Check if TikTok SDK is available and initialized
-     */
-    isAvailable(): boolean;
-    /**
-     * Check if TikTok SDK native module is installed
-     */
-    isInstalled(): boolean;
-    private log;
-    private logError;
-}
-export declare const tiktokIntegration: TikTokIntegration;