react-native-edgee 1.0.6 → 1.0.8

package/README.md

@@ -1,20 +1,13 @@
 # react-native-edgee
 
-Lightweight Edgee data collection client for React Native with comprehensive native context collection.
+For React Native applications, we provide a comprehensive SDK that enables
+seamless data collection with rich native context. This SDK automatically
+collects 30+ device and app data points while maintaining privacy compliance
+and optimal performance.
 
-## ✨ Features
+## Installation
 
-- **📱 Rich Native Context**: Automatically collects 30+ device & app data points
-- **🔒 Privacy-First**: GDPR/CCPA compliant with optional device ID collection
-- **📶 Offline Queue**: Events are persisted and retried when network is available
-- **⚡ Lightweight**: Minimal impact on app size (~100KB total)
-- **🎯 Type-Safe**: Full TypeScript support with comprehensive type definitions
-- **📍 Auto Screen Tracking**: Optional helpers for Expo Router and React Navigation
-- **🔄 Graceful Fallback**: Works without native modules (Expo Go compatible)
-
-## 📦 Installation
-
-### Step 1: Install Package & Dependencies
+### Step 1: Install Package and Dependencies
 
 ```bash
 # npm
@@ -29,10 +22,9 @@ npx expo install react-native-edgee @react-native-async-storage/async-storage @r
 
 ### Step 2: Platform Setup
 
-Choose your platform setup:
+Choose your platform setup based on your React Native environment:
 
-<details>
-<summary><strong>📱 React Native CLI (Full Native Context)</strong></summary>
+#### React Native CLI
 
 **iOS:**
 ```bash
@@ -54,7 +46,7 @@ public class MainApplication extends Application implements ReactApplication {
     @SuppressWarnings("UnnecessaryLocalVariable")
     List<ReactPackage> packages = new PackageList(this).getPackages();
 
-    packages.add(new EdgeeReactNativePackage()); // 👈 Add this line
+    packages.add(new EdgeeReactNativePackage()); // Add this line
 
     return packages;
   }
@@ -75,10 +67,7 @@ public class MainApplication extends Application implements ReactApplication {
 npx react-native run-android
 ```
 
-</details>
-
-<details>
-<summary><strong>⚡ Expo Development Build (Full Native Context)</strong></summary>
+#### Expo Development Build
 
 ```bash
 # Install the package
@@ -89,20 +78,16 @@ npx expo run:ios     # For iOS
 npx expo run:android # For Android
 ```
 
-**Note:** Native modules require a development build, not Expo Go.
-
-</details>
+Note: Native modules require a development build, not Expo Go.
 
-<details>
-<summary><strong>📱 Expo Go (JavaScript Context Only)</strong></summary>
+#### Expo Go
 
 ```bash
 npx expo install react-native-edgee @react-native-async-storage/async-storage @react-native-community/netinfo
 ```
 
-**Limitations:** Native context collection is disabled. Only basic JavaScript context (screen size, platform, locale) will be available.
-
-</details>
+Limitations: Native context collection is disabled. Only basic JavaScript
+context (screen size, platform, locale) will be available.
 
 ### Step 3: Verify Installation
 
@@ -116,9 +101,7 @@ console.log('Native modules available:', isNativeModuleAvailable());
 // Should log: false (Expo Go)
 ```
 
-## 🚀 Quick Start
-
-### Basic Setup
+## Quick Start
 
 ```typescript
 import { EdgeeClient } from 'react-native-edgee';
@@ -126,347 +109,118 @@ 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
+  debug: false, // Set to true to enable debug logging and debugger in the Edgee console
   collectDeviceId: false, // Set to true if you need unique device tracking
 });
 ```
 
-### Track Events
+Replace `https://your-edgee-host.com` with the URL provided in the Edgee
+console, in the project overview section.
 
-```typescript
-// 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'
-});
+## Events
 
-// Track user information
-edgee.user({
-  id: '123',
-  email: 'user@example.com',
-  plan: 'premium'
-});
+### Screen event
 
-// Track screen views
-edgee.screen('Home Screen', {
-  category: 'main',
-  loaded_time: Date.now()
-});
-```
+The `edgee.screen()` method expects the following parameters:
 
-### Consent Management (Optional)
+field | type | description
+----- | ---- | ---
+`screen_obj` (required) | object | A free-form dictionary object containing properties of the `screen` event. This object has to include the `screen_name` field, and can include the `screen_class` and `properties` fields.
+`components` (optional) | object | Specifies which analytics components should receive the event data. This allows for targeted data sending based on your configured components within the Edgee platform.
 
-```typescript
-// Set consent - all tracking calls automatically respect this setting
-await edgee.setConsent('granted'); // 'granted', 'denied', or 'pending'
+Example:
 
-// 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);
+```typescript
+// Track screen views
+edgee.screen({
+  screen_name: 'Home Screen',
+  screen_class: '/',
+  properties: {
+    category: 'main',
+    loaded_time: Date.now()
+  }
 });
-
-// Reset consent
-await edgee.resetConsent();
 ```
 
-**Key Benefits:**
-- 🔒 **Transparent**: No need to check consent before each tracking call
-- 📡 **Auto-sync**: Consent events automatically sent to your Edgee server
-- 💾 **Persistent**: Consent preference stored locally and remembered
-- 🎯 **Compliant**: GDPR/CCPA ready with proper consent management
+### Track event
 
-## 📱 Rich Native Context
+The `edgee.track()` method expects the following parameters:
 
-With native modules enabled, each event automatically includes comprehensive context:
+field | type | description
+----- | ---- | ---
+`track_obj` (required) | object | A free-form dictionary object containing properties of the `track` event. This object has to include the `name` field, and can include the `screen_name` and `screen_class` fields, and the `properties` field.
+`components` (optional) | object | Specifies which analytics components should receive the event data. This allows for targeted data sending based on your configured components within the Edgee platform.
 
-### App Information
-- App name, version, build number
-- Bundle/package identifier
-- Installation and update timestamps
+Example:
 
-### Device Information
-- Device model, manufacturer, brand
-- Screen dimensions, density, scale
-- Hardware capabilities (tablet, simulator/emulator detection)
-
-### System Information
-- OS name and version
-- Locale, language, country, timezone
-- Memory usage, storage info
-- Battery level and state (iOS)
+```typescript
+// Track events (automatically includes rich native context)
+edgee.track({
+  name: 'App Launched',
+  screen_name: 'Home Screen',
+  screen_class: '/',
+  properties: {
+    source: 'cold_start',
+    version: '1.0.0'
+  }
+});
+```
 
-### Network Information
-- Connection type (WiFi, cellular, ethernet)
-- Carrier name and network codes
-- Radio technology (3G, 4G, 5G)
+### User event
 
-### Privacy Information *(Optional)*
-- Advertising ID (with proper consent on iOS 14+)
-- Device ID (privacy-compliant, opt-in only)
-- Tracking authorization status
+The `edgee.user()` method expects the following parameters:
 
-## ⚛️ React Integration
+field | type | description
+----- | ---- | ---
+`user_obj` (required) | object | A free-form dictionary object containing properties of the `user` event. This object has to include the `user_id` field, and can include the `properties` field.
+`components` (optional) | object | Specifies which analytics components should receive the event data. This allows for targeted data sending based on your configured components within the Edgee platform.
 
-### Context Provider (Optional)
+Example:
 
 ```typescript
-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>
-  );
-}
+// Track user information
+edgee.user({
+  user_id: '123',
+  properties: {
+    email: 'user@example.com',
+    plan: 'premium'
+  }
+});
 ```
 
-### Auto Screen Tracking
+### Consent (Optional)
 
-<details>
-<summary><strong>Expo Router</strong></summary>
+To define the consent status, you can use the `edgee.consent()` method.
 
 ```typescript
