mobiqo-react-native 0.0.8 → 1.0.0

package/README.md

@@ -54,8 +54,10 @@ await mobiqo.syncUser({
   revenue_cat_user_id: 'user-123',
   include_advanced_analysis: false,
   additional_data: {
-    email: 'user@example.com',
-    plan: 'premium'
+    user_id: 'user-123',
+    user_name: 'John Doe',
+    user_email: 'user@example.com',
+    referrer: 'google'
   }
 });
 
@@ -82,6 +84,21 @@ await mobiqo.trackEvent(
 await mobiqo.trackEvent('screen_opened', MobiqoEvent.SCREEN_VIEW);
 ```
 
+### Update user data
+
+```typescript
+// Update user information without creating a new session
+await mobiqo.updateUser({
+  revenue_cat_user_id: 'user-123',
+  additional_data: {
+    user_id: 'user-123',
+    user_name: 'John Doe Updated',
+    user_email: 'newemail@example.com',
+    referrer: 'facebook'
+  }
+});
+```
+
 ### Get user information
 
 ```typescript
@@ -93,7 +110,7 @@ const userInfo = await mobiqo.getUserInfo({
 
 ### Automatic Session Tracking
 
-The SDK automatically sends heartbeats every 30 seconds after user sync to maintain session tracking. No manual intervention is required.
+The SDK automatically sends heartbeats every 20 seconds after user sync to maintain session tracking. No manual intervention is required.
 
 ## API Reference
 
@@ -106,8 +123,13 @@ Initialize the Mobiqo service with your API key.
 #### `syncUser(options)`
 Sync user data with Mobiqo and start a session.
 - `options.revenue_cat_user_id` (string): RevenueCat user ID
-- `options.include_advanced_analysis` (boolean): whether or not to include advanced analysis in the response (to get the purchase probability and other data, but the request will take more time)
-- `options.additional_data` (Record<string, any>, optional): Additional user data
+- `options.include_advanced_analysis` (boolean, optional): whether or not to include advanced analysis in the response (to get the purchase probability and other data, but the request will take more time)
+- `options.additional_data` (AdditionalData, optional): Additional user data (user_id, user_name, user_email, referrer)
+
+#### `updateUser(options)`
+Update user information without creating a new session.
+- `options.revenue_cat_user_id` (string): RevenueCat user ID
+- `options.additional_data` (AdditionalData, optional): Additional user data to update (user_id, user_name, user_email, referrer)
 
 #### `getUserInfo(options)`
 Retrieve user information from Mobiqo.
@@ -187,6 +209,16 @@ interface Statistics {
 }
 ```
 
+#### `AdditionalData`
+```typescript
+interface AdditionalData {
+  user_id?: string;
+  user_name?: string;
+  user_email?: string;
+  referrer?: string;
+}
+```
+
 ## Requirements
 
 - React Native

package/dist/index.d.ts

@@ -22,6 +22,8 @@ export interface AppUser {
     country?: string;
     /** User's language preference */
     language?: string;
+    /** A/B testing group assignment */
+    group: 'red' | 'blue';
     /** Timestamp when user was first seen */
     first_seen_at: string;
     /** Timestamp when user was last seen */
@@ -29,6 +31,12 @@ export interface AppUser {
     /** Currently active entitlements/subscriptions */
     active_entitlements: string[];
 }
+export interface AdditionalData {
+    user_id?: string;
+    user_name?: string;
+    user_email?: string;
+    referrer?: string;
+}
 /**
  * User analytics and prediction statistics
  */
@@ -65,14 +73,14 @@ export interface GetUserInfoResponse {
     statistics: Statistics;
 }
 /**
- * Mobiqo Analytics Service for Capacitor apps
+ * Mobiqo Analytics Service for React Native apps
  *
  * This service provides analytics tracking, user management, and session handling
  * for mobile applications using the Mobiqo platform.
  *
  * @example
  * ```typescript
- * import Mobiqo, { MobiqoEvent, SyncUserResponse, AppUser } from 'mobiqo-capacitor';
+ * import Mobiqo, { MobiqoEvent, SyncUserResponse, AppUser } from 'mobiqo-react-native';
  *
  * const mobiqo = new Mobiqo();
  * await mobiqo.init({ mobiqoKey: 'your-api-key' });
@@ -80,7 +88,8 @@ export interface GetUserInfoResponse {
  * // Sync user with optional additional data
  * const result: SyncUserResponse = await mobiqo.syncUser({
  *   revenue_cat_user_id: 'user-123',
- *   additional_data: { plan: 'premium' }
+ *   include_advanced_analysis: true,
+ *   additional_data: { user_id: 'user-123', user_name: 'John Doe', user_email: 'john.doe@example.com', referrer: 'google' }
  * });
  * console.log('User OS:', result.appUser.os);
  * console.log('Purchase intent:', result.statistics.purchase_intent);
@@ -112,17 +121,27 @@ export default class Mobiqo {
     init({ mobiqoKey }: {
         mobiqoKey: string;
     }): Promise<void>;
+    /**
+     * Get device model information
+     *
+     * Returns actual device model when possible. For best results, install react-native-device-info:
+     * npm install --save react-native-device-info
+     *
+     * @returns Device model string or 'unknown' if not available
+     * @private
+     */
+    private getDeviceModel;
     /**
      * Sync user data with Mobiqo and start a tracking session
      *
      * This method links a RevenueCat user ID with Mobiqo analytics and starts
-     * automatic heartbeat tracking (every 30 seconds). Call this after user login
+     * automatic heartbeat tracking (every 20 seconds). Call this after user login
      * or when you want to start tracking a user's session.
      *
      * @param options - User sync options
      * @param options.revenue_cat_user_id - The RevenueCat user identifier
      * @param options.include_advanced_analysis - Whether to include advanced analysis in the response (purchase probability and other data, but request takes more time)
-     * @param options.additional_data - Optional extra user data to store (email, plan, etc.)
+     * @param options.additional_data - Optional extra user data to store (email, name, etc.)
      * @returns Promise that resolves with user sync response including user data and statistics
      *
      * @example
@@ -132,9 +151,10 @@ export default class Mobiqo {
      *   revenue_cat_user_id: 'user-123',
      *   include_advanced_analysis: true,
      *   additional_data: {
-     *     email: 'user@example.com',
-     *     plan: 'premium',
-     *     signupDate: '2024-01-01'
+     *     user_id: 'user-123',
+     *     user_name: 'John Doe',
+     *     user_email: 'user@example.com',
+     *     referrer: 'google',
      *   }
      * });
      *
@@ -147,8 +167,37 @@ export default class Mobiqo {
     syncUser({ revenue_cat_user_id, include_advanced_analysis, additional_data }: {
         revenue_cat_user_id: string;
         include_advanced_analysis?: boolean;
-        additional_data?: Record<string, any>;
+        additional_data?: AdditionalData;
     }): Promise<SyncUserResponse | undefined>;
+    /**
+     * Update user data in Mobiqo
+     *
+     * This method allows you to update additional user data for an existing user.
+     * Use this when you want to update user information without creating a new session.
+     *
+     * @param options - User update options
+     * @param options.revenue_cat_user_id - The RevenueCat user identifier
+     * @param options.additional_data - Optional extra user data to update (email, name, etc.)
+     * @returns Promise that resolves when the update is complete
+     *
+     * @example
+     * ```typescript
+     * // Update user data
+     * await mobiqo.updateUser({
+     *   revenue_cat_user_id: 'user-123',
+     *   additional_data: {
+     *     user_id: 'user-123',
+     *     user_name: 'John Doe',
+     *     user_email: 'john.doe@example.com',
+     *     referrer: 'google',
+     *   }
+     * });
+     * ```
+     */
+    updateUser({ revenue_cat_user_id, additional_data }: {
+        revenue_cat_user_id: string;
+        additional_data?: AdditionalData;
+    }): Promise<void>;
     /**
      * Retrieve user information from Mobiqo
      *
@@ -205,7 +254,7 @@ export default class Mobiqo {
     /**
      * Send a heartbeat to maintain the user session
      *
-     * Heartbeats are automatically sent every 30 seconds after syncUser() is called.
+     * Heartbeats are automatically sent every 20 seconds after syncUser() is called.
      * This helps track active session duration and is handled internally by the SDK.
      *
      * @returns Promise that resolves with heartbeat confirmation

package/dist/index.js

@@ -14,17 +14,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MobiqoEvent = void 0;
 const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
+const react_native_1 = require("react-native");
 var MobiqoEvent_1 = require("./MobiqoEvent");
 Object.defineProperty(exports, "MobiqoEvent", { enumerable: true, get: function () { return MobiqoEvent_1.MobiqoEvent; } });
 /**
- * Mobiqo Analytics Service for Capacitor apps
+ * Mobiqo Analytics Service for React Native apps
  *
  * This service provides analytics tracking, user management, and session handling
  * for mobile applications using the Mobiqo platform.
  *
  * @example
  * ```typescript
- * import Mobiqo, { MobiqoEvent, SyncUserResponse, AppUser } from 'mobiqo-capacitor';
+ * import Mobiqo, { MobiqoEvent, SyncUserResponse, AppUser } from 'mobiqo-react-native';
  *
  * const mobiqo = new Mobiqo();
  * await mobiqo.init({ mobiqoKey: 'your-api-key' });
@@ -32,7 +33,8 @@ Object.defineProperty(exports, "MobiqoEvent", { enumerable: true, get: function
  * // Sync user with optional additional data
  * const result: SyncUserResponse = await mobiqo.syncUser({
  *   revenue_cat_user_id: 'user-123',
- *   additional_data: { plan: 'premium' }
+ *   include_advanced_analysis: true,
+ *   additional_data: { user_id: 'user-123', user_name: 'John Doe', user_email: 'john.doe@example.com', referrer: 'google' }
  * });
  * console.log('User OS:', result.appUser.os);
  * console.log('Purchase intent:', result.statistics.purchase_intent);
@@ -87,17 +89,59 @@ class Mobiqo {
             }
         });
     }
+    /**
+     * Get device model information
+     *
+     * Returns actual device model when possible. For best results, install react-native-device-info:
+     * npm install --save react-native-device-info
+     *
+     * @returns Device model string or 'unknown' if not available
+     * @private
+     */
+    getDeviceModel() {
+        var _a, _b, _c;
+        try {
+            // Try to use react-native-device-info if available (optional peer dependency)
+            try {
+                const DeviceInfo = require('react-native-device-info');
+                // getModel() returns actual device model like "iPhone13,2" on iOS or "SM-G991B" on Android
+                const model = ((_b = (_a = DeviceInfo.default) === null || _a === void 0 ? void 0 : _a.getModel) === null || _b === void 0 ? void 0 : _b.call(_a)) || ((_c = DeviceInfo.getModel) === null || _c === void 0 ? void 0 : _c.call(DeviceInfo));
+                if (model) {
+                    return model;
+                }
+            }
+            catch (e) {
+                // react-native-device-info not installed, fall back to Platform API
+            }
+            // Fallback: Use Platform constants
+            const constants = react_native_1.Platform.constants;
+            if (react_native_1.Platform.OS === 'ios') {
+                // iOS: Try to get device info from constants
+                // Note: This won't give hardware identifier without device-info package
+                return constants.systemName || constants.model || react_native_1.Platform.OS;
+            }
+            else if (react_native_1.Platform.OS === 'android') {
+                // Android: Try to extract model from constants
+                return constants.Model || constants.Brand || react_native_1.Platform.OS;
+            }
+            return react_native_1.Platform.OS || 'unknown';
+        }
+        catch (error) {
+            console.error('Error getting device model:', error);
+            return 'unknown';
+        }
+    }
     /**
      * Sync user data with Mobiqo and start a tracking session
      *
      * This method links a RevenueCat user ID with Mobiqo analytics and starts
-     * automatic heartbeat tracking (every 30 seconds). Call this after user login
+     * automatic heartbeat tracking (every 20 seconds). Call this after user login
      * or when you want to start tracking a user's session.
      *
      * @param options - User sync options
      * @param options.revenue_cat_user_id - The RevenueCat user identifier
      * @param options.include_advanced_analysis - Whether to include advanced analysis in the response (purchase probability and other data, but request takes more time)
-     * @param options.additional_data - Optional extra user data to store (email, plan, etc.)
+     * @param options.additional_data - Optional extra user data to store (email, name, etc.)
      * @returns Promise that resolves with user sync response including user data and statistics
      *
      * @example
@@ -107,9 +151,10 @@ class Mobiqo {
      *   revenue_cat_user_id: 'user-123',
      *   include_advanced_analysis: true,
      *   additional_data: {
-     *     email: 'user@example.com',
-     *     plan: 'premium',
-     *     signupDate: '2024-01-01'
+     *     user_id: 'user-123',
+     *     user_name: 'John Doe',
+     *     user_email: 'user@example.com',
+     *     referrer: 'google',
      *   }
      * });
      *
@@ -127,12 +172,19 @@ class Mobiqo {
                     console.error('Project ID not found');
                     return;
                 }
+                const device_model = this.getDeviceModel();
+                const additionalData = {
+                    id: additional_data === null || additional_data === void 0 ? void 0 : additional_data.user_id,
+                    name: additional_data === null || additional_data === void 0 ? void 0 : additional_data.user_name,
+                    email: additional_data === null || additional_data === void 0 ? void 0 : additional_data.user_email,
+                    referrer: additional_data === null || additional_data === void 0 ? void 0 : additional_data.referrer,
+                };
                 const response = yield fetch(this.API_URL + "/linkUser", {
                     method: "POST",
                     headers: {
                         "Content-Type": "application/json"
                     },
-                    body: JSON.stringify({ revenue_cat_user_id, project_id, include_advanced_analysis, additional_data, local_timestamp: new Date().getTime() })
+                    body: JSON.stringify({ revenue_cat_user_id, project_id, include_advanced_analysis, personal_data: additionalData || {}, device_model, local_timestamp: new Date().getTime() })
                 });
                 const responseData = yield response.json();
                 yield async_storage_1.default.setItem('mobiqo_session_id', responseData.sessionId);
@@ -140,7 +192,7 @@ class Mobiqo {
                 if (!this.heartbeatInterval) {
                     this.heartbeatInterval = setInterval(() => {
                         this.sendHeartbeat();
-                    }, 30000); // 30 seconds
+                    }, 20000); // 20 seconds
                 }
                 return responseData;
             }
@@ -150,6 +202,59 @@ class Mobiqo {
             }
         });
     }
+    /**
+     * Update user data in Mobiqo
+     *
+     * This method allows you to update additional user data for an existing user.
+     * Use this when you want to update user information without creating a new session.
+     *
+     * @param options - User update options
+     * @param options.revenue_cat_user_id - The RevenueCat user identifier
+     * @param options.additional_data - Optional extra user data to update (email, name, etc.)
+     * @returns Promise that resolves when the update is complete
+     *
+     * @example
+     * ```typescript
+     * // Update user data
+     * await mobiqo.updateUser({
+     *   revenue_cat_user_id: 'user-123',
+     *   additional_data: {
+     *     user_id: 'user-123',
+     *     user_name: 'John Doe',
+     *     user_email: 'john.doe@example.com',
+     *     referrer: 'google',
+     *   }
+     * });
+     * ```
+     */
+    updateUser(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ revenue_cat_user_id, additional_data }) {
+            try {
+                const project_id = yield async_storage_1.default.getItem('mobiqo_project_id');
+                if (!project_id) {
+                    console.error('Project ID not found');
+                    return;
+                }
+                const additionalData = {
+                    id: additional_data === null || additional_data === void 0 ? void 0 : additional_data.user_id,
+                    name: additional_data === null || additional_data === void 0 ? void 0 : additional_data.user_name,
+                    email: additional_data === null || additional_data === void 0 ? void 0 : additional_data.user_email,
+                    referrer: additional_data === null || additional_data === void 0 ? void 0 : additional_data.referrer,
+                };
+                const response = yield fetch(this.API_URL + "/updateUser", {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json"
+                    },
+                    body: JSON.stringify({ revenue_cat_user_id, project_id, personal_data: additionalData || {} })
+                });
+                yield response.json();
+            }
+            catch (error) {
+                console.error('Error updating user', error);
+            }
+        });
+    }
     /**
      * Retrieve user information from Mobiqo
      *
@@ -255,7 +360,7 @@ class Mobiqo {
     /**
      * Send a heartbeat to maintain the user session
      *
-     * Heartbeats are automatically sent every 30 seconds after syncUser() is called.
+     * Heartbeats are automatically sent every 20 seconds after syncUser() is called.
      * This helps track active session duration and is handled internally by the SDK.
      *
      * @returns Promise that resolves with heartbeat confirmation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mobiqo-react-native",
-  "version": "0.0.8",
+  "version": "1.0.0",
   "description": "Mobiqo SDK for Capacitor apps - Mobile analytics and user tracking",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -47,5 +47,10 @@
   "peerDependencies": {
     "@react-native-async-storage/async-storage": ">=1.19.0"
   },
+  "peerDependenciesMeta": {
+    "react-native-device-info": {
+      "optional": true
+    }
+  },
   "dependencies": {}
 }