@datalyr/react-native 1.5.0 → 1.6.1

package/src/native/DatalyrNativeBridge.ts

@@ -1,10 +1,12 @@
 /**
- * Native Bridge for Meta, TikTok, Apple Search Ads, and Play Install Referrer
- * Uses bundled native modules instead of separate npm packages
+ * Native Bridge for Apple Search Ads, Play Install Referrer, and Advertiser Info
+ *
+ * Conversion event routing to ad platforms (Meta, TikTok, Google) is handled
+ * server-side via the postback system — no client-side ad SDKs needed.
  *
  * Supported Platforms:
- * - iOS: Meta SDK, TikTok SDK, Apple Search Ads (AdServices)
- * - Android: Meta SDK, TikTok SDK, Play Install Referrer
+ * - iOS: Apple Search Ads (AdServices), IDFA/ATT
+ * - Android: Play Install Referrer, GAID
  */
 
 import { NativeModules, Platform } from 'react-native';
@@ -48,48 +50,6 @@ export interface PlayInstallReferrerData {
 }
 
 interface DatalyrNativeModule {
-  // Meta SDK Methods
-  initializeMetaSDK(
-    appId: string,
-    clientToken: string | null,
-    advertiserTrackingEnabled: boolean
-  ): Promise<boolean>;
-  fetchDeferredAppLink(): Promise<string | null>;
-  logMetaEvent(
-    eventName: string,
-    valueToSum: number | null,
-    parameters: Record<string, any> | null
-  ): Promise<boolean>;
-  logMetaPurchase(
-    amount: number,
-    currency: string,
-    parameters: Record<string, any> | null
-  ): Promise<boolean>;
-  setMetaUserData(userData: Record<string, string | undefined>): Promise<boolean>;
-  clearMetaUserData(): Promise<boolean>;
-  updateMetaTrackingAuthorization(enabled: boolean): Promise<boolean>;
-
-  // TikTok SDK Methods
-  initializeTikTokSDK(
-    appId: string,
-    tiktokAppId: string,
-    accessToken: string | null,
-    debug: boolean
-  ): Promise<boolean>;
-  trackTikTokEvent(
-    eventName: string,
-    eventId: string | null,
-    properties: Record<string, any> | null
-  ): Promise<boolean>;
-  identifyTikTokUser(
-    externalId: string,
-    externalUserName: string,
-    phoneNumber: string,
-    email: string
-  ): Promise<boolean>;
-  logoutTikTok(): Promise<boolean>;
-  updateTikTokTrackingAuthorization(enabled: boolean): Promise<boolean>;
-
   // Advertiser Info (IDFA, IDFV, GAID, ATT Status)
   getAdvertiserInfo(): Promise<{
     idfa?: string;
@@ -104,8 +64,6 @@ interface DatalyrNativeModule {
 
   // SDK Availability
   getSDKAvailability(): Promise<{
-    meta: boolean;
-    tiktok: boolean;
     appleSearchAds: boolean;
     playInstallReferrer?: boolean;
   }>;
@@ -146,14 +104,10 @@ export const isNativeModuleAvailable = (): boolean => {
  * Get SDK availability status for all platforms
  */
 export const getSDKAvailability = async (): Promise<{
-  meta: boolean;
-  tiktok: boolean;
   appleSearchAds: boolean;
   playInstallReferrer: boolean;
 }> => {
   const defaultAvailability = {
-    meta: false,
-    tiktok: false,
     appleSearchAds: false,
     playInstallReferrer: false,
   };
@@ -174,195 +128,6 @@ export const getSDKAvailability = async (): Promise<{
   }
 };
 
-// MARK: - Meta SDK Bridge
-
-export const MetaNativeBridge = {
-  async initialize(
-    appId: string,
-    clientToken?: string,
-    advertiserTrackingEnabled: boolean = false
-  ): Promise<boolean> {
-    if (!DatalyrNative) return false;
-
-    try {
-      return await DatalyrNative.initializeMetaSDK(
-        appId,
-        clientToken || null,
-        advertiserTrackingEnabled
-      );
-    } catch (error) {
-      console.error('[Datalyr/MetaNative] Initialize failed:', error);
-      return false;
-    }
-  },
-
-  async fetchDeferredAppLink(): Promise<string | null> {
-    if (!DatalyrNative) return null;
-
-    try {
-      return await DatalyrNative.fetchDeferredAppLink();
-    } catch {
-      return null;
-    }
-  },
-
-  async logEvent(
-    eventName: string,
-    valueToSum?: number,
-    parameters?: Record<string, any>
-  ): Promise<boolean> {
-    if (!DatalyrNative) return false;
-
-    try {
-      return await DatalyrNative.logMetaEvent(
-        eventName,
-        valueToSum ?? null,
-        parameters || null
-      );
-    } catch (error) {
-      console.error('[Datalyr/MetaNative] Log event failed:', error);
-      return false;
-    }
-  },
-
-  async logPurchase(
-    amount: number,
-    currency: string,
-    parameters?: Record<string, any>
-  ): Promise<boolean> {
-    if (!DatalyrNative) return false;
-
-    try {
-      return await DatalyrNative.logMetaPurchase(amount, currency, parameters || null);
-    } catch (error) {
-      console.error('[Datalyr/MetaNative] Log purchase failed:', error);
-      return false;
-    }
-  },
-
-  async setUserData(userData: Record<string, string | undefined>): Promise<boolean> {
-    if (!DatalyrNative) return false;
-
-    try {
-      return await DatalyrNative.setMetaUserData(userData);
-    } catch (error) {
-      console.error('[Datalyr/MetaNative] Set user data failed:', error);
-      return false;
-    }
-  },
-
-  async clearUserData(): Promise<boolean> {
-    if (!DatalyrNative) return false;
-
-    try {
-      return await DatalyrNative.clearMetaUserData();
-    } catch (error) {
-      console.error('[Datalyr/MetaNative] Clear user data failed:', error);
-      return false;
-    }
-  },
-
-  async updateTrackingAuthorization(enabled: boolean): Promise<boolean> {
-    if (!DatalyrNative) return false;
-
-    try {
-      return await DatalyrNative.updateMetaTrackingAuthorization(enabled);
-    } catch (error) {
-      console.error('[Datalyr/MetaNative] Update tracking failed:', error);
-      return false;
-    }
-  },
-};
-
-// MARK: - TikTok SDK Bridge
-
-export const TikTokNativeBridge = {
-  async initialize(
-    appId: string,
-    tiktokAppId: string,
-    accessToken?: string,
-    debug: boolean = false
-  ): Promise<boolean> {
-    if (!DatalyrNative) return false;
-
-    try {
-      return await DatalyrNative.initializeTikTokSDK(
-        appId,
-        tiktokAppId,
-        accessToken || null,
-        debug
-      );
-    } catch (error) {
-      console.error('[Datalyr/TikTokNative] Initialize failed:', error);
-      return false;
-    }
-  },
-
-  async trackEvent(
-    eventName: string,
-    eventId?: string,
-    properties?: Record<string, any>
-  ): Promise<boolean> {
-    if (!DatalyrNative) return false;
-
-    try {
-      return await DatalyrNative.trackTikTokEvent(
-        eventName,
-        eventId || null,
-        properties || null
-      );
-    } catch (error) {
-      console.error('[Datalyr/TikTokNative] Track event failed:', error);
-      return false;
-    }
-  },
-
-  async identify(
-    externalId?: string,
-    email?: string,
-    phone?: string
-  ): Promise<boolean> {
-    if (!DatalyrNative) return false;
-
-    // Only call if we have at least one value
-    if (!externalId && !email && !phone) return false;
-
-    try {
-      return await DatalyrNative.identifyTikTokUser(
-        externalId || '',
-        '', // externalUserName - not typically available
-        phone || '',
-        email || ''
-      );
-    } catch (error) {
-      console.error('[Datalyr/TikTokNative] Identify failed:', error);
-      return false;
-    }
-  },
-
-  async logout(): Promise<boolean> {
-    if (!DatalyrNative) return false;
-
-    try {
-      return await DatalyrNative.logoutTikTok();
-    } catch (error) {
-      console.error('[Datalyr/TikTokNative] Logout failed:', error);
-      return false;
-    }
-  },
-
-  async updateTrackingAuthorization(enabled: boolean): Promise<boolean> {
-    if (!DatalyrNative) return false;
-
-    try {
-      return await DatalyrNative.updateTikTokTrackingAuthorization(enabled);
-    } catch (error) {
-      console.error('[Datalyr/TikTokNative] Update tracking failed:', error);
-      return false;
-    }
-  },
-};
-
 // MARK: - Apple Search Ads Bridge (iOS only)
 
 export const AppleSearchAdsNativeBridge = {

package/src/native/index.ts

@@ -6,8 +6,6 @@ export { SKAdNetworkBridge } from './SKAdNetworkBridge';
 export {
   isNativeModuleAvailable,
   getSDKAvailability,
-  MetaNativeBridge,
-  TikTokNativeBridge,
   AdvertiserInfoBridge,
 } from './DatalyrNativeBridge';
 export type { AdvertiserInfo } from './DatalyrNativeBridge';

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 {
@@ -250,4 +227,12 @@ export interface AttributionData {
   content?: string;
   clickId?: string;
   installTime?: string;
-} 
+}
+
+// Third-Party Integration Attributes
+
+/** Flat dictionary for Superwall's setUserAttributes() */
+export type SuperwallAttributes = Record<string, string>;
+
+/** Flat dictionary for RevenueCat's Purchases.setAttributes() */
+export type RevenueCatAttributes = Record<string, string>;

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;