mobiqo-react-native 0.0.7 → 0.0.10

package/README.md

@@ -52,6 +52,7 @@ await mobiqo.init({ mobiqoKey: 'your-mobiqo-api-key' });
 // With additional data (optional)
 await mobiqo.syncUser({
   revenue_cat_user_id: 'user-123',
+  include_advanced_analysis: false,
   additional_data: {
     email: 'user@example.com',
     plan: 'premium'
@@ -85,13 +86,14 @@ await mobiqo.trackEvent('screen_opened', MobiqoEvent.SCREEN_VIEW);
 
 ```typescript
 const userInfo = await mobiqo.getUserInfo({
-  revenue_cat_user_id: 'user-123'
+  revenue_cat_user_id: 'user-123',
+  include_advanced_analysis: true
 });
 ```
 
 ### 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
 
@@ -104,11 +106,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
 
 #### `getUserInfo(options)`
 Retrieve user information from Mobiqo.
 - `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)
 
 #### `trackEvent(event, eventType, additionalData?)`
 Track custom events.
@@ -176,7 +180,7 @@ interface AppUser {
 ```typescript
 interface Statistics {
   purchasing_power_parity: number;
-  purchase_probability: number;
+  purchase_intent: number;
   avg_arpu: number;
   avg_arppu: number;
   avg_ltv: number;

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 */
@@ -35,8 +37,8 @@ export interface AppUser {
 export interface Statistics {
     /** Purchasing power parity score */
     purchasing_power_parity: number;
-    /** Predicted probability of making a purchase */
-    purchase_probability: number;
+    /** Predicted intent to make a purchase */
+    purchase_intent: number;
     /** Average revenue per user */
     avg_arpu: number;
     /** Average revenue per paying user */
@@ -83,7 +85,7 @@ export interface GetUserInfoResponse {
  *   additional_data: { plan: 'premium' }
  * });
  * console.log('User OS:', result.appUser.os);
- * console.log('Purchase probability:', result.statistics.purchase_probability);
+ * console.log('Purchase intent:', result.statistics.purchase_intent);
  *
  * // Track events with optional additional data
  * await mobiqo.trackEvent('button_clicked', MobiqoEvent.CLICK, { screen: 'home' });
@@ -112,23 +114,35 @@ 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 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.)
      * @returns Promise that resolves with user sync response including user data and statistics
      *
      * @example
      * ```typescript
-     * // With additional data
+     * // With additional data and advanced analysis
      * await mobiqo.syncUser({
      *   revenue_cat_user_id: 'user-123',
+     *   include_advanced_analysis: true,
      *   additional_data: {
      *     email: 'user@example.com',
      *     plan: 'premium',
@@ -136,14 +150,15 @@ export default class Mobiqo {
      *   }
      * });
      *
-     * // Without additional data
+     * // Without additional data and advanced analysis
      * await mobiqo.syncUser({
      *   revenue_cat_user_id: 'user-123'
      * });
      * ```
      */
-    syncUser({ revenue_cat_user_id, additional_data }: {
+    syncUser({ revenue_cat_user_id, include_advanced_analysis, additional_data }: {
         revenue_cat_user_id: string;
+        include_advanced_analysis?: boolean;
         additional_data?: Record<string, any>;
     }): Promise<SyncUserResponse | undefined>;
     /**
@@ -154,19 +169,22 @@ export default class Mobiqo {
      *
      * @param options - User lookup options
      * @param options.revenue_cat_user_id - The RevenueCat user identifier to look up
+     * @param options.include_advanced_analysis - Whether to include advanced analysis in the response (purchase probability and other data, but request takes more time)
      * @returns Promise that resolves with user information including user data and statistics
      *
      * @example
      * ```typescript
      * const userInfo = await mobiqo.getUserInfo({
-     *   revenue_cat_user_id: 'user-123'
+     *   revenue_cat_user_id: 'user-123',
+     *   include_advanced_analysis: true
      * });
      * console.log('User OS:', userInfo.appUser.os);
-     * console.log('Purchase probability:', userInfo.statistics.purchase_probability);
+     * console.log('Purchase intent:', userInfo.statistics.purchase_intent);
      * ```
      */
-    getUserInfo({ revenue_cat_user_id }: {
+    getUserInfo({ revenue_cat_user_id, include_advanced_analysis }: {
         revenue_cat_user_id: string;
+        include_advanced_analysis?: boolean;
     }): Promise<GetUserInfoResponse | undefined>;
     /**
      * Track a custom event with Mobiqo analytics
@@ -199,7 +217,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,6 +14,7 @@ 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; } });
 /**
@@ -35,7 +36,7 @@ Object.defineProperty(exports, "MobiqoEvent", { enumerable: true, get: function
  *   additional_data: { plan: 'premium' }
  * });
  * console.log('User OS:', result.appUser.os);
- * console.log('Purchase probability:', result.statistics.purchase_probability);
+ * console.log('Purchase intent:', result.statistics.purchase_intent);
  *
  * // Track events with optional additional data
  * await mobiqo.trackEvent('button_clicked', MobiqoEvent.CLICK, { screen: 'home' });
@@ -87,23 +88,67 @@ class Mobiqo {
             }
         });
     }
+    /**
+     * Get device model information
+     *
+     * Returns actual device model when possible. For best results, install react-native-device-info:
+     * npm install 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.)
      * @returns Promise that resolves with user sync response including user data and statistics
      *
      * @example
      * ```typescript
-     * // With additional data
+     * // With additional data and advanced analysis
      * await mobiqo.syncUser({
      *   revenue_cat_user_id: 'user-123',
+     *   include_advanced_analysis: true,
      *   additional_data: {
      *     email: 'user@example.com',
      *     plan: 'premium',
@@ -111,26 +156,27 @@ class Mobiqo {
      *   }
      * });
      *
-     * // Without additional data
+     * // Without additional data and advanced analysis
      * await mobiqo.syncUser({
      *   revenue_cat_user_id: 'user-123'
      * });
      * ```
      */
     syncUser(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ revenue_cat_user_id, additional_data }) {
+        return __awaiter(this, arguments, void 0, function* ({ revenue_cat_user_id, include_advanced_analysis, 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 device_model = this.getDeviceModel();
                 const response = yield fetch(this.API_URL + "/linkUser", {
                     method: "POST",
                     headers: {
                         "Content-Type": "application/json"
                     },
-                    body: JSON.stringify({ revenue_cat_user_id, project_id, additional_data, local_timestamp: new Date().getTime() })
+                    body: JSON.stringify({ revenue_cat_user_id, project_id, include_advanced_analysis, additional_data, device_model, local_timestamp: new Date().getTime() })
                 });
                 const responseData = yield response.json();
                 yield async_storage_1.default.setItem('mobiqo_session_id', responseData.sessionId);
@@ -138,7 +184,7 @@ class Mobiqo {
                 if (!this.heartbeatInterval) {
                     this.heartbeatInterval = setInterval(() => {
                         this.sendHeartbeat();
-                    }, 30000); // 30 seconds
+                    }, 20000); // 20 seconds
                 }
                 return responseData;
             }
@@ -156,19 +202,21 @@ class Mobiqo {
      *
      * @param options - User lookup options
      * @param options.revenue_cat_user_id - The RevenueCat user identifier to look up
+     * @param options.include_advanced_analysis - Whether to include advanced analysis in the response (purchase probability and other data, but request takes more time)
      * @returns Promise that resolves with user information including user data and statistics
      *
      * @example
      * ```typescript
      * const userInfo = await mobiqo.getUserInfo({
-     *   revenue_cat_user_id: 'user-123'
+     *   revenue_cat_user_id: 'user-123',
+     *   include_advanced_analysis: true
      * });
      * console.log('User OS:', userInfo.appUser.os);
-     * console.log('Purchase probability:', userInfo.statistics.purchase_probability);
+     * console.log('Purchase intent:', userInfo.statistics.purchase_intent);
      * ```
      */
     getUserInfo(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ revenue_cat_user_id }) {
+        return __awaiter(this, arguments, void 0, function* ({ revenue_cat_user_id, include_advanced_analysis }) {
             try {
                 const project_id = yield async_storage_1.default.getItem('mobiqo_project_id');
                 if (!project_id) {
@@ -180,7 +228,7 @@ class Mobiqo {
                     headers: {
                         "Content-Type": "application/json"
                     },
-                    body: JSON.stringify({ revenue_cat_user_id })
+                    body: JSON.stringify({ revenue_cat_user_id, project_id, include_advanced_analysis })
                 });
                 const responseData = yield response.json();
                 return responseData;
@@ -251,7 +299,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.7",
+  "version": "0.0.10",
   "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": {}
 }