@datalyr/react-native 1.0.3 → 1.0.5

package/EXPO_INSTALL.md

@@ -1,15 +1,14 @@
 # Datalyr Expo SDK - Installation Guide
 
-## 🎯 Expo Compatibility Overview
+## Expo Compatibility
 
-**✅ Works with Expo:** The Datalyr SDK can be used with Expo, but requires some adjustments for the **managed workflow**.
+The Datalyr SDK works with all Expo workflows:
 
-**📱 Expo Workflow Compatibility:**
-- ✅ **Expo Bare Workflow** - Full compatibility (use regular React Native SDK)
-- ✅ **Expo Managed Workflow** - Requires Expo-specific version (this guide)
-- ❌ **Expo Go** - Limited compatibility due to native dependencies
+- **Expo Bare Workflow** - Full compatibility (use regular React Native SDK)
+- **Expo Managed Workflow** - Requires Expo-specific setup (this guide)
+- **Expo Go** - Limited compatibility due to native dependencies
 
-## 🚀 Quick Setup for Expo Managed Workflow
+## Quick Setup for Expo Managed Workflow
 
 ### 1. Install Expo Dependencies
 
@@ -131,7 +130,7 @@ const App: React.FC = () => {
 export default App;
 ```
 
-## 🔧 Expo vs React Native CLI Differences
+## Expo vs React Native CLI Differences
 
 | Feature | React Native CLI | Expo Managed | Expo Bare |
 |---------|------------------|--------------|-----------|
@@ -142,7 +141,7 @@ export default App;
 | Attribution | Full support ✅ | Full support ✅ | Full support ✅ |
 | Auto Events | Full support ✅ | Full support ✅ | Full support ✅ |
 
-## 📱 Expo-Specific Features
+## Expo-Specific Features
 
 ### 1. Device Information
 ```typescript
@@ -186,7 +185,7 @@ const getNetworkType = async () => {
 };
 ```
 
-## 🎯 Attribution Setup for Expo
+## Attribution Setup for Expo
 
 Deep links work the same way, but configuration is in `app.json`:
 
@@ -205,7 +204,7 @@ const tiktokUrl = 'yourappscheme://open?utm_source=tiktok&utm_campaign=viral_vid
 const googleUrl = 'yourappscheme://open?utm_source=google&utm_campaign=brand_search&gclid=google456def';
 ```
 
-## 🧪 Testing with Expo
+## Testing with Expo
 
 ### Development
 ```bash
@@ -228,23 +227,23 @@ eas submit --platform ios
 eas submit --platform android
 ```
 
-## ⚠️ Expo Limitations
+## Expo Limitations
 
-### What Works Fully:
-- ✅ Event tracking and attribution
-- ✅ Session management  
-- ✅ Screen view tracking
-- ✅ App lifecycle events
-- ✅ Deep link attribution
-- ✅ Basic device fingerprinting
+### What Works:
+- Event tracking and attribution
+- Session management  
+- Screen view tracking
+- App lifecycle events
+- Deep link attribution
+- Basic device fingerprinting
 
-### What Has Limitations:
-- ⚠️ **IDFA/GAID Collection** - Requires additional setup with expo-ads-admob
-- ⚠️ **Advanced Device Info** - Some properties not available in managed workflow
-- ⚠️ **Carrier Information** - Not available in managed workflow
-- ⚠️ **Custom Native Modules** - Can't use if staying in managed workflow
+### Limitations:
+- **IDFA/GAID Collection** - Requires additional setup
+- **Advanced Device Info** - Some properties not available in managed workflow
+- **Carrier Information** - Not available in managed workflow
+- **Custom Native Modules** - Not available in managed workflow
 
-## 🚀 Recommended Setup
+## Recommended Setup
 
 ### For Maximum Compatibility:
 1. **Use Expo Bare Workflow** - Get full React Native CLI features
@@ -255,24 +254,24 @@ eas submit --platform android
 2. **Core attribution still works** - LYR tags, UTM params, click IDs
 3. **Automatic events work fully** - Sessions, screen views, app lifecycle
 
-## 📊 Expected Events in Dashboard
+## Expected Events in Dashboard
 
 Events will appear in your Datalyr dashboard with `source: 'mobile_app'`:
 
-**🔥 Automatic Events:**
-- `session_start` - New user session (automatic)
-- `session_end` - Session ended with stats (automatic)  
-- `pageviews` - Screen navigation (automatic)
-- `app_install` - First app launch with attribution (automatic)
-- `app_update` - App version changes (automatic)
-- `app_foreground`/`app_background` - App lifecycle (automatic)
-- `sdk_initialized` - SDK setup complete (automatic)
+**Automatic Events:**
+- `session_start` - New user session
+- `session_end` - Session ended with stats  
+- `pageviews` - Screen navigation
+- `app_install` - First app launch with attribution
+- `app_update` - App version changes
+- `app_foreground`/`app_background` - App lifecycle
+- `sdk_initialized` - SDK setup complete
 
-**📱 Manual Events:**
+**Manual Events:**
 - Custom events from `datalyr.track()`
 - User identification from `datalyr.identify()`
 
-## 🆚 Expo vs React Native CLI Recommendation
+## Choosing Between Expo and React Native CLI
 
 ### Choose **React Native CLI** if:
 - You need full IDFA/GAID support
@@ -293,6 +292,6 @@ Events will appear in your Datalyr dashboard with `source: 'mobile_app'`:
 
 ---
 
-**🎉 Ready to test? Your Expo app with automatic attribution is ready!**
+**Ready to test?** Your Expo app with automatic attribution is ready!
 
-*The SDK provides 90% of the attribution value even with Expo limitations!* 
+The SDK provides 90% of the attribution value even with Expo's managed workflow limitations. 

package/INSTALL.md

@@ -1,33 +1,22 @@
-# Datalyr React Native SDK - Quick Install Guide
+# Datalyr React Native SDK - Installation Guide
 
-## 🎯 Key Features
+## Key Features
 
-- 🚀 **NEW: SKAdNetwork Support** - Compete with AppsFlyer/Adjust at 90% cost savings
-- ✅ **Complete Attribution** - Track users from ad click to conversion
-- ✅ **Automatic Events** - Like Mixpanel (sessions, screen views, app lifecycle)
-- ✅ **Device Fingerprinting** - IDFA/GAID collection with fallback IDs  
-- ✅ **Offline Support** - Queue events when offline, sync when connected
-- ✅ **Session Management** - Automatic session tracking with timeouts
-- ✅ **Deep Link Support** - Extract attribution from app launches
-- ✅ **Privacy Compliant** - GDPR/CCPA support with opt-out options
+- **Complete Attribution** - Track users from ad click to conversion
+- **Automatic Events** - Sessions, screen views, app lifecycle
+- **SKAdNetwork Support** - iOS 14+ attribution
+- **Offline Support** - Queue events when offline
+- **Deep Link Support** - Extract attribution from app launches
+- **Privacy Compliant** - GDPR/CCPA support
 
-## 🚀 Quick Setup (5 minutes)
+## Quick Setup
 
-### 1. Install Dependencies
+### 1. Install Package
 
 ```bash
-# Navigate to your React Native project
-cd your-react-native-app
-
-# Install required dependencies
-npm install @react-native-async-storage/async-storage @react-native-community/netinfo react-native-device-info react-native-get-random-values react-native-idfa uuid
-# or with yarn
-yarn add @react-native-async-storage/async-storage @react-native-community/netinfo react-native-device-info react-native-get-random-values react-native-idfa uuid
-
-# Install dev dependencies
-npm install --save-dev @types/uuid
-# or with yarn  
-yarn add --dev @types/uuid
+npm install @datalyr/react-native
+# or
+yarn add @datalyr/react-native
 ```
 
 ### 2. iOS Setup (if targeting iOS)
@@ -36,19 +25,7 @@ yarn add --dev @types/uuid
 cd ios && pod install && cd ..
 ```
 
-### 3. Add the SDK to Your Project
-
-For now, copy the SDK files directly into your project:
-
-```bash
-# Create SDK directory
-mkdir -p src/datalyr-sdk
-
-# Copy SDK files
-cp -r docs/mobile/react-native/src/* src/datalyr-sdk/
-```
-
-### 4. Initialize in Your App
+### 3. Initialize in Your App
 
 **Basic Setup:**
 ```typescript
@@ -90,7 +67,7 @@ const App: React.FC = () => {
 };
 ```
 
-**🚀 NEW: SKAdNetwork Setup (iOS 14+ Attribution):**
+**SKAdNetwork Setup (iOS 14+ Attribution):**
 ```typescript
 // For iOS attribution competing with AppsFlyer/Adjust
 import React, { useEffect } from 'react';
@@ -148,7 +125,7 @@ const testTracking = async () => {
 };
 ```
 
-## 🔧 Configuration Options
+## Configuration Options
 
 ```typescript
 await datalyr.initialize({
@@ -176,13 +153,13 @@ await datalyr.initialize({
 });
 ```
 
-## 📱 Platform Requirements
+## Platform Requirements
 
 - **React Native**: >= 0.60.0
 - **iOS**: >= 11.0
 - **Android**: >= API level 21
 
-## 🎯 Framework Compatibility
+## Framework Compatibility
 
 | Framework | Compatibility | Install Guide |
 |-----------|---------------|---------------|
@@ -195,7 +172,7 @@ await datalyr.initialize({
 
 **📖 For Expo users:** See [EXPO_INSTALL.md](./EXPO_INSTALL.md) for Expo-specific setup instructions.
 
-## 🎯 Setting Up Attribution
+## Setting Up Attribution
 
 ### 1. Configure Deep Links
 
@@ -267,7 +244,7 @@ Expected output:
 */
 ```
 
-## 🧪 Testing Events
+## Testing Events
 
 After setup, events will appear in your Datalyr dashboard at:
 `https://app.datalyr.com/dashboard/ozLZblQ8hN`
@@ -292,7 +269,7 @@ Look for events with `source: 'mobile_app'` to confirm mobile tracking is workin
 - User identification with `datalyr.identify()`
 - Manual screen views with `datalyr.screen()`
 
-## ⚡ Quick Debugging
+## Debugging
 
 ```typescript
 // Check SDK status
@@ -309,14 +286,14 @@ await datalyr.initialize({
 });
 ```
 
-## 🚨 Common Issues
+## Common Issues
 
 1. **Events not appearing**: Check debug logs and network connectivity
 2. **Build errors**: Ensure all dependencies are installed and linked
 3. **iOS build issues**: Run `cd ios && pod install`
 4. **Android issues**: Check that your minSdkVersion is >= 21
 
-## 🚀 Automatic Events Demo
+## Automatic Events
 
 Want to see all the automatic events in action? Check out `auto-events-example.tsx` for a live demo that shows:
 
@@ -343,7 +320,7 @@ await datalyr.trackRevenue('purchase', {
 await datalyr.endSession();
 ```
 
-## 📚 Next Steps
+## Next Steps
 
 - See `example.tsx` for basic integration example
 - See `auto-events-example.tsx` for automatic events demo
@@ -353,7 +330,7 @@ await datalyr.endSession();
 
 ---
 
-## 🚀 SKAdNetwork Setup (iOS Attribution)
+## SKAdNetwork Setup (iOS Attribution)
 
 ### **1. Add Native Bridge (React Native CLI/Expo Bare)**
 

package/README.md

@@ -1,19 +1,19 @@
 # @datalyr/react-native
 
-Official Datalyr SDK for React Native & Expo - Server-side attribution tracking and analytics.
+Official Datalyr SDK for React Native & Expo - Mobile attribution tracking and analytics.
 
 [![npm version](https://img.shields.io/npm/v/@datalyr/react-native.svg)](https://www.npmjs.com/package/@datalyr/react-native)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ## Features
 
-- 🔒 **Server-side tracking** - Secure API key authentication
+- 🎯 **Complete Attribution** - Track users from ad click to conversion
 - 📱 **React Native & Expo** - Works with both platforms
-- 🎯 **Attribution tracking** - UTM, referrer, and deep links
+- 🔄 **Automatic Events** - Session tracking, screen views, app lifecycle
 - 📊 **SKAdNetwork** - iOS 14+ attribution support
-- 💾 **Offline queue** - Events saved and retried
-- 🔄 **Session management** - Automatic session tracking
-- ⚡ **Performance** - < 100KB, minimal battery impact
+- 💾 **Offline Support** - Events saved and retried when reconnected
+- 🔒 **Privacy First** - GDPR/CCPA compliant
+- ⚡ **Lightweight** - < 100KB, minimal battery impact
 
 ## Installation
 
@@ -23,19 +23,16 @@ npm install @datalyr/react-native
 yarn add @datalyr/react-native
 ```
 
-### Additional Dependencies
-
-For device information and attribution:
-```bash
-npm install react-native-device-info @react-native-async-storage/async-storage
-```
-
 ### iOS Setup
 
 ```bash
 cd ios && pod install
 ```
 
+### Expo Users
+
+See [EXPO_INSTALL.md](./EXPO_INSTALL.md) for Expo-specific setup instructions.
+
 ## Quick Start
 
 ```typescript
@@ -44,9 +41,9 @@ import { Datalyr } from '@datalyr/react-native';
 // Initialize SDK
 await Datalyr.initialize({
   apiKey: 'dk_your_api_key', // Required - get from Datalyr dashboard
-  debug: true, // Enable debug logs
-  enableAutoEvents: true, // Track sessions, app lifecycle
-  enableAttribution: true, // Track attribution data
+  debug: true, // Enable debug logs in development
+  enableAutoEvents: true, // Track sessions, screen views, app lifecycle
+  enableAttribution: true, // Track attribution data from ads
 });
 
 // Track custom event

package/examples/attribution-example.tsx

@@ -16,7 +16,7 @@ import {
   TextInput,
   Linking,
 } from 'react-native';
-import { datalyr } from '@datalyr/react-native-sdk';
+import { datalyr } from '@datalyr/react-native';
 
 const AttributionExample: React.FC = () => {
   const [attributionData, setAttributionData] = useState<any>(null);

package/examples/auto-events-example.tsx

@@ -9,7 +9,7 @@ import {
   AppState,
   SafeAreaView,
 } from 'react-native';
-import { datalyr } from '@datalyr/react-native-sdk';
+import { datalyr } from '@datalyr/react-native';
 
 // This example demonstrates all automatic events (like Mixpanel)
 export default function AutoEventsExample() {

package/examples/example.tsx

@@ -15,7 +15,7 @@ import {
   ScrollView,
   StatusBar,
 } from 'react-native';
-import { datalyr } from '@datalyr/react-native-sdk';
+import { datalyr } from '@datalyr/react-native';
 
 const App: React.FC = () => {
   const [sdkStatus, setSdkStatus] = useState<any>(null);

package/lib/http-client.js

@@ -152,7 +152,8 @@ export class HttpClient {
             },
             context: {
                 library: '@datalyr/react-native',
-                version: '1.0.2',
+                version: '1.0.5',
+                source: 'mobile_app', // Explicitly set source for mobile
                 userProperties: payload.userProperties,
             },
             timestamp: payload.timestamp,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalyr/react-native",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Datalyr SDK for React Native & Expo - Server-side attribution tracking",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/http-client.ts

@@ -197,7 +197,8 @@ export class HttpClient {
       },
       context: {
         library: '@datalyr/react-native',
-        version: '1.0.2',
+        version: '1.0.5',
+        source: 'mobile_app',  // Explicitly set source for mobile
         userProperties: payload.userProperties,
       },
       timestamp: payload.timestamp,

package/DEBUG_WHITE_SCREEN.md

@@ -1,234 +0,0 @@
-# 🐛 Debug White Screen Issue
-
-## Step 1: Check SDK Version
-
-First, verify you're using the latest version:
-
-```bash
-# Check what version is installed
-npm list @datalyr/react-native-sdk
-
-# Update to latest version
-npm install @datalyr/react-native-sdk@1.0.10
-
-# Or with yarn
-yarn add @datalyr/react-native-sdk@1.0.10
-```
-
-## Step 2: Check Import Pattern
-
-Make sure you're using the correct import:
-
-```typescript
-// ✅ CORRECT (v1.0.10+)
-import { datalyr } from '@datalyr/react-native-sdk';
-
-// ❌ WRONG (causes white screen)
-import Datalyr from '@datalyr/react-native-sdk';
-import DatalyrSDK from '@datalyr/react-native-sdk';
-```
-
-## Step 3: Enable Debug Logging
-
-Add debug logging to see what's happening:
-
-```typescript
-import { datalyr } from '@datalyr/react-native-sdk';
-
-const App = () => {
-  useEffect(() => {
-    initializeSDK();
-  }, []);
-
-  const initializeSDK = async () => {
-    try {
-      console.log('🚀 Starting SDK initialization...');
-      
-      await datalyr.initialize({
-        workspaceId: 'your-workspace-id',
-        debug: true,  // Enable debug logs
-        autoEvents: {
-          trackSessions: true,
-          trackScreenViews: true,
-          trackAppUpdates: true,
-          trackPerformance: true,
-        },
-      });
-      
-      console.log('✅ SDK initialized successfully');
-      
-    } catch (error) {
-      console.error('❌ SDK initialization failed:', error);
-      // Don't let SDK errors crash the app
-    }
-  };
-
-  return (
-    <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
-      <Text>App is working!</Text>
-    </View>
-  );
-};
-```
-
-## Step 4: Check Metro/React Native Logs
-
-Run your app and check the logs:
-
-```bash
-# For React Native CLI
-npx react-native run-ios --verbose
-# or
-npx react-native run-android --verbose
-
-# For Expo
-expo start --clear
-```
-
-Look for errors like:
-- `TypeError: Cannot read property 'initialize' of undefined`
-- `ReferenceError: datalyr is not defined`
-- Any red error messages
-
-## Step 5: Test with Minimal Setup
-
-Create a minimal test component:
-
-```typescript
-// TestSDK.tsx
-import React, { useEffect, useState } from 'react';
-import { View, Text, Alert } from 'react-native';
-
-// Test 1: Check if import works
-try {
-  const { datalyr } = require('@datalyr/react-native-sdk');
-  console.log('✅ Import successful:', typeof datalyr);
-} catch (error) {
-  console.error('❌ Import failed:', error);
-}
-
-const TestSDK = () => {
-  const [status, setStatus] = useState('Testing...');
-
-  useEffect(() => {
-    testSDK();
-  }, []);
-
-  const testSDK = async () => {
-    try {
-      // Test import
-      const { datalyr } = await import('@datalyr/react-native-sdk');
-      console.log('✅ Dynamic import successful');
-      setStatus('Import OK');
-
-      // Test initialization
-      await datalyr.initialize({
-        workspaceId: 'test-workspace',
-        debug: true,
-      });
-      
-      console.log('✅ SDK initialized');
-      setStatus('SDK Initialized');
-
-    } catch (error) {
-      console.error('❌ Test failed:', error);
-      setStatus(`Error: ${error.message}`);
-      Alert.alert('SDK Test Failed', error.message);
-    }
-  };
-
-  return (
-    <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
-      <Text>SDK Test Status: {status}</Text>
-    </View>
-  );
-};
-
-export default TestSDK;
-```
-
-## Step 6: Check Dependencies
-
-Verify all dependencies are installed:
-
-```bash
-# Check if these are installed
-npm list react-native-get-random-values
-npm list @react-native-async-storage/async-storage
-npm list uuid
-
-# Install if missing
-npm install react-native-get-random-values @react-native-async-storage/async-storage uuid
-```
-
-## Step 7: Platform-Specific Checks
-
-### iOS
-```bash
-cd ios && pod install && cd ..
-npx react-native run-ios --verbose
-```
-
-### Android
-```bash
-npx react-native run-android --verbose
-```
-
-## Step 8: Metro Cache Clear
-
-Clear Metro cache:
-
-```bash
-# React Native CLI
-npx react-native start --reset-cache
-
-# Expo
-expo start --clear
-```
-
-## Step 9: Temporary Workaround
-
-If still having issues, try this temporary workaround:
-
-```typescript
-import React, { useEffect } from 'react';
-import { View, Text } from 'react-native';
-
-const App = () => {
-  useEffect(() => {
-    // Delay SDK initialization to avoid blocking render
-    setTimeout(async () => {
-      try {
-        const { datalyr } = await import('@datalyr/react-native-sdk');
-        await datalyr.initialize({
-          workspaceId: 'your-workspace-id',
-          debug: true,
-        });
-        console.log('✅ SDK initialized with delay');
-      } catch (error) {
-        console.error('❌ SDK error (non-blocking):', error);
-      }
-    }, 1000);
-  }, []);
-
-  return (
-    <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
-      <Text>App is working!</Text>
-    </View>
-  );
-};
-
-export default App;
-```
-
-## Step 10: Check Package.json
-
-Verify your package.json has the correct version:
-
-```json
-{
-  "dependencies": {
-    "@datalyr/react-native-sdk": "^1.0.10"
-  }
-}
-``` 

package/FRAMEWORK_COMPARISON.md

@@ -1,178 +0,0 @@
-# 🎯 React Native CLI vs Expo - SDK Compatibility Guide
-
-## 🔍 Quick Decision Matrix
-
-**Need maximum attribution accuracy?** → **React Native CLI**  
-**Want easier development?** → **Expo Managed Workflow**  
-**Want best of both worlds?** → **Expo Bare Workflow**
-
----
-
-## 📊 Feature Comparison
-
-| Feature | React Native CLI | Expo Managed | Expo Bare |
-|---------|------------------|--------------|-----------|
-| **Setup Complexity** | Medium | Easy | Medium |
-| **Attribution Accuracy** | 100% | 90% | 100% |
-| **IDFA/GAID Collection** | ✅ Full | ⚠️ Limited | ✅ Full |
-| **Auto Events** | ✅ Full | ✅ Full | ✅ Full |
-| **Deep Link Attribution** | ✅ Full | ✅ Full | ✅ Full |
-| **Device Fingerprinting** | ✅ Full | ⚠️ Limited | ✅ Full |
-| **Build/Deploy Ease** | Complex | Easy | Easy |
-| **App Store Submission** | Manual | Automated | Automated |
-| **OTA Updates** | Custom | ✅ Built-in | ✅ Built-in |
-
----
-
-## 🚀 React Native CLI (Recommended for Attribution)
-
-### ✅ **Pros:**
-- **Maximum attribution accuracy** (100%)
-- Full IDFA/GAID support for iOS/Android
-- Complete device fingerprinting
-- Access to all native modules
-- Best performance for tracking
-
-### ❌ **Cons:**
-- More complex setup and configuration
-- Manual build and deployment process
-- Requires native development knowledge
-- No built-in OTA updates
-
-### 🎯 **Best For:**
-- Apps where attribution accuracy is critical
-- Teams comfortable with native development
-- Apps that need custom native functionality
-- Maximum tracking capabilities
-
-### 📋 **Installation:**
-Follow the main [INSTALL.md](./INSTALL.md) guide.
-
----
-
-## 🎨 Expo Managed Workflow
-
-### ✅ **Pros:**
-- **Super easy setup** and development
-- Automatic build and deployment (EAS)
-- Built-in OTA updates
-- No native code complexity
-- Great development experience
-
-### ❌ **Cons:**
-- **Limited IDFA/GAID collection** (needs extra setup)
-- Some device info not available
-- Can't use custom native modules
-- Slightly less attribution accuracy (90%)
-
-### 🎯 **Best For:**
-- Teams prioritizing development speed
-- Apps where core attribution is sufficient
-- First-time React Native developers
-- Rapid prototyping and MVP development
-
-### 📋 **Installation:**
-Follow the [EXPO_INSTALL.md](./EXPO_INSTALL.md) guide.
-
----
-
-## ⚡ Expo Bare Workflow (Best of Both)
-
-### ✅ **Pros:**
-- **Full React Native CLI features**
-- Easy build/deployment with EAS
-- Built-in OTA updates
-- Maximum attribution accuracy (100%)
-- Can eject to full native if needed
-
-### ❌ **Cons:**
-- Slightly more complex than managed workflow
-- Need to manage native dependencies
-- Larger app bundle size
-
-### 🎯 **Best For:**
-- Teams wanting maximum features + easy deployment
-- Apps that might need native modules later
-- Best compromise between power and simplicity
-
-### 📋 **Installation:**
-Follow the main [INSTALL.md](./INSTALL.md) guide (same as React Native CLI).
-
----
-
-## 📱 Attribution Accuracy Breakdown
-
-### **React Native CLI / Expo Bare: 100% Accuracy**
-```typescript
-✅ UTM parameters (utm_source, utm_medium, etc.)
-✅ Click IDs (fbclid, ttclid, gclid)  
-✅ LYR tags (lyr, datalyr, dl_tag)
-✅ IDFA collection (iOS with permission)
-✅ GAID collection (Android)
-✅ Full device fingerprinting
-✅ Carrier information
-✅ Precise device specifications
-```
-
-### **Expo Managed: 90% Accuracy**
-```typescript
-✅ UTM parameters (utm_source, utm_medium, etc.)
-✅ Click IDs (fbclid, ttclid, gclid)
-✅ LYR tags (lyr, datalyr, dl_tag)  
-⚠️ IDFA collection (requires expo-ads-admob setup)
-⚠️ GAID collection (requires expo-ads-admob setup)
-⚠️ Limited device fingerprinting
-❌ Carrier information not available
-⚠️ Basic device specifications
-```
-
-## 🎯 **Recommendation by Use Case**
-
-### **🔥 High-Value Apps (E-commerce, Finance, Gaming)**
-**→ React Native CLI** or **Expo Bare**
-- Need maximum attribution accuracy
-- IDFA/GAID collection critical for ROAS optimization
-- Can justify development complexity
-
-### **📱 Content Apps (News, Social, Productivity)**  
-**→ Expo Managed Workflow**
-- Core attribution (UTM, click IDs) is sufficient
-- Development speed more important
-- Easy deployment and updates preferred
-
-### **🚀 Startups/MVPs**
-**→ Expo Managed Workflow**
-- Ship fast and iterate
-- Core attribution covers most needs
-- Can migrate to bare/CLI later if needed
-
-### **🏢 Enterprise Apps**
-**→ React Native CLI** or **Expo Bare**
-- Need full control and customization
-- Security and compliance requirements
-- Custom native integrations likely
-
----
-
-## 💡 **Migration Path**
-
-**You can always upgrade!**
-
-```
-Expo Managed → Expo Bare → React Native CLI
-    ↓              ↓             ↓
-   Easy          Medium        Complex
-   90%           100%          100%
-```
-
-**Start with Expo Managed if unsure** - you can eject to bare workflow or migrate to React Native CLI when you need more features.
-
----
-
-## 🚀 **Bottom Line**
-
-- **Most apps:** Start with **Expo Managed** (90% attribution accuracy is excellent)
-- **Attribution-critical apps:** Use **React Native CLI** or **Expo Bare**  
-- **Want easy deployment:** Use **Expo Bare** (best compromise)
-
-**All workflows support the automatic events system and core attribution tracking!** 🎉 

package/SDK_COMPLETION_STATUS.md

@@ -1,206 +0,0 @@
-# 📊 Datalyr Mobile SDK - Completion Status
-
-## 🎯 **Is the SDK "Finished"?**
-
-**Short Answer:** The SDK is **functionally complete** for core attribution tracking but needs **automatic events** to be competitive with Mixpanel.
-
-**With Auto-Events Added:** The SDK is now **95% complete** and production-ready! 🚀
-
----
-
-## ✅ **What We Have (Core Attribution SDK)**
-
-### **🔥 Core Features** 
-- ✅ **Event Tracking** (`track()`, `screen()`, `identify()`, `alias()`)
-- ✅ **Attribution System** (LYR tags, UTM params, fbclid, ttclid, gclid)
-- ✅ **Device Fingerprinting** (IDFA/GAID, device info, network detection)
-- ✅ **Offline Support** (Queue with retry logic, exponential backoff)
-- ✅ **Session Management** (30-min timeout, visitor/session IDs)
-- ✅ **Database Integration** (Works with existing Supabase schema)
-- ✅ **Deep Link Attribution** (Install tracking, first-launch detection)
-
-### **🎯 Attribution Features**
-- ✅ **Facebook:** fbclid parameter capture
-- ✅ **TikTok:** ttclid parameter capture  
-- ✅ **Google:** gclid parameter capture
-- ✅ **UTM Parameters:** Full support (source, medium, campaign, etc.)
-- ✅ **LYR Tags:** Custom attribution system (lyr, datalyr, dl_tag)
-- ✅ **Install Detection:** First launch attribution
-- ✅ **Deep Links:** URL parameter extraction
-
-### **📱 Technical Architecture**
-- ✅ **TypeScript:** Full type safety
-- ✅ **React Native:** Cross-platform (iOS/Android)
-- ✅ **Modular Design:** Pluggable components
-- ✅ **Error Handling:** Comprehensive try/catch with logging
-- ✅ **Performance:** Lightweight, non-blocking
-- ✅ **Privacy:** GDPR/CCPA compliant (respectDoNotTrack)
-
----
-
-## 🚀 **What We Added (Auto-Events System)**
-
-### **📊 Automatic Events (Like Mixpanel)**
-- ✅ **Session Tracking** (`session_start`, `session_end`)
-- ✅ **App Lifecycle** (`app_foreground`, `app_background`)
-- ✅ **Screen Views** (Automatic `pageviews` events)
-- ✅ **App Install** (First launch detection)
-- ✅ **App Updates** (Version change detection)
-- ✅ **Performance** (`app_launch_performance`)
-- ✅ **Revenue Events** (Automatic purchase tracking)
-- ✅ **SDK Events** (`sdk_initialized`)
-
-### **🎛️ Auto-Events Configuration**
-```typescript
-autoEvents: {
-  trackSessions: true,         // Session start/end
-  trackScreenViews: true,      // Automatic screen tracking
-  trackAppUpdates: true,       // App version changes
-  trackPerformance: true,      // Launch time tracking
-  sessionTimeoutMs: 30 * 60 * 1000, // 30 minutes
-}
-```
-
-### **📊 Mixpanel Parity**
-| Feature | Mixpanel | Datalyr SDK | Status |
-|---------|----------|-------------|---------|
-| Session Tracking | ✅ | ✅ | **Complete** |
-| Screen Views | ✅ | ✅ | **Complete** |
-| App Install | ✅ | ✅ | **Complete** |
-| App Updates | ✅ | ✅ | **Complete** |
-| App Lifecycle | ✅ | ✅ | **Complete** |
-| Performance | ✅ | ✅ | **Complete** |
-| Revenue Tracking | ✅ | ✅ | **Complete** |
-| Push Notifications | ✅ | ❌ | *Optional* |
-| Crash Tracking | ✅ | ❌ | *Optional* |
-| A/B Testing | ✅ | ❌ | *Not needed* |
-
----
-
-## 📈 **SDK Usage Example**
-
-```typescript
-import { datalyr } from '@datalyr/react-native-sdk';
-
-// Initialize with auto-events
-await datalyr.initialize({
-  workspaceId: 'your-workspace-id',
-  autoEvents: {
-    trackSessions: true,
-    trackScreenViews: true,
-    trackAppUpdates: true,
-    trackPerformance: true,
-  },
-});
-
-// Manual events still work
-await datalyr.track('purchase', { 
-  value: 29.99, 
-  currency: 'USD' 
-});
-
-// Automatic events happen behind the scenes:
-// ✅ session_start (automatic)
-// ✅ app_install (automatic)
-// ✅ pageviews (automatic)
-// ✅ app_foreground (automatic)
-// ✅ session_end (automatic)
-```
-
----
-
-## 🆚 **Comparison: Manual vs. Automatic Events**
-
-### **Before Auto-Events (Manual Only)**
-```typescript
-// Developer had to track everything manually
-await datalyr.track('session_start', { timestamp: Date.now() });
-await datalyr.screen('Home');
-await datalyr.track('app_foreground', { /* manual data */ });
-// 😰 Easy to forget, inconsistent data
-```
-
-### **After Auto-Events (Like Mixpanel)**
-```typescript
-// SDK tracks automatically
-// ✅ session_start (automatic)
-// ✅ pageviews: Home (automatic)  
-// ✅ app_foreground (automatic)
-// 😎 Consistent, complete data out-of-the-box
-```
-
----
-
-## 🎯 **Is It Production Ready?**
-
-### **✅ YES for Attribution** 
-- Complete attribution tracking
-- All major ad platforms supported
-- Deep link and install attribution
-- Works with existing backend
-
-### **✅ YES for Analytics (Now)**
-- Automatic events like Mixpanel
-- Session and user journey tracking
-- Revenue and conversion tracking
-- Performance monitoring
-
-### **🔥 Competitive Analysis**
-
-| SDK Feature | Mixpanel | Amplitude | Firebase | **Datalyr** |
-|-------------|----------|-----------|----------|-------------|
-| Attribution | ❌ | ❌ | ❌ | **✅** |
-| Auto Events | ✅ | ✅ | ✅ | **✅** |
-| Session Tracking | ✅ | ✅ | ✅ | **✅** |
-| Offline Support | ✅ | ✅ | ✅ | **✅** |
-| Ad Platform Integration | ❌ | ❌ | ❌ | **✅** |
-| Revenue Tracking | ✅ | ✅ | ✅ | **✅** |
-
-**🏆 Datalyr Advantage:** Only SDK that combines attribution + automatic events!
-
----
-
-## 🚧 **What's Still Missing (Optional)**
-
-### **📱 Advanced Features (10% of value)**
-- ❌ **Push Notification Attribution** (clicks, opens)
-- ❌ **Crash Reporting** (app crashes, errors)
-- ❌ **Network State Monitoring** (online/offline events)
-- ❌ **Advanced Fingerprinting** (canvas, audio fingerprinting)
-- ❌ **A/B Testing** (not needed for attribution)
-
-### **🔧 Development Improvements**
-- ❌ **Native iOS SDK** (Swift implementation)
-- ❌ **Native Android SDK** (Kotlin implementation)  
-- ❌ **React Native Navigation** (Auto screen tracking)
-- ❌ **Expo Plugin** (Easy configuration)
-
----
-
-## 🎉 **Final Verdict**
-
-### **SDK Completion: 95% ✅**
-
-**Core Attribution:** 100% Complete ✅  
-**Automatic Events:** 100% Complete ✅  
-**Advanced Features:** 60% Complete (optional)
-
-**Latest Version:** v1.0.10 - Production Ready 🚀
-
-### **Ready for Production?** 
-
-**🔥 ABSOLUTELY YES!** 
-
-The SDK now provides:
-1. **Complete attribution tracking** (better than any competitor)
-2. **Automatic events** (like Mixpanel/Amplitude)
-3. **Production-grade reliability** (offline support, error handling)
-4. **Easy integration** (works with existing backend)
-
-### **Next Steps**
-1. ✅ **Test in your mobile app** 
-2. ✅ **Verify attribution flow**
-3. ✅ **Monitor automatic events**
-4. 🚀 **Launch to production**
-
-The mobile SDK is now **feature-complete** and ready for real-world usage! 🚀