mixpanel-react-native 1.3.10 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 #
 
+## [v1.4.0](https://github.com/mixpanel/mixpanel-react-native/tree/v1.4.0) (2022-05-06)
+
+### Enhancements
+
+- Bump to latest ios and android sdk versions and remove android people identify\(deprecated\) [\#137](https://github.com/mixpanel/mixpanel-react-native/pull/137)
+- Allow disable flush on background [\#135](https://github.com/mixpanel/mixpanel-react-native/pull/135)
+- Adds  a new API `getDeviceId` for React Native [\#134](https://github.com/mixpanel/mixpanel-react-native/pull/134)
+
+#
+
 ## [v1.3.10](https://github.com/mixpanel/mixpanel-react-native/tree/v1.3.10) (2022-03-26)
 
 ### Enhancements
@@ -43,17 +53,6 @@
 
 ## [v1.3.5](https://github.com/mixpanel/mixpanel-react-native/tree/v1.3.5) (2022-01-04)
 
-**Closed issues:**
-
-- iOS app crashes when `optOutTrackingDefault` is set - `Assertion failed: You have to call initialize\(token:\) before calling the main instance, or define a new main instance if removing the main one` [\#114](https://github.com/mixpanel/mixpanel-react-native/issues/114)
-- Cannot get users properties? [\#113](https://github.com/mixpanel/mixpanel-react-native/issues/113)
-- Users shows undefined Email of tracked user [\#112](https://github.com/mixpanel/mixpanel-react-native/issues/112)
-- FirstAppOpen event not triggered from iOS [\#111](https://github.com/mixpanel/mixpanel-react-native/issues/111)
-- Set user properties [\#107](https://github.com/mixpanel/mixpanel-react-native/issues/107)
-- Events missing on web dashboard. [\#106](https://github.com/mixpanel/mixpanel-react-native/issues/106)
-- Feature Request: functionality to get promise on mixpanel.track\(\) [\#105](https://github.com/mixpanel/mixpanel-react-native/issues/105)
-- "TS2554: Expected 1 arguments, but got 0." error when implementing Samples/ContextAPIMixpanel/Analytics.js [\#86](https://github.com/mixpanel/mixpanel-react-native/issues/86)
-
 **Merged pull requests:**
 
 - nested dictionary should be a valid type in iOS [\#119](https://github.com/mixpanel/mixpanel-react-native/pull/119)
@@ -65,14 +64,6 @@
 
 ## [v1.3.4](https://github.com/mixpanel/mixpanel-react-native/tree/v1.3.4) (2021-09-25)
 
-**Closed issues:**
-
-- ANDROID\_NDK\_HOME error when building Android with version 1.3.3 [\#101](https://github.com/mixpanel/mixpanel-react-native/issues/101)
-- \[Android\] Build fails after Maven migration [\#94](https://github.com/mixpanel/mixpanel-react-native/issues/94)
-- \[Android\] Mixpanel not working after upgrading React Native to 0.65.0 [\#93](https://github.com/mixpanel/mixpanel-react-native/issues/93)
-- Mixpanel.library is always displayed react-native [\#92](https://github.com/mixpanel/mixpanel-react-native/issues/92)
-- App Session events don't seem to be logged after v1.2.4 [\#91](https://github.com/mixpanel/mixpanel-react-native/issues/91)
-
 **Merged pull requests:**
 
 - Bump native SDK dependencies [\#102](https://github.com/mixpanel/mixpanel-react-native/pull/102)
@@ -86,13 +77,6 @@
 - Enable automatic events in iOS [\#99](https://github.com/mixpanel/mixpanel-react-native/pull/99)
 - replace JCenter with Maven [\#95](https://github.com/mixpanel/mixpanel-react-native/pull/95)
 
-**Closed issues:**
-
-- library not found for -lMixpanelReactNative for iOS [\#96](https://github.com/mixpanel/mixpanel-react-native/issues/96)
-- mixpanel.register not supported in react-native library [\#90](https://github.com/mixpanel/mixpanel-react-native/issues/90)
-- Mixpanel.addPushDeviceToken ? [\#89](https://github.com/mixpanel/mixpanel-react-native/issues/89)
-- Are the types correct on the latest version? [\#83](https://github.com/mixpanel/mixpanel-react-native/issues/83)
-
 **Merged pull requests:**
 
 - Bump tmpl from 1.0.4 to 1.0.5 in /Samples/ContextAPIMixpanel [\#100](https://github.com/mixpanel/mixpanel-react-native/pull/100)
@@ -110,15 +94,6 @@
 
 - Add constructor method type definition [\#85](https://github.com/mixpanel/mixpanel-react-native/pull/85)
 
-**Closed issues:**
-
-- Failed resolution of: Lcom/google/firebase/iid/FirebaseInstanceId [\#75](https://github.com/mixpanel/mixpanel-react-native/issues/75)
-- It only track on Android in iOS nothing at all [\#72](https://github.com/mixpanel/mixpanel-react-native/issues/72)
-- Mixpanel React Native is null [\#71](https://github.com/mixpanel/mixpanel-react-native/issues/71)
-- Are the documented initializations correct? [\#70](https://github.com/mixpanel/mixpanel-react-native/issues/70)
-- Getting "MixpanelReactNative is null" on fresh install [\#46](https://github.com/mixpanel/mixpanel-react-native/issues/46)
-- Example using ContextAPI and functional components [\#17](https://github.com/mixpanel/mixpanel-react-native/issues/17)
-
 #
 
 ## [v1.3.1](https://github.com/mixpanel/mixpanel-react-native/tree/v1.3.1) (2021-07-29)
@@ -127,10 +102,6 @@
 
 - Fix the inconsistency typescript definition of init [\#78](https://github.com/mixpanel/mixpanel-react-native/pull/78)
 
-**Closed issues:**
-
-- confusion re documentation [\#77](https://github.com/mixpanel/mixpanel-react-native/issues/77)
-
 **Merged pull requests:**
 
 - Add more sample apps for integrating Mixpanel including using Context API [\#79](https://github.com/mixpanel/mixpanel-react-native/pull/79)
@@ -139,11 +110,6 @@
 
 ## [v1.3.0](https://github.com/mixpanel/mixpanel-react-native/tree/v1.3.0) (2021-07-28)
 
-**Closed issues:**
-
-- Xcode 12.5.1 linking issue [\#68](https://github.com/mixpanel/mixpanel-react-native/issues/68)
-- It only track on iOS in Android nothing at all [\#56](https://github.com/mixpanel/mixpanel-react-native/issues/56)
-
 **Merged pull requests:**
 
 - Deprecate the class method init\(\) and improve the example [\#76](https://github.com/mixpanel/mixpanel-react-native/pull/76)
@@ -152,12 +118,6 @@
 
 ## [v1.2.4](https://github.com/mixpanel/mixpanel-react-native/tree/v1.2.4) (2021-06-24)
 
-**Closed issues:**
-
-- A lot of "undefined symbol" errors happening with the latest version [\#64](https://github.com/mixpanel/mixpanel-react-native/issues/64)
-- Tracking and Identifying Oh My! [\#60](https://github.com/mixpanel/mixpanel-react-native/issues/60)
-- why is firebase-messaging listed as a dependency?  [\#55](https://github.com/mixpanel/mixpanel-react-native/issues/55)
-
 **Merged pull requests:**
 
 - Polish README [\#67](https://github.com/mixpanel/mixpanel-react-native/pull/67)
@@ -167,18 +127,55 @@
 - Add a CHANGELOG placeholder [\#62](https://github.com/mixpanel/mixpanel-react-native/pull/62)
 - Add github workflow for auto release [\#61](https://github.com/mixpanel/mixpanel-react-native/pull/61)
 
+#
 
+## [v1.2.3](https://github.com/mixpanel/mixpanel-react-native/tree/v1.2.3) (2021-05-20)
 
+- Bump Mixpanel Andriod dependency to 5.9.1 (Migrate to Airship 12.x for the integration)
+https://github.com/mixpanel/mixpanel-react-native/pull/59
 
+#
 
+## [v1.2.2](https://github.com/mixpanel/mixpanel-react-native/tree/v1.2.2) (2021-05-08)
 
+- Fix Mixpanel type conversion for ios
+https://github.com/mixpanel/mixpanel-react-native/pull/48
+- Fix iOS compile error
+https://github.com/mixpanel/mixpanel-react-native/pull/53
 
+#
 
+## [v1.2.0](https://github.com/mixpanel/mixpanel-react-native/tree/v1.2.0) (2021-05-03)
 
+- Add new settings APIs: setUseIpAddressForGeolocation, setLoggingEnabled(add android), setServerURL(add android)
+https://github.com/mixpanel/mixpanel-react-native/pull/44
 
+#
 
+## [v1.1.1](https://github.com/mixpanel/mixpanel-react-native/tree/v1.1.1) (2021-03-17)
+- Fix the issue of passing boolean value as int in iOS
+https://github.com/mixpanel/mixpanel-react-native/pull/34
 
+#
+
+## [v1.1.0](https://github.com/mixpanel/mixpanel-react-native/tree/v1.1.0) (2021-03-03)
+- Add Typescript support
+- https://github.com/mixpanel/mixpanel-react-native/pull/31. thanks @sroy3 !
+
+#
+
+## [v1.0.2](https://github.com/mixpanel/mixpanel-react-native/tree/v1.0.2) (2021-01-27)
+- Fix dynamic type not being able to convert properly in android that causes some group apis to fail 
+PR: https://github.com/mixpanel/mixpanel-react-native/pull/23
+This is to address issue: https://github.com/mixpanel/mixpanel-react-native/issues/21
+
+#
 
+## [v1.0.0](https://github.com/mixpanel/mixpanel-react-native/tree/v1.0.0) (2020-12-08)
+- This is our first release! :tada::tada::tada: 
+Report issues or give us any feedback is appreciated!
+- integration guide: https://developer.mixpanel.com/docs/react-native
+- full API reference: https://mixpanel.github.io/mixpanel-react-native
 
 
 

package/MixpanelReactNative.podspec

@@ -19,5 +19,5 @@ Pod::Spec.new do |s|
   s.pod_target_xcconfig = { 'DEFINES_MODULE' => 'YES' }  
   
   s.dependency "React"
-  s.dependency "Mixpanel-swift", '3.1.5'
+  s.dependency "Mixpanel-swift", '3.2.5'
 end

package/Samples/SimpleMixpanel/android/.project

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <projectDescription>
-	<name>android</name>
+	<name>SimpleMixpanel</name>
 	<comment>Project android created by Buildship.</comment>
 	<projects>
 	</projects>
@@ -16,7 +16,7 @@
 	</natures>
 	<filteredResources>
 		<filter>
-			<id>1632526110607</id>
+			<id>0</id>
 			<name></name>
 			<type>30</type>
 			<matcher>

package/__tests__/index.test.js

@@ -9,13 +9,13 @@ import { NativeModules } from 'react-native';
 
 test(`it calls MixpanelReactNative initialize`, async () => {
   const mixpanel = await Mixpanel.init("token");
-  expect(NativeModules.MixpanelReactNative.initialize).toBeCalledWith("token", false, {"$lib_version": "1.3.10", "mp_lib": "react-native"});
+  expect(NativeModules.MixpanelReactNative.initialize).toBeCalledWith("token", false, {"$lib_version": "1.4.0", "mp_lib": "react-native"});
 });
 
 test(`it calls MixpanelReactNative initialize with optOut and superProperties`, async () => {
   const mixpanel = new Mixpanel("token");
   mixpanel.init(true, {"super": "property"})
-  expect(NativeModules.MixpanelReactNative.initialize).toBeCalledWith("token", true, {"$lib_version": "1.3.10", "mp_lib": "react-native", "super": "property"});
+  expect(NativeModules.MixpanelReactNative.initialize).toBeCalledWith("token", true, {"$lib_version": "1.4.0", "mp_lib": "react-native", "super": "property"});
 });
 
 test(`it calls MixpanelReactNative setServerURL`, async () => {

package/__tests__/jest_setup.js

@@ -20,6 +20,7 @@ jest.doMock('react-native', () => {
           initialize: jest.fn(),
           setServerURL: jest.fn(),
           setLoggingEnabled: jest.fn(),
+          setFlushOnBackground: jest.fn(),
           setUseIpAddressForGeolocation: jest.fn(),
           hasOptedOutTracking: jest.fn(),
           optInTracking: jest.fn(),

package/android/build.gradle

@@ -34,5 +34,5 @@ repositories {
 
 dependencies {
     implementation 'com.facebook.react:react-native:+'
-    implementation 'com.mixpanel.android:mixpanel-android:6.0.0'
+    implementation 'com.mixpanel.android:mixpanel-android:6.2.0'
 }

package/android/src/main/java/com/mixpanel/reactnative/MixpanelReactNativeModule.java

@@ -98,7 +98,6 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token);
         synchronized (instance) {
             instance.identify(distinctId);
-            instance.getPeople().identify(distinctId);
             promise.resolve(null);
         }
     }
@@ -111,6 +110,14 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
         }
     }
 
+    @ReactMethod
+    public void getDeviceId(final String token, Promise promise) {
+        MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token);
+        synchronized (instance) {
+            promise.resolve(instance.getAnonymousId());
+        }
+    }
+
     @ReactMethod
     public void track(final String token, final String eventName, ReadableMap properties, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token);

package/docs/Mixpanel.html

@@ -445,7 +445,7 @@ Initializes Mixpanel and return an instance of Mixpanel the given project token.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line289">line 289</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line304">line 304</a>
     </li></ul></dd>
     
 
@@ -612,7 +612,7 @@ People.identify() if you wish the new alias to be used for Events and People.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line190">line 190</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line205">line 205</a>
     </li></ul></dd>
     
 
@@ -705,7 +705,7 @@ superProperties registered before the clearSuperProperties method was called.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line397">line 397</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line412">line 412</a>
     </li></ul></dd>
     
 
@@ -867,7 +867,7 @@ to Group Analytics using the same group value will create and store new values.<
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line317">line 317</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line332">line 332</a>
     </li></ul></dd>
     
 
@@ -1004,7 +1004,7 @@ to Group Analytics using the same group value will create and store new values.<
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line422">line 422</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line437">line 437</a>
     </li></ul></dd>
     
 
@@ -1120,7 +1120,103 @@ send all remaining messages to the server.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line464">line 464</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line497">line 497</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+        
+            
+
+    
+
+    
+    <h4 class="name" id="getDeviceId"><span class="type-signature"></span>getDeviceId<span class="signature">()</span><span class="type-signature"> &rarr; {Promise.&lt;string>}</span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    Returns the current device id of the device.
+This id automatically generated by the library and regenerated when logout or reset is called.
+
+example of usage:
+<pre>
+<code>
+const deviceId = await mixpanel.getDeviceId();
+</code>
+</pre>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line484">line 484</a>
     </li></ul></dd>
     
 
@@ -1145,6 +1241,28 @@ send all remaining messages to the server.
 
 
 
+<h5>Returns:</h5>
+
+        
+<div class="param-desc">
+    A Promise to the device id
+</div>
+
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Promise.&lt;string></span>
+
+
+    </dd>
+</dl>
+
+    
 
 
 
@@ -1216,7 +1334,7 @@ const distinctId = await mixpanel.getDistinctId();
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line451">line 451</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line466">line 466</a>
     </li></ul></dd>
     
 
@@ -1399,7 +1517,7 @@ Group Analytics properties.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line279">line 279</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line294">line 294</a>
     </li></ul></dd>
     
 
@@ -1499,7 +1617,7 @@ People Analytics properties.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line229">line 229</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line244">line 244</a>
     </li></ul></dd>
     
 
@@ -1613,7 +1731,7 @@ and persist beyond the lifetime of your application.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line385">line 385</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line400">line 400</a>
     </li></ul></dd>
     
 
@@ -1723,7 +1841,7 @@ and persist beyond the lifetime of your application.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line127">line 127</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line142">line 142</a>
     </li></ul></dd>
     
 
@@ -1894,7 +2012,7 @@ your application.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line170">line 170</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line185">line 185</a>
     </li></ul></dd>
     
 
@@ -2144,7 +2262,7 @@ This method will internally track an opt-in event to your project.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line137">line 137</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line152">line 152</a>
     </li></ul></dd>
     
 
@@ -2236,7 +2354,7 @@ This method will also remove any user-related information from the device.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line148">line 148</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line163">line 163</a>
     </li></ul></dd>
     
 
@@ -2383,7 +2501,7 @@ to remove a superProperty, call unregisterSuperProperty() or clearSuperPropertie
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line339">line 339</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line354">line 354</a>
     </li></ul></dd>
     
 
@@ -2523,7 +2641,7 @@ same names has already been registered.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line354">line 354</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line369">line 369</a>
     </li></ul></dd>
     
 
@@ -2683,7 +2801,7 @@ same names has already been registered.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line302">line 302</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line317">line 317</a>
     </li></ul></dd>
     
 
@@ -2772,7 +2890,145 @@ same names has already been registered.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line433">line 433</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line448">line 448</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+        
+            
+
+    
+
+    
+    <h4 class="name" id="setFlushOnBackground"><span class="type-signature"></span>setFlushOnBackground<span class="signature">(flushOnBackground)</span><span class="type-signature"></span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    This allows enabling or disabling whether or not Mixpanel flushes events
+when the app enters the background on iOS. This is set to true by default.
+</div>
+
+
+
+
+
+
+
+
+
+    <h5>Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>flushOnBackground</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">boolean</span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last">whether to enable logging</td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line116">line 116</a>
     </li></ul></dd>
     
 
@@ -2932,7 +3188,7 @@ same names has already been registered.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line263">line 263</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line278">line 278</a>
     </li></ul></dd>
     
 
@@ -3350,7 +3606,7 @@ Defaults to true.</td>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line118">line 118</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line133">line 133</a>
     </li></ul></dd>
     
 
@@ -3489,7 +3745,7 @@ property, representing the number of seconds between your calls.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line408">line 408</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line423">line 423</a>
     </li></ul></dd>
     
 
@@ -3655,7 +3911,7 @@ that event.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line212">line 212</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line227">line 227</a>
     </li></ul></dd>
     
 
@@ -3844,7 +4100,7 @@ that event. Group key/value pairs are upserted into the property map before trac
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line247">line 247</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line262">line 262</a>
     </li></ul></dd>
     
 
@@ -3985,7 +4241,7 @@ To clear all superProperties, use clearSuperProperties()
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line370">line 370</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line385">line 385</a>
     </li></ul></dd>
     
 
@@ -4037,7 +4293,7 @@ To clear all superProperties, use clearSuperProperties()
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Mar 25 2022 17:36:42 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri May 06 2022 10:59:40 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

package/docs/MixpanelGroup.html

@@ -95,7 +95,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line681">line 681</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line714">line 714</a>
     </li></ul></dd>
     
 
@@ -284,7 +284,7 @@ If the property exists and is not list-valued, the remove will be ignored.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line752">line 752</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line785">line 785</a>
     </li></ul></dd>
     
 
@@ -446,7 +446,7 @@ possibly overwriting an existing property with the same name.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line700">line 700</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line733">line 733</a>
     </li></ul></dd>
     
 
@@ -606,7 +606,7 @@ possibly overwriting an existing property with the same name.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line719">line 719</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line752">line 752</a>
     </li></ul></dd>
     
 
@@ -768,7 +768,7 @@ If the property exists and is not list-valued, the union will be ignored.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line768">line 768</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line801">line 801</a>
     </li></ul></dd>
     
 
@@ -905,7 +905,7 @@ If the property exists and is not list-valued, the union will be ignored.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line737">line 737</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line770">line 770</a>
     </li></ul></dd>
     
 
@@ -957,7 +957,7 @@ If the property exists and is not list-valued, the union will be ignored.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Mar 25 2022 17:36:42 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri May 06 2022 10:59:40 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

package/docs/People.html

@@ -100,7 +100,7 @@ call to identify using a different id.</div>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line480">line 480</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line513">line 513</a>
     </li></ul></dd>
     
 
@@ -289,7 +289,7 @@ currently have a list value, the append will be ignored.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line571">line 571</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line604">line 604</a>
     </li></ul></dd>
     
 
@@ -377,7 +377,7 @@ currently have a list value, the append will be ignored.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line661">line 661</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line694">line 694</a>
     </li></ul></dd>
     
 
@@ -468,7 +468,7 @@ to People Analytics using the same distinct id will create and store new values.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line671">line 671</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line704">line 704</a>
     </li></ul></dd>
     
 
@@ -630,7 +630,7 @@ provide a negative number for the value.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line539">line 539</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line572">line 572</a>
     </li></ul></dd>
     
 
@@ -792,7 +792,7 @@ If the property exists and is not list-valued, the remove will be ignored.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line615">line 615</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line648">line 648</a>
     </li></ul></dd>
     
 
@@ -954,7 +954,7 @@ possibly overwriting an existing property with the same name.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line497">line 497</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line530">line 530</a>
     </li></ul></dd>
     
 
@@ -1114,7 +1114,7 @@ possibly overwriting an existing property with the same name.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line516">line 516</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line549">line 549</a>
     </li></ul></dd>
     
 
@@ -1274,7 +1274,7 @@ possibly overwriting an existing property with the same name.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line647">line 647</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line680">line 680</a>
     </li></ul></dd>
     
 
@@ -1436,7 +1436,7 @@ If the property exists and is not list-valued, the union will be ignored.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line594">line 594</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line627">line 627</a>
     </li></ul></dd>
     
 
@@ -1573,7 +1573,7 @@ If the property exists and is not list-valued, the union will be ignored.
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="index.js.html">index.js</a>, <a href="index.js.html#line634">line 634</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line667">line 667</a>
     </li></ul></dd>
     
 
@@ -1625,7 +1625,7 @@ If the property exists and is not list-valued, the union will be ignored.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Mar 25 2022 17:36:42 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri May 06 2022 10:59:40 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

package/docs/index.html

@@ -175,7 +175,7 @@ Please refer to our  <a href="https://mixpanel.com/legal/app-store-privacy-detai
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Mar 25 2022 17:36:42 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri May 06 2022 10:59:40 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

package/docs/index.js.html

@@ -134,6 +134,21 @@ export class Mixpanel {
         MixpanelReactNative.setLoggingEnabled(this.token, loggingEnabled);
     }
 
+     /**
+     * This allows enabling or disabling whether or not Mixpanel flushes events
+     * when the app enters the background on iOS. This is set to true by default. 
+     *
+     * @param {boolean} flushOnBackground whether to enable logging
+     *
+     */
+    setFlushOnBackground(flushOnBackground) {
+        if (Platform.OS === 'ios') {
+            MixpanelReactNative.setFlushOnBackground(this.token, flushOnBackground);
+        } else {
+            console.warn('Mixpanel setFlushOnBackground was called and ignored because this method only works on iOS.')
+        }
+    }
+
     /**
      * This controls whether to automatically send the client IP Address as part of event tracking.
      * With an IP address, geo-location is possible down to neighborhoods within a city,
@@ -480,6 +495,24 @@ export class Mixpanel {
         return MixpanelReactNative.getDistinctId(this.token);
     }
 
+    /**
+     * Returns the current device id of the device.
+     * This id automatically generated by the library and regenerated when logout or reset is called.
+     *
+     * example of usage:
+     * <pre>
+     * <code>
+     * const deviceId = await mixpanel.getDeviceId();
+     * </code>
+     * </pre>
+     *
+     * @return {Promise<string>} A Promise to the device id
+     *
+     */
+    getDeviceId() {
+        return MixpanelReactNative.getDeviceId(this.token);
+    }
+
     /**
      * Push all queued Mixpanel events and People Analytics changes to Mixpanel servers.
      *
@@ -889,7 +922,7 @@ class ObjectHelper {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Mar 25 2022 17:36:42 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri May 06 2022 10:59:40 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

package/index.d.ts

@@ -7,6 +7,8 @@ export class Mixpanel {
     init(optOutTrackingDefault?: boolean, superProperties?: MixpanelProperties): Promise<void>;
     setServerURL(serverURL: string): void;
     setLoggingEnabled(loggingEnabled: boolean): void;
+    setFlushOnBackground(flushOnBackground: boolean): void;
+
     setUseIpAddressForGeolocation(useIpAddressForGeolocation: boolean): void;
     hasOptedOutTracking(): Promise<boolean>;
     optInTracking(): void;
@@ -30,6 +32,7 @@ export class Mixpanel {
     eventElapsedTime(eventName: string): Promise<number>;
     reset(): void;
     getDistinctId(): Promise<string>;
+    getDeviceId(): Promise<string>;
     flush(): void;
 }
 

package/index.js

@@ -106,6 +106,21 @@ export class Mixpanel {
         MixpanelReactNative.setLoggingEnabled(this.token, loggingEnabled);
     }
 
+     /**
+     * This allows enabling or disabling whether or not Mixpanel flushes events
+     * when the app enters the background on iOS. This is set to true by default. 
+     *
+     * @param {boolean} flushOnBackground whether to enable logging
+     *
+     */
+    setFlushOnBackground(flushOnBackground) {
+        if (Platform.OS === 'ios') {
+            MixpanelReactNative.setFlushOnBackground(this.token, flushOnBackground);
+        } else {
+            console.warn('Mixpanel setFlushOnBackground was called and ignored because this method only works on iOS.')
+        }
+    }
+
     /**
      * This controls whether to automatically send the client IP Address as part of event tracking.
      * With an IP address, geo-location is possible down to neighborhoods within a city,
@@ -452,6 +467,24 @@ export class Mixpanel {
         return MixpanelReactNative.getDistinctId(this.token);
     }
 
+    /**
+     * Returns the current device id of the device.
+     * This id automatically generated by the library and regenerated when logout or reset is called.
+     *
+     * example of usage:
+     * <pre>
+     * <code>
+     * const deviceId = await mixpanel.getDeviceId();
+     * </code>
+     * </pre>
+     *
+     * @return {Promise<string>} A Promise to the device id
+     *
+     */
+    getDeviceId() {
+        return MixpanelReactNative.getDeviceId(this.token);
+    }
+
     /**
      * Push all queued Mixpanel events and People Analytics changes to Mixpanel servers.
      *

package/ios/MixpanelReactNative.m

@@ -12,6 +12,8 @@ RCT_EXTERN_METHOD(setServerURL:(NSString *)token serverURL:(NSString *)serverURL
 
 RCT_EXTERN_METHOD(setLoggingEnabled:(NSString *)token loggingEnabled:(BOOL)loggingEnabled resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(setFlushOnBackground:(NSString *)token flushOnBackground:(BOOL)flushOnBackground resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
+
 RCT_EXTERN_METHOD(setUseIpAddressForGeolocation:(NSString *)token useIpAddressForGeolocation:(BOOL)useIpAddressForGeolocation resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
 
 // MARK: - Opting Users Out of Tracking
@@ -44,6 +46,8 @@ RCT_EXTERN_METHOD(reset:(NSString *)token resolver:(RCTPromiseResolveBlock)resol
 
 RCT_EXTERN_METHOD(getDistinctId:(NSString *)token resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(getDeviceId:(NSString *)token resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
+
 // MARK: - Super Properties
 
 RCT_EXTERN_METHOD(registerSuperProperties:(NSString *)token properties:(NSDictionary *)properties resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)

package/ios/MixpanelReactNative.swift

@@ -44,6 +44,16 @@ open class MixpanelReactNative: NSObject {
         resolve(nil)
     }
 
+    @objc
+    func setFlushOnBackground(_ token: String,
+                    flushOnBackground: Bool,
+                    resolver resolve: RCTPromiseResolveBlock,
+                    rejecter reject: RCTPromiseRejectBlock) -> Void {
+        let instance = MixpanelReactNative.getMixpanelInstance(token)
+        instance?.flushOnBackground = flushOnBackground
+        resolve(nil)
+    }
+
     @objc
     func setUseIpAddressForGeolocation(_ token: String,
                     useIpAddressForGeolocation: Bool,
@@ -155,6 +165,13 @@ open class MixpanelReactNative: NSObject {
         let instance = MixpanelReactNative.getMixpanelInstance(token)
         resolve(instance?.distinctId)
     }
+
+    @objc
+    func getDeviceId(_ token: String, resolver resolve: RCTPromiseResolveBlock,
+                       rejecter reject: RCTPromiseRejectBlock) -> Void {
+        let instance = MixpanelReactNative.getMixpanelInstance(token)
+        resolve(instance?.anonymousId)
+    }
     
     // MARK: - Super Properties
     

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mixpanel-react-native",
-    "version": "1.3.10",
+    "version": "1.4.0",
     "description": "Official React Native Tracking Library for Mixpanel Analytics",
     "main": "index.js",
     "scripts": {