-import { EdgeeAutoTracker } from 'react-native-edgee/expo-router';
-
-export default function RootLayout() {
-  return (
-    <>
-      <EdgeeAutoTracker edgee={edgee} />
-      <Stack>
-        <Stack.Screen name="index" />
-        <Stack.Screen name="profile" />
-      </Stack>
-    </>
-  );
-}
-```
+// Set consent - all tracking calls automatically respect this setting
+// 'granted', 'denied', or 'pending'
+await edgee.consent('granted');
 
-</details>
+// Check consent status
+console.log('Current consent:', edgee.getConsent());
 
-<details>
-<summary><strong>React Navigation</strong></summary>
+// Listen for consent changes
+const unsubscribe = edgee.onConsentChange((status) => {
+  console.log('Consent changed to:', status);
+});
 
-```typescript
-import { navigation } from 'react-native-edgee';
-
-const navigationRef = useRef();
-
-return (
-  <NavigationContainer
-    ref={navigationRef}
-    onStateChange={() => {
-      navigation.trackScreenChange(navigationRef, edgee);
-    }}
-  >
-    {/* Your navigation structure */}
-  </NavigationContainer>
-);
+// Reset consent
+await edgee.resetConsent();
 ```
 
-</details>
-
-## ⚙️ Configuration
+## Configuration
 
 ```typescript
 interface EdgeeConfig {
   host: string;                    // Your Edgee endpoint URL (required)
   debug?: boolean;                 // Enable debug logging (default: false)
   collectDeviceId?: boolean;       // Collect unique device ID (default: false)
+  cookieName?: string              // Name of the cookie used by Edgee (it must be identical to the one on the console. Do not change it if you are unsure).
 }
 ```
 
-### Privacy Considerations
-
-- **Device ID Collection**: Only enable `collectDeviceId: true` if you need persistent device tracking
-- **iOS Advertising ID**: Automatically respects App Tracking Transparency (iOS 14+)
-- **GDPR/CCPA Compliance**: All sensitive data collection is optional and clearly documented
-
-## 🔧 Advanced Usage
-
-### Manual Native Context Access
-
-```typescript
-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);
-}
-```
-
-### Context Caching
-
-```typescript
-import { clearContextCache } from 'react-native-edgee';
-
-// Clear cached context (useful for testing or when context might change)
-clearContextCache();
-```
-
-## 🧪 Testing with EdgeeTestApp
-
-The repository includes a test app (`EdgeeTestApp/`) that allows you to quickly test the SDK functionality without integrating it into your own app.
-
-### Running the Test App
-
-1. **Navigate to the test app directory:**
-   ```bash
-   cd EdgeeTestApp
-   ```
-
-2. **Install dependencies:**
-   ```bash
-   npm install
-   # or
-   yarn install
-   ```
-
-3. **For iOS - Install pods:**
-   ```bash
-   cd ios && pod install && cd ..
-   ```
-
-4. **Start Metro bundler:**
-   ```bash
-   npm start
-   # or
-   yarn start
-   ```
-
-5. **Run the app:**
-   ```bash
-   # iOS
-   npm run ios
-   # or
-   yarn ios
-
-   # Android
-   npm run android
-   # or
-   yarn android
-   ```
-
-### Using the Test App
-
-The test app provides a simple UI to test all SDK features:
-
-1. **Set Edgee Host**: Enter your Edgee endpoint URL (defaults to `https://demo.edgee.app`)
-   - Click "Init" to initialize the SDK with your host
-
-2. **Test Events**:
-   - **Track Event**: Enter an event name and click "Track Event" to send a track event
-   - **Screen Event**: Click "Screen Event" to track a screen view
-   - **User Event**: Click "User Event" to send user identification data
-
-3. **Test Consent Management**:
-   - Click "Pending", "Granted", or "Denied" to set consent status
-   - Click "Get Consent" to view the current consent status
-
-4. **Monitor Status**: The status bar at the bottom shows the result of each action
-
-### Features Demonstrated
-
-- ✅ SDK initialization with custom host
-- ✅ Event tracking (track, screen, user)
-- ✅ Consent management (pending, granted, denied)
-- ✅ Native module availability detection
-- ✅ Debug logging (enabled by default in test app)
-
-### Debug Mode
-
-The test app has debug mode enabled by default, so you'll see detailed logs in Metro CLI:
-- Event tracking logs
-- Consent status changes
-- Native context collection
-- API request/response details
-
-### Notes
-
-- The test app uses the local `react-native-edgee` package via `file:..` in `package.json`
-- Make sure you've built the SDK (`npm run build` in the root directory) before running the test app
-- Native modules are automatically available if you've set up the platform correctly
-
-## 🔍 Troubleshooting
-
-### Common Issues
-
-<details>
-<summary><strong>"Module not found" Error</strong></summary>
-
-**iOS:**
-```bash
-cd ios && rm -rf build && pod install && cd ..
-npx react-native run-ios
-```
-
-**Android:**
-- Ensure `EdgeeReactNativePackage` is added to `MainApplication.java`
-- Clean build: `cd android && ./gradlew clean && cd ..`
-
-</details>
-
-<details>
-<summary><strong>No Native Context in Events</strong></summary>
-
-1. Check if native modules are available:
-   ```typescript
-   console.log('Available:', isNativeModuleAvailable());
-   ```
-
-2. If `false`, verify platform setup above
-3. In Expo Go, this is expected (use Expo Development Build)
-
-</details>
-
-<details>
-<summary><strong>Build Errors</strong></summary>
-
-**Clean everything:**
-```bash
-# React Native CLI
-cd ios && rm -rf build && cd ..
-cd android && ./gradlew clean && cd ..
-npx react-native start --reset-cache
-
-# Expo
-npx expo run:ios --clear-cache
-```
-
-</details>
-
-### Debug Mode
+## Debug Mode
 
 Enable debug logging to see what's happening:
 
