React Native SDK

import { isNativeModuleAvailable } from 'react-native-edgee';

console.log('Native modules available:', isNativeModuleAvailable());
// Should log: true (React Native CLI, Expo Dev Build)
// Should log: false (Expo Go)

import { EdgeeClient } from 'react-native-edgee';

// Create client instance
export const edgee = new EdgeeClient({
  host: "https://your-edgee-host.com",
  debug: __DEV__, // Enable debug logging in development
  collectDeviceId: false, // Set to true if you need unique device tracking
});

// Track events (automatically includes rich native context)
// Consent is handled transparently - no need to check before each call!
edgee.track('App Launched', {
  source: 'cold_start',
  version: '1.0.0'
});

// Track user information
edgee.user({
  id: '123',
  email: 'user@example.com',
  plan: 'premium'
});

// Track screen views
edgee.screen('Home Screen', {
  category: 'main',
  loaded_time: Date.now()
});

// Set consent - all tracking calls automatically respect this setting
await edgee.setConsent('granted'); // 'granted', 'denied', or 'pending'

// Check consent status
console.log('Current consent:', edgee.getConsent());
console.log('Can track:', edgee.canTrack());

// Listen for consent changes
const unsubscribe = edgee.onConsentChange((status) => {
  console.log('Consent changed to:', status);
});

// Reset consent
await edgee.resetConsent();

import { EdgeeProvider, useEdgee } from 'react-native-edgee';

// Wrap your app
export default function App() {
  return (
    <EdgeeProvider host="https://your-edgee-host.com" debug={__DEV__}>
      <YourApp />
    </EdgeeProvider>
  );
}

// Use in components
function SomeComponent() {
  const edgee = useEdgee();

  const handleButtonPress = () => {
    // Tracking automatically respects consent - no need to check!
    edgee.track('Button Pressed', { button_id: 'cta_main' });
  };

  const handleConsentGrant = async () => {
    await edgee.setConsent('granted');
  };

  return (
    <View>
      <Button onPress={handleButtonPress} title="Track Me" />
      <Button onPress={handleConsentGrant} title="Grant Consent" />
    </View>
  );
}

import { useEdgeeConsent } from 'react-native-edgee';

function ConsentBanner() {
  const {
    consentStatus,
    loading,
    hasConsent,
    isGranted,
    isDenied,
    isPending,
    canTrack,
    setConsent,
    resetConsent,
  } = useEdgeeConsent();

  if (loading) return <Text>Loading...</Text>;

  if (!hasConsent) {
    return (
      <View style={styles.banner}>
        <Text>We use cookies to improve your experience.</Text>
        <Button onPress={() => setConsent('granted')} title="Accept" />
        <Button onPress={() => setConsent('denied')} title="Decline" />
      </View>
    );
  }

  return null;
}

interface EdgeeConfig {
  host: string;                    // Your Edgee endpoint URL (required)
  debug?: boolean;                 // Enable debug logging (default: false)
  collectDeviceId?: boolean;       // Collect unique device ID (default: false)
}

import { getNativeContext, isNativeModuleAvailable } from 'react-native-edgee';

// Check if native modules are available
if (isNativeModuleAvailable()) {
  const context = await getNativeContext({ collectDeviceId: false });
  console.log('Device model:', context.model);
  console.log('Is tablet:', context.isTablet);
  console.log('Network type:', context.networkType);
  console.log('Total memory:', context.totalMemoryMB);
}

import { clearContextCache } from 'react-native-edgee';

// Clear cached context (useful for testing or when context might change)
clearContextCache();

const edgee = new EdgeeClient({
  host: "https://your-edgee-host.com",
  debug: true, // This will log all events and native context
});

import type {
  EdgeeNativeContext,
  EdgeeClientContext,
  EdgeeConfig,
  ConsentStatus
} from 'react-native-edgee';