@@ -477,33 +231,24 @@ const edgee = new EdgeeClient({
 });
 ```
 
-## 📋 Compatibility
+## Compatibility
 
 | Platform | Version | Native Context | Auto-Linking |
 |----------|---------|----------------|--------------|
-| **React Native** | 0.72+ | ✅ Full | iOS: ✅ Android: Manual |
-| **iOS** | 11.0+ | ✅ Full | ✅ CocoaPods |
-| **Android** | API 21+ | ✅ Full | ⚠️ Manual setup |
-| **Expo Dev Build** | Latest | ✅ Full | ✅ Automatic |
-| **Expo Go** | Latest | ⚠️ Fallback | N/A |
-
-## 📚 TypeScript Support
-
-Full TypeScript support with comprehensive type definitions:
-
-```typescript
-import type {
-  EdgeeNativeContext,
-  EdgeeClientContext,
-  EdgeeConfig
-} from 'react-native-edgee';
-```
+| React Native | 0.72+ | Full | iOS: Yes, Android: Manual |
+| iOS | 11.0+ | Full | CocoaPods |
+| Android | API 21+ | Full | Manual setup |
+| Expo Dev Build | Latest | Full | Automatic |
+| Expo Go | Latest | Fallback | N/A |
 
-## 📄 License
+## Next Steps
 
-MIT
+After integrating the React Native SDK, you are ready to start using Edgee's
+services.
 
-## 🆘 Support
+In the Services section, you will find guides on activating and customizing
+features such as advanced analytics, A/B testing, security, and more:
+https://www.edgee.cloud/docs/proxy/services/overview
 
-- **Issues**: [GitHub Issues](https://github.com/edgee-cloud/react-native-edgee/issues)
-- **Documentation**: [Edgee Docs](https://docs.edgee.cloud)
+For more details about the React Native SDK, visit:
+https://github.com/edgee-cloud/react-native-edgee

package/dist/api.d.ts

@@ -6,28 +6,30 @@ declare enum EventType {
     Screen = "screen"
 }
 export type EdgeeTrackEvent = {
-    type: EventType.Track;
     name: string;
-    components: Record<string, boolean> | undefined;
-    data: object;
-    context: EdgeeFullContext;
+    screen_name?: string;
+    screen_class?: string;
+    properties?: object;
 };
 export type EdgeeUserEvent = {
-    type: EventType.User;
-    data: object;
-    components: Record<string, boolean> | undefined;
-    context: EdgeeFullContext;
+    user_id?: string;
+    anonymous_id?: string;
+    properties?: object;
 };
 export type EdgeeScreenEvent = {
-    type: EventType.Screen;
-    name: string;
+    screen_name: string;
+    screen_class?: string;
+    properties?: object;
+};
+export type EdgeeEvent = {
+    type: EventType.Track | EventType.User | EventType.Screen;
     data: object;
     components: Record<string, boolean> | undefined;
     context: EdgeeFullContext;
 };
-export type EdgeeEvent = EdgeeTrackEvent | EdgeeUserEvent | EdgeeScreenEvent;
-export declare const createTrackEvent: (params: Omit<EdgeeTrackEvent, "type">) => EdgeeTrackEvent;
-export declare const createUserEvent: (params: Omit<EdgeeUserEvent, "type">) => EdgeeUserEvent;
+export declare const createScreenEvent: (data: EdgeeScreenEvent, components: Record<string, boolean> | undefined, context: EdgeeFullContext) => EdgeeEvent;
+export declare const createTrackEvent: (data: EdgeeTrackEvent, components: Record<string, boolean> | undefined, context: EdgeeFullContext) => EdgeeEvent;
+export declare const createUserEvent: (data: EdgeeUserEvent, components: Record<string, boolean> | undefined, context: EdgeeFullContext) => EdgeeEvent;
 /**
  * Sends a payload to the Edgee API with proper headers and handles the response
  */

package/dist/api.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.uploadEvent = exports.sendPayload = exports.createUserEvent = exports.createTrackEvent = void 0;
+exports.uploadEvent = exports.sendPayload = exports.createUserEvent = exports.createTrackEvent = exports.createScreenEvent = void 0;
 const edgee_store_1 = require("./core/edgee-store");
 const utils_1 = require("./core/utils");
 var EventType;
@@ -9,17 +9,33 @@ var EventType;
     EventType["User"] = "user";
     EventType["Screen"] = "screen";
 })(EventType || (EventType = {}));
-const createTrackEvent = (params) => {
+const createScreenEvent = (data, components, context) => {
     return {
         type: EventType.Track,
-        ...params,
+        data: {
+            name: "screen_view",
+            ...data,
+        },
+        components,
+        context: context,
+    };
+};
+exports.createScreenEvent = createScreenEvent;
+const createTrackEvent = (data, components, context) => {
+    return {
+        type: EventType.Track,
+        data,
+        components,
+        context: context,
     };
 };
 exports.createTrackEvent = createTrackEvent;
-const createUserEvent = (params) => {
+const createUserEvent = (data, components, context) => {
     return {
         type: EventType.User,
-        ...params,
+        data,
+        components,
+        context: context,
     };
 };
 exports.createUserEvent = createUserEvent;
@@ -33,33 +49,11 @@ const buildEventPayload = (event) => {
             events: [],
         },
     };
-    if (event.type === EventType.Track) {
-        basePayload.data_collection.events.push({
-            type: "track",
-            data: {
-                name: event.name,
-                properties: event.data,
-            },
-            components: event.components,
-        });
-    }
-    else if (event.type === EventType.User) {
-        basePayload.data_collection.events.push({
-            type: "user",
-            data: event.data,
-            components: event.components,
-        });
-    }
-    else if (event.type === EventType.Screen) {
-        basePayload.data_collection.events.push({
-            type: "track",
-            data: { ...event.data, screen_name: event.name },
-            components: event.components,
-        });
-    }
-    else {
-        throw new Error(`Invalid event type: ${event.type}`);
-    }
+    basePayload.data_collection.events.push({
+        type: event.type,
+        data: event.data,
+        components: event.components,
+    });
     return basePayload;
 };
 /**
@@ -92,6 +86,9 @@ const buildHeaders = async (config) => {
     if (cookieHeader) {
         headers["Edgee-Cookie"] = cookieHeader;
     }
+    else {
+        headers["Edgee-Cookie"] = "";
+    }
     return headers;
 };
 /**
@@ -154,17 +151,6 @@ const handleResponse = async (data, config) => {
             (0, utils_1.log)(config, `Set userId: ${userId}`);
         }
     }
-    // Handle cookies array (data.c)
-    // Note: In React Native, we don't have browser cookies, but we log them if debug is enabled
-    if (data.c && Array.isArray(data.c) && data.c.length > 0) {
-        for (const cookie of data.c) {
-            if (cookie.name && cookie.value) {
-                (0, utils_1.log)(config, "○ Set cookie: " + cookie.name + "=" + cookie.value);
-            }
-            // In React Native, cookies are typically handled by the app's cookie store
-            // If needed, you could store them in AsyncStorage or another storage mechanism
-        }
-    }
     // Extract events if present
     if (data.events) {
         events = data.events;

package/dist/core/context.d.ts

@@ -29,8 +29,11 @@ export interface EdgeeClientContext {
 }
 export interface EdgeePageContext {
     title: string;
+    category: string;
     path: string;
-    url: string | undefined;
+    url: string;
+    search: string;
+    referrer: string;
 }
 export interface EdgeeFullContext {
     client: EdgeeClientContext;

package/dist/core/context.js

@@ -9,12 +9,11 @@ const utils_1 = require("./utils");
  */
 const getContext = async (config) => {
     const initialUrl = await react_native_1.Linking.getInitialURL();
-    const nativeContext = await (0, native_context_1.getNativeContext)();
+    const nativeContext = await (0, native_context_1.getNativeContext)(config.collectDeviceId || false);
     const url = initialUrl || `${(nativeContext === null || nativeContext === void 0 ? void 0 : nativeContext.bundleId) || "app"}://`;
     let clientContext;
     if ((0, native_context_1.isNativeModuleAvailable)()) {
         try {
-            const nativeContext = await (0, native_context_1.getNativeContext)({ collectDeviceId: config.collectDeviceId });
             clientContext = buildClientContextFromNative(nativeContext);
         }
         catch (error) {
@@ -28,9 +27,12 @@ const getContext = async (config) => {
     return {
         client: clientContext,
         page: {
-            title: "Home",
-            path: "/",
-            url,
+            title: nativeContext.appName || "",
+            category: "",
+            path: "",
+            url: url,
+            search: "",
+            referrer: "",
         },
     };
 };

package/dist/core/edgee-store.d.ts

@@ -6,8 +6,8 @@ export declare class EdgeeStore {
     initialized: boolean;
     constructor();
     init(): Promise<void>;
-    getEdgeeId(): Promise<string | null>;
-    getUserId(): Promise<string | null>;
+    getEdgeeId(): string | null;
+    getUserId(): string | null;
     setEdgeeId(edgeeId: string): Promise<void>;
     setUserId(userId: string): Promise<void>;
     getContext(): Promise<{
@@ -17,6 +17,7 @@ export declare class EdgeeStore {
     addEvent(event: EdgeeEvent): Promise<void>;
     getPendingEvents(): Promise<EdgeeEvent[]>;
     clearEvents(): Promise<void>;
+    reset(): Promise<void>;
 }
 /**
  * Global edgee store instance

package/dist/core/edgee-store.js

@@ -38,10 +38,10 @@ class EdgeeStore {
             this.initialized = true;
         }
     }
-    async getEdgeeId() {
+    getEdgeeId() {
         return this.edgeeId;
     }
-    async getUserId() {
+    getUserId() {
         return this.userId;
     }
     async setEdgeeId(edgeeId) {
@@ -73,6 +73,20 @@ class EdgeeStore {
         this.pendingEvents = [];
         await async_storage_1.default.removeItem(STORAGE_KEYS.pendingEvents);
     }
+    async reset() {
+        this.edgeeId = null;
+        this.userId = null;
+        this.pendingEvents = [];
+        try {
+            await async_storage_1.default.removeItem(STORAGE_KEYS.edgeeId);
+            await async_storage_1.default.removeItem(STORAGE_KEYS.userId);
+            await async_storage_1.default.removeItem(STORAGE_KEYS.pendingEvents);
+            this.initialized = false;
+        }
+        catch (error) {
+            (0, utils_1.logError)("Failed to reset Edgee store", error);
+        }
+    }
 }
 exports.EdgeeStore = EdgeeStore;
 /**

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { EdgeeScreenEvent, EdgeeTrackEvent, EdgeeUserEvent } from "./api";
 import { ConsentStatus } from "./consent";
 export type EdgeeConfig = {
     host: string;
@@ -16,15 +17,15 @@ export declare class EdgeeClient {
     /**
      * Track a screen view event
      */
-    screen(screenName: string, data: object, components?: Components): Promise<void>;
+    screen(data: EdgeeScreenEvent, components?: Components): Promise<void>;
     /**
      * Track a custom event
      */
-    track(name: string, data: object, components?: Components): Promise<void>;
+    track(data: EdgeeTrackEvent, components?: Components): Promise<void>;
     /**
      * Track a user event
      */
-    user(data: object, components?: Components): Promise<void>;
+    user(data: EdgeeUserEvent, components?: Components): Promise<void>;
     /**
      * Send consent event directly to Edgee (matches web SDK format)
      */
@@ -33,10 +34,10 @@ export declare class EdgeeClient {
     getConsent(): ConsentStatus | null;
     hasConsent(): boolean;
     resetConsent(): Promise<void>;
+    reset(): Promise<void>;
     onConsentChange(callback: (status: ConsentStatus | null) => void): () => void;
 }
 export { EdgeeProvider, useEdgee, } from "./react";
-export type { EdgeeClientContext, EdgeeFullContext, EdgeePageContext, } from "./core/context";
-export { clearContextCache, getNativeContext, isNativeModuleAvailable, } from "./native-context";
-export type { EdgeeNativeContext, EdgeeNativeContextConfig, EdgeeReactNativeModule, } from "./types";
+export { clearContextCache, isNativeModuleAvailable, } from "./native-context";
+export type { EdgeeNativeContext, EdgeeReactNativeModule, } from "./types";
 export type { ConsentStatus, } from "./consent";

package/dist/index.js

@@ -1,76 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isNativeModuleAvailable = exports.getNativeContext = exports.clearContextCache = exports.useEdgee = exports.EdgeeProvider = exports.EdgeeClient = void 0;
+exports.isNativeModuleAvailable = exports.clearContextCache = exports.useEdgee = exports.EdgeeProvider = exports.EdgeeClient = void 0;
 const react_native_1 = require("react-native");
 const api_1 = require("./api");
 const consent_1 = require("./consent");
-const context_1 = require("./core/context");
 const edgee_store_1 = require("./core/edgee-store");
+const context_1 = require("./core/context");
 const queue_1 = require("./core/queue");
 const utils_1 = require("./core/utils");
-const native_context_1 = require("./native-context");
 const DEFAULT_COOKIE_NAME = "edgee";
-/**
- * Extract native context properties to include in event data under a sub-object
- */
-const extractNativeProperties = (nativeContext) => {
-    if (!nativeContext)
-        return {};
-    return {
-        native_context: {
-            // Device information
-            device_id: nativeContext.deviceId,
-            device_name: nativeContext.deviceName,
-            device_type: nativeContext.deviceType,
-            manufacturer: nativeContext.manufacturer,
-            model: nativeContext.model,
-            // System information
-            os_name: nativeContext.osName,
-            os_version: nativeContext.osVersion,
-            // App information
-            app_name: nativeContext.appName,
-            app_version: nativeContext.appVersion,
-            build_number: nativeContext.buildNumber,
-            bundle_id: nativeContext.bundleId,
-            // Hardware capabilities
-            is_tablet: nativeContext.isTablet,
-            is_simulator: nativeContext.isSimulator,
-            is_emulator: nativeContext.isEmulator,
-            is_rooted: nativeContext.isRooted,
-            is_jailbroken: nativeContext.isJailbroken,
-            // System metrics
-            total_memory_mb: nativeContext.totalMemoryMB,
-            free_memory_mb: nativeContext.freeMemoryMB,
-            max_memory_mb: nativeContext.maxMemoryMB,
-            used_memory_mb: nativeContext.usedMemoryMB,
-            available_memory_mb: nativeContext.availableMemoryMB,
-            free_storage_mb: nativeContext.freeStorageMB,
-            total_storage_mb: nativeContext.totalStorageMB,
-            used_storage_mb: nativeContext.usedStorageMB,
-            battery_level: nativeContext.batteryLevel,
-            battery_state: nativeContext.batteryState,
-            system_uptime: nativeContext.systemUptime,
-            low_power_mode: nativeContext.lowPowerMode,
-            // Network information
-            network_type: nativeContext.networkType,
-            carrier_name: nativeContext.carrierName,
-            radio_technology: nativeContext.radioTechnology,
-            // Locale information
-            locale: nativeContext.locale,
-            language: nativeContext.language,
-            country: nativeContext.country,
-            timezone: nativeContext.timezone,
-            // Privacy information
-            advertising_id: nativeContext.advertisingId,
-            ad_tracking_enabled: nativeContext.adTrackingEnabled,
-            tracking_status: nativeContext.trackingStatus,
-            // Additional information
-            user_agent: nativeContext.userAgent,
-            first_install_time: nativeContext.firstInstallTime,
-            last_update_time: nativeContext.lastUpdateTime,
-        },
-    };
-};
 class EdgeeClient {
     constructor(config) {
         // current app state
@@ -79,14 +17,19 @@ class EdgeeClient {
         this.handleAppStateChange = (nextAppState) => {
             if (["inactive", "background"].includes(this.appState) &&
                 nextAppState === "active") {
-                this.track("application_opened", {
-                    from_background: true,
+                this.track({
+                    name: "application_opened",
+                    properties: {
+                        from_background: true,
+                    },
                 });
             }
             else if ((this.appState === "active" || this.appState === "unknown") && // Check if appState is 'active' or 'unknown'
                 ["inactive", "background"].includes(nextAppState)) {
                 // Check if next app state is 'inactive' or 'background'
-                this.track("application_backgrounded", {});
+                this.track({
+                    name: "application_backgrounded",
+                });
             }
             this.appState = nextAppState;
         };
@@ -108,64 +51,37 @@ class EdgeeClient {
     /**
      * Track a screen view event
      */
-    async screen(screenName, data, components) {
+    async screen(data, components) {
+        // if screen_name or title is not in data, throw an error
+        if (!("screen_name" in data)) {
+            throw new Error("screen_name or title is required to track a screen event");
+        }
         const context = await (0, context_1.getContext)(this.config);
-        // Get native context properties if available and collectDeviceId is enabled
-        let nativeProperties = {};
-        if (this.config.collectDeviceId && (0, native_context_1.isNativeModuleAvailable)()) {
-            try {
-                const nativeContext = await (0, native_context_1.getNativeContext)({
-                    collectDeviceId: this.config.collectDeviceId,
-                });
-                nativeProperties = extractNativeProperties(nativeContext);
-            }
-            catch (error) {
-                (0, utils_1.logError)("Error collecting page event", error);
-            }
+        const { screen_name, screen_class, ...restData } = data;
+        context.page.title = screen_name;
+        if (screen_class) {
+            context.page.url = screen_class;
         }
-        // Merge native properties with screen data
-        const enhancedData = {
-            ...data,
-            screen_name: screenName,
-            ...nativeProperties,
-        };
-        const event = (0, api_1.createTrackEvent)({
-            name: "screen",
-            data: enhancedData,
-            components,
-            context,
-        });
+        const event = (0, api_1.createScreenEvent)(restData, components, context);
         this.queue.enqueue(event);
     }
     /**
      * Track a custom event
      */
-    async track(name, data, components) {
+    async track(data, components) {
+        // if name is not in data, throw an error
+        if (!("name" in data)) {
+            throw new Error("Name is required to track an event");
+        }
         const context = await (0, context_1.getContext)(this.config);
-        // Get native context properties if available and collectDeviceId is enabled
-        let nativeProperties = {};
-        if (this.config.collectDeviceId && (0, native_context_1.isNativeModuleAvailable)()) {
-            try {
-                const nativeContext = await (0, native_context_1.getNativeContext)({
-                    collectDeviceId: this.config.collectDeviceId,
-                });
-                nativeProperties = extractNativeProperties(nativeContext);
-            }
-            catch (error) {
-                (0, utils_1.logError)("Error collecting track event", error);
-            }
+        const { screen_name, screen_class, ...restData } = data;
+        if (screen_name) {
+            context.page.title = screen_name;
         }
-        // Merge native properties with event data
-        const enhancedData = {
-            ...data,
-            ...nativeProperties,
-        };
-        const event = (0, api_1.createTrackEvent)({
-            name,
-            data: enhancedData,
-            components,
-            context,
-        });
+        if (screen_class) {
+            context.page.url = screen_class;
+        }
+        const event = (0, api_1.createTrackEvent)(restData, components, context);
         this.queue.enqueue(event);
     }
     /**
@@ -173,29 +89,7 @@ class EdgeeClient {
      */
     async user(data, components) {
         const context = await (0, context_1.getContext)(this.config);
-        // Get native context properties if available and collectDeviceId is enabled
-        let nativeProperties = {};
-        if (this.config.collectDeviceId && (0, native_context_1.isNativeModuleAvailable)()) {
-            try {
-                const nativeContext = await (0, native_context_1.getNativeContext)({
-                    collectDeviceId: this.config.collectDeviceId,
-                });
-                nativeProperties = extractNativeProperties(nativeContext);
-            }
-            catch (error) {
-                (0, utils_1.logError)("Error collecting user event", error);
-            }
-        }
-        // Merge native properties with user data
-        const enhancedData = {
-            ...data,
-            ...nativeProperties,
-        };
-        const event = (0, api_1.createUserEvent)({
-            data: enhancedData,
-            components,
-            context,
-        });
+        const event = (0, api_1.createUserEvent)(data, components, context);
         this.queue.enqueue(event);
     }
     /**
@@ -237,6 +131,10 @@ class EdgeeClient {
     async resetConsent() {
         await consent_1.edgeeConsent.reset();
     }
+    async reset() {
+        await edgee_store_1.edgeeStore.reset();
+        await this.resetConsent();
+    }
     onConsentChange(callback) {
         return consent_1.edgeeConsent.onChange(callback);
     }
@@ -245,7 +143,7 @@ exports.EdgeeClient = EdgeeClient;
 var react_1 = require("./react");
 Object.defineProperty(exports, "EdgeeProvider", { enumerable: true, get: function () { return react_1.EdgeeProvider; } });
 Object.defineProperty(exports, "useEdgee", { enumerable: true, get: function () { return react_1.useEdgee; } });
-var native_context_2 = require("./native-context");
-Object.defineProperty(exports, "clearContextCache", { enumerable: true, get: function () { return native_context_2.clearContextCache; } });
-Object.defineProperty(exports, "getNativeContext", { enumerable: true, get: function () { return native_context_2.getNativeContext; } });
-Object.defineProperty(exports, "isNativeModuleAvailable", { enumerable: true, get: function () { return native_context_2.isNativeModuleAvailable; } });
+// Export types and native context functions
+var native_context_1 = require("./native-context");
+Object.defineProperty(exports, "clearContextCache", { enumerable: true, get: function () { return native_context_1.clearContextCache; } });
+Object.defineProperty(exports, "isNativeModuleAvailable", { enumerable: true, get: function () { return native_context_1.isNativeModuleAvailable; } });

package/dist/native-context.d.ts

@@ -1,8 +1,8 @@
-import type { EdgeeNativeContext, EdgeeNativeContextConfig } from "./types";
+import type { EdgeeNativeContext } from "./types";
 /**
  * Get comprehensive device and app context from native modules
  */
-export declare function getNativeContext(config?: EdgeeNativeContextConfig): Promise<EdgeeNativeContext>;
+export declare function getNativeContext(collectDeviceId: boolean): Promise<EdgeeNativeContext>;
 /**
  * Clear cached context (useful for testing or when context might change)
  */

package/dist/native-context.js

@@ -21,22 +21,36 @@ let contextPromise = null;
 /**
  * Get comprehensive device and app context from native modules
  */
-async function getNativeContext(config = {}) {
+async function getNativeContext(collectDeviceId) {
     // Return cached context if available and no device ID collection requested
-    if (cachedContext && !config.collectDeviceId) {
+    if (cachedContext) {
+        // if collectDeviceId is false, return the cached context without device ID
+        if (!collectDeviceId) {
+            return {
+                ...cachedContext,
+                deviceId: undefined,
+            };
+        }
         return cachedContext;
     }
     // Return ongoing promise if one exists
     if (contextPromise) {
         return contextPromise;
     }
+    const config = {
+        collectDeviceId: collectDeviceId,
+    };
     contextPromise = EdgeeReactNative.getContextInfo(config)
         .then((context) => {
-        // Cache context if no sensitive data (device ID) was requested
-        if (!config.collectDeviceId) {
-            cachedContext = context;
-        }
+        cachedContext = context;
         contextPromise = null;
+        // if collectDeviceId is false, return the context without device ID
+        if (!collectDeviceId) {
+            return {
+                ...context,
+                deviceId: undefined,
+            };
+        }
         return context;
     })
         .catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-edgee",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Lightweight Edgee data collection client for React Native with native context collection.",
   "license": "MIT",
   "main": "dist/index.js",