mixpanel-react-native 2.2.5 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 #
 
+## [v2.3.0](https://github.com/mixpanel/mixpanel-react-native/tree/v2.3.0) (2023-06-16)
+
+### Enhancements
+
+- Returning Promise for the identify\(\) to avoid race condition [\#200](https://github.com/mixpanel/mixpanel-react-native/pull/200)
+
+### Fixes
+
+- Fix null reference used for synchronization \(monitor-enter\) [\#199](https://github.com/mixpanel/mixpanel-react-native/pull/199)
+- fix initialize was called with 4 arguments but expects 5 arguments [\#198](https://github.com/mixpanel/mixpanel-react-native/pull/198)
+- safer handling of super properties [\#197](https://github.com/mixpanel/mixpanel-react-native/pull/197)
+- Android resource linking failure fix [\#187](https://github.com/mixpanel/mixpanel-react-native/pull/187)
+
+**Closed issues:**
+
+- Support new React Native new architecture \(TurboModules/Fabric\) [\#145](https://github.com/mixpanel/mixpanel-react-native/issues/145)
+- Feature Request: Built in getInstance\(\) or similar instead of custom tooling [\#139](https://github.com/mixpanel/mixpanel-react-native/issues/139)
+- \[Feature Request\] Add support for Expo Config Plugins [\#69](https://github.com/mixpanel/mixpanel-react-native/issues/69)
+
+#
+
 ## [v2.2.5](https://github.com/mixpanel/mixpanel-react-native/tree/v2.2.5) (2023-04-29)
 
 ### Fixes
@@ -300,6 +321,8 @@ Report issues or give us any feedback is appreciated!
 
 
 
+
+
 
 
 

package/MixpanelReactNative.podspec

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

package/README.md

@@ -100,7 +100,7 @@ const SampleApp = () => {
 export default SampleApp;
 
 ```
-
+### For Expo support, please refer to this [issue](https://github.com/mixpanel/mixpanel-react-native/issues/82)
 👋 👋  Tell us about the Mixpanel developer experience! [https://www.mixpanel.com/devnps](https://www.mixpanel.com/devnps) 👍  👎
 
 
@@ -112,7 +112,7 @@ Yes, in Lexicon, you can intercept and drop incoming events or properties. Mixpa
 Mixpanel’s client-side tracking library contains the  [optOutTracking()](https://mixpanel.github.io/mixpanel-react-native/Mixpanel.html#optOutTracking)  method, which will set the user’s local opt-out state to “true” and will prevent data from being sent from a user’s device. More detailed instructions can be found in the section,  [Opting users out of tracking](https://developer.mixpanel.com/docs/react-native#opting-users-out-of-tracking).
 
 **Why aren't my events showing up?**  
-To preserve battery life and customer bandwidth, the Mixpanel library doesn't send the events you record immediately. Instead, it sends batches to the Mixpanel servers every 60 seconds while your application is running, as well as when the application transitions to the background. You can call  [flush()](https://mixpanel.github.io/mixpanel-react-native/Mixpanel.html#flush)  manually if you want to force a flush at a particular moment.
+First, make sure your test device has internet access. To preserve battery life and customer bandwidth, the Mixpanel library doesn't send the events you record immediately. Instead, it sends batches to the Mixpanel servers every 60 seconds while your application is running, as well as when the application transitions to the background. You can call  [flush()](https://mixpanel.github.io/mixpanel-react-native/Mixpanel.html#flush)  manually if you want to force a flush at a particular moment.
 
 ```
 mixpanel.flush();

package/Samples/ContextAPIMixpanel/android/.project

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>android_</name>
+	<comment>Project android_ created by Buildship.</comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.buildship.core.gradleprojectbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.buildship.core.gradleprojectnature</nature>
+	</natures>
+	<filteredResources>
+		<filter>
+			<id>1686200212448</id>
+			<name></name>
+			<type>30</type>
+			<matcher>
+				<id>org.eclipse.core.resources.regexFilterMatcher</id>
+				<arguments>node_modules|\.git|__CREATED_BY_JAVA_LANGUAGE_SERVER__</arguments>
+			</matcher>
+		</filter>
+	</filteredResources>
+</projectDescription>

package/Samples/MixpanelDemo/android/.project

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>android__</name>
+	<comment>Project android__ created by Buildship.</comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.buildship.core.gradleprojectbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.buildship.core.gradleprojectnature</nature>
+	</natures>
+	<filteredResources>
+		<filter>
+			<id>1686200212452</id>
+			<name></name>
+			<type>30</type>
+			<matcher>
+				<id>org.eclipse.core.resources.regexFilterMatcher</id>
+				<arguments>node_modules|\.git|__CREATED_BY_JAVA_LANGUAGE_SERVER__</arguments>
+			</matcher>
+		</filter>
+	</filteredResources>
+</projectDescription>

package/Samples/SimpleMixpanel/android/.project

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>SimpleMixpanel</name>
+	<comment>Project android created by Buildship.</comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.buildship.core.gradleprojectbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.buildship.core.gradleprojectnature</nature>
+	</natures>
+	<filteredResources>
+		<filter>
+			<id>1686200212442</id>
+			<name></name>
+			<type>30</type>
+			<matcher>
+				<id>org.eclipse.core.resources.regexFilterMatcher</id>
+				<arguments>node_modules|\.git|__CREATED_BY_JAVA_LANGUAGE_SERVER__</arguments>
+			</matcher>
+		</filter>
+	</filteredResources>
+</projectDescription>

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", true);
-  expect(NativeModules.MixpanelReactNative.initialize).toBeCalledWith("token", true, false, {"$lib_version": "2.2.5", "mp_lib": "react-native"});
+  expect(NativeModules.MixpanelReactNative.initialize).toBeCalledWith("token", true, false, {"$lib_version": "2.3.0", "mp_lib": "react-native"}, "https://api.mixpanel.com");
 });
 
 test(`it calls MixpanelReactNative initialize with optOut and superProperties`, async () => {
   const mixpanel = new Mixpanel("token", true);
   mixpanel.init(true, {"super": "property"})
-  expect(NativeModules.MixpanelReactNative.initialize).toBeCalledWith("token", true, true, {"$lib_version": "2.2.5", "mp_lib": "react-native", "super": "property"}, "https://api.mixpanel.com");
+  expect(NativeModules.MixpanelReactNative.initialize).toBeCalledWith("token", true, true, {"$lib_version": "2.3.0", "mp_lib": "react-native", "super": "property"}, "https://api.mixpanel.com");
 });
 
 test(`it calls MixpanelReactNative setServerURL`, async () => {

package/android/build.gradle

@@ -4,18 +4,18 @@ buildscript {
         google()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:3.4.1'
+        classpath 'com.android.tools.build:gradle:7.3.1'
     }
 }
 
 apply plugin: 'com.android.library'
 
 android {
-    compileSdkVersion 30
+    compileSdkVersion 33
     buildToolsVersion "30.0.3"
     defaultConfig {
         minSdkVersion 21
-        targetSdkVersion 30
+        targetSdkVersion 33
         versionCode 1
         versionName "1.0"
     }

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

@@ -44,6 +44,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void setServerURL(final String token, final String serverURL, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.setServerURL(serverURL);
             promise.resolve(null);
@@ -53,6 +57,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void setUseIpAddressForGeolocation(final String token, boolean useIpAddressForGeolocation, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.setUseIpAddressForGeolocation(useIpAddressForGeolocation);
             promise.resolve(null);
@@ -62,6 +70,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void setLoggingEnabled(final String token, boolean enableLogging, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.setEnableLogging(enableLogging);
             promise.resolve(null);
@@ -71,6 +83,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void hasOptedOutTracking(final String token, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             promise.resolve(instance.hasOptedOutTracking());
         }
@@ -79,6 +95,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void optInTracking(final String token, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.optInTracking();
             promise.resolve(null);
@@ -88,6 +108,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void optOutTracking(final String token, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.optOutTracking();
             promise.resolve(null);
@@ -97,6 +121,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void identify(final String token, final String distinctId, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.identify(distinctId);
             promise.resolve(null);
@@ -106,6 +134,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void getDistinctId(final String token, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             promise.resolve(instance.getDistinctId());
         }
@@ -114,6 +146,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void getDeviceId(final String token, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             promise.resolve(instance.getAnonymousId());
         }
@@ -122,6 +158,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void track(final String token, final String eventName, ReadableMap properties, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             JSONObject eventProperties = ReactNativeHelper.reactToJSON(properties);
             AutomaticProperties.appendLibraryProperties(eventProperties);
@@ -133,6 +173,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void registerSuperProperties(final String token, ReadableMap properties, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             JSONObject superProperties = ReactNativeHelper.reactToJSON(properties);
             instance.registerSuperProperties(superProperties);
@@ -143,6 +187,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void registerSuperPropertiesOnce(final String token, ReadableMap properties, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             JSONObject superProperties = ReactNativeHelper.reactToJSON(properties);
             instance.registerSuperPropertiesOnce(superProperties);
@@ -153,6 +201,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void unregisterSuperProperty(final String token, String superPropertyName, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.unregisterSuperProperty(superPropertyName);
             promise.resolve(null);
@@ -162,6 +214,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void union(final String token, String name, ReadableArray value, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             JSONArray propertyValue = ReactNativeHelper.reactToJSON(value);
             instance.getPeople().union(name, propertyValue);
@@ -172,6 +228,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void getSuperProperties(final String token, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             promise.resolve(ReactNativeHelper.convertJsonToMap(instance.getSuperProperties()));
         }
@@ -180,6 +240,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void clearSuperProperties(final String token, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.clearSuperProperties();
             promise.resolve(null);
@@ -189,6 +253,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void alias(final String token, String alias, String original, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.alias(alias, original);
             promise.resolve(null);
@@ -198,6 +266,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void reset(final String token, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.reset();
             promise.resolve(null);
@@ -207,6 +279,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void flush(final String token, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.flush();
             promise.resolve(null);
@@ -216,6 +292,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void timeEvent(final String token, final String eventName, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.timeEvent(eventName);
             promise.resolve(null);
@@ -225,6 +305,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void eventElapsedTime(final String token, final String eventName, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             promise.resolve(instance.eventElapsedTime(eventName));
         }
@@ -233,6 +317,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void set(final String token, ReadableMap properties, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             JSONObject sendProperties = ReactNativeHelper.reactToJSON(properties);
             AutomaticProperties.appendLibraryProperties(sendProperties);
@@ -244,6 +332,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void unset(final String token, String propertyName, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.getPeople().unset(propertyName);
             promise.resolve(null);
@@ -253,6 +345,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void setOnce(final String token, ReadableMap properties, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             JSONObject sendProperties = ReactNativeHelper.reactToJSON(properties);
             AutomaticProperties.appendLibraryProperties(sendProperties);
@@ -264,6 +360,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void trackCharge(final String token, double charge, ReadableMap properties, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             JSONObject transactionValue = ReactNativeHelper.reactToJSON(properties);
             instance.getPeople().trackCharge(charge, transactionValue);
@@ -274,6 +374,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void clearCharges(final String token, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.getPeople().clearCharges();
             promise.resolve(null);
@@ -284,6 +388,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     public void increment(final String token, ReadableMap properties, Promise promise) {
         Map incrementProperties = ReactNativeHelper.toMap(properties);
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.getPeople().increment(incrementProperties);
             promise.resolve(null);
@@ -293,6 +401,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void append(final String token, String name, Dynamic value, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.getPeople().append(name, ReactNativeHelper.dynamicToObject(value));
             promise.resolve(null);
@@ -302,6 +414,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void deleteUser(final String token, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.getPeople().deleteUser();
             promise.resolve(null);
@@ -311,6 +427,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void remove(final String token, String name, Dynamic value, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.getPeople().remove(name, ReactNativeHelper.dynamicToObject(value));
             promise.resolve(null);
@@ -320,6 +440,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void trackWithGroups(final String token, String eventName, ReadableMap properties, ReadableMap groups, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             Map eventProperties = ReactNativeHelper.toMap(properties);
             Map eventGroups = ReactNativeHelper.toMap(groups);
@@ -332,6 +456,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void setGroup(final String token, String groupKey, Dynamic groupID, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.setGroup(groupKey, ReactNativeHelper.dynamicToObject(groupID));
             promise.resolve(null);
@@ -341,6 +469,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void setGroups(final String token, String groupKey, ReadableArray groupIDs, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.setGroup(groupKey, Arrays.asList(ReactNativeHelper.toArray(groupIDs)));
             promise.resolve(null);
@@ -350,6 +482,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void addGroup(final String token, String groupKey, Dynamic groupID, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.addGroup(groupKey, ReactNativeHelper.dynamicToObject(groupID));
             promise.resolve(null);
@@ -359,6 +495,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void removeGroup(final String token, String groupKey, Dynamic groupID, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.removeGroup(groupKey, ReactNativeHelper.dynamicToObject(groupID));
             promise.resolve(null);
@@ -368,6 +508,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void deleteGroup(final String token, String groupKey, Dynamic groupID, Promise promise) {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.getGroup(groupKey, ReactNativeHelper.dynamicToObject(groupID)).deleteGroup();
             promise.resolve(null);
@@ -377,6 +521,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void groupSetProperties(final String token, String groupKey, Dynamic groupID, ReadableMap properties, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             JSONObject sendProperties = ReactNativeHelper.reactToJSON(properties);
             instance.getGroup(groupKey, ReactNativeHelper.dynamicToObject(groupID)).set(sendProperties);
@@ -387,6 +535,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void groupSetPropertyOnce(final String token, String groupKey, Dynamic groupID, ReadableMap properties, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             JSONObject sendProperties = ReactNativeHelper.reactToJSON(properties);
             instance.getGroup(groupKey, ReactNativeHelper.dynamicToObject(groupID)).setOnce(sendProperties);
@@ -397,6 +549,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void groupUnsetProperty(final String token, String groupKey, Dynamic groupID, String propertyName, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.getGroup(groupKey, ReactNativeHelper.dynamicToObject(groupID)).unset(propertyName);
             promise.resolve(null);
@@ -406,6 +562,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void groupRemovePropertyValue(final String token, String groupKey, Dynamic groupID, String name, Dynamic value, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             instance.getGroup(groupKey, ReactNativeHelper.dynamicToObject(groupID)).remove(name, ReactNativeHelper.dynamicToObject(value));
             promise.resolve(null);
@@ -415,6 +575,10 @@ public class MixpanelReactNativeModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void groupUnionProperty(final String token, String groupKey, Dynamic groupID, String name, ReadableArray values, Promise promise) throws JSONException {
         MixpanelAPI instance = MixpanelAPI.getInstance(this.mReactContext, token, true);
+        if (instance == null) {
+            promise.reject("Instance Error", "Failed to get Mixpanel instance");
+            return;
+        }
         synchronized (instance) {
             JSONArray arrayValues = ReactNativeHelper.reactToJSON(values);
             instance.getGroup(groupKey, ReactNativeHelper.dynamicToObject(groupID)).union(name, arrayValues);

package/docs/Mixpanel.html

@@ -469,7 +469,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#line311">line 311</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line322">line 322</a>
     </li></ul></dd>
     
 
@@ -519,8 +519,8 @@ Multiple aliases can point to the same identifier.
  `mixpane.alias("New ID", mixpane.distinctId)`
  `mixpane.alias("Newer ID", mixpane.distinctId)`
 
-<p>This call does not identify the user after. You must still call both identify() and
-People.identify() if you wish the new alias to be used for Events and People.
+<p>This call does not identify the user after. You must still call identify()
+ if you wish the new alias to be used for Events and People.
 </div>
 
 
@@ -636,7 +636,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#line212">line 212</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line223">line 223</a>
     </li></ul></dd>
     
 
@@ -729,7 +729,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#line419">line 419</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line430">line 430</a>
     </li></ul></dd>
     
 
@@ -891,7 +891,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#line339">line 339</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line350">line 350</a>
     </li></ul></dd>
     
 
@@ -1028,7 +1028,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#line444">line 444</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line455">line 455</a>
     </li></ul></dd>
     
 
@@ -1144,7 +1144,7 @@ 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#line504">line 504</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line515">line 515</a>
     </li></ul></dd>
     
 
@@ -1240,7 +1240,7 @@ const deviceId = await mixpanel.getDeviceId();
     
     <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#line491">line 491</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line502">line 502</a>
     </li></ul></dd>
     
 
@@ -1358,7 +1358,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#line473">line 473</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line484">line 484</a>
     </li></ul></dd>
     
 
@@ -1541,7 +1541,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#line301">line 301</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line312">line 312</a>
     </li></ul></dd>
     
 
@@ -1641,7 +1641,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#line251">line 251</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line262">line 262</a>
     </li></ul></dd>
     
 
@@ -1755,7 +1755,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#line407">line 407</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line418">line 418</a>
     </li></ul></dd>
     
 
@@ -1923,7 +1923,7 @@ and persist beyond the lifetime of your application.
     
 
     
-    <h4 class="name" id="identify"><span class="type-signature"></span>identify<span class="signature">(distinctId)</span><span class="type-signature"></span></h4>
+    <h4 class="name" id="identify"><span class="type-signature"></span>identify<span class="signature">(distinctId)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
     
 
     
@@ -2036,7 +2036,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#line192">line 192</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line194">line 194</a>
     </li></ul></dd>
     
 
@@ -2061,6 +2061,29 @@ your application.
 
 
 
+<h5>Returns:</h5>
+
+        
+<div class="param-desc">
+    A promise that resolves when the identify is successful.
+    It does not return any value.
+</div>
+
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Promise</span>
+
+
+    </dd>
+</dl>
+
+    
 
 
 
@@ -2564,7 +2587,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#line361">line 361</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line372">line 372</a>
     </li></ul></dd>
     
 
@@ -2704,7 +2727,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#line376">line 376</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line387">line 387</a>
     </li></ul></dd>
     
 
@@ -2864,7 +2887,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#line324">line 324</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line335">line 335</a>
     </li></ul></dd>
     
 
@@ -2953,7 +2976,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#line455">line 455</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line466">line 466</a>
     </li></ul></dd>
     
 
@@ -3251,7 +3274,7 @@ when the app enters the background on iOS. This is set to true by default.
     
     <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#line285">line 285</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line296">line 296</a>
     </li></ul></dd>
     
 
@@ -3808,7 +3831,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#line430">line 430</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line441">line 441</a>
     </li></ul></dd>
     
 
@@ -3974,7 +3997,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#line234">line 234</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line245">line 245</a>
     </li></ul></dd>
     
 
@@ -4163,7 +4186,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#line269">line 269</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line280">line 280</a>
     </li></ul></dd>
     
 
@@ -4304,7 +4327,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#line392">line 392</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line403">line 403</a>
     </li></ul></dd>
     
 
@@ -4356,7 +4379,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 Wed Mar 22 2023 21:33:52 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Jun 16 2023 16:47:53 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#line721">line 721</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line732">line 732</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#line792">line 792</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line803">line 803</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#line740">line 740</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line751">line 751</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#line759">line 759</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line770">line 770</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#line808">line 808</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line819">line 819</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#line777">line 777</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line788">line 788</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 Wed Mar 22 2023 21:33:52 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Jun 16 2023 16:47:53 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#line520">line 520</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line531">line 531</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#line611">line 611</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line622">line 622</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#line701">line 701</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line712">line 712</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#line711">line 711</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line722">line 722</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#line579">line 579</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line590">line 590</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#line655">line 655</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line666">line 666</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#line537">line 537</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line548">line 548</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#line556">line 556</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line567">line 567</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#line687">line 687</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line698">line 698</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#line634">line 634</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line645">line 645</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#line674">line 674</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line685">line 685</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 Wed Mar 22 2023 21:33:52 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Jun 16 2023 16:47:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

package/docs/index.html

@@ -44,7 +44,7 @@
 
     <section>
         <article><div align="center" style="text-align: center">
-  <img src="https://github.com/mixpanel/mixpanel-android/blob/assets/mixpanel.png?raw=true" alt="Mixpanel React Native Library" height="150"/>
+  <img src="https://user-images.githubusercontent.com/71290498/231855346-12c8fc52-5f24-485c-b9e6-24468599fb87.png" alt="Mixpanel React Native Library" height="150"/>
 </div>
 <h5></h5>
 <h2>Table of Contents</h2>
@@ -138,6 +138,7 @@ const SampleApp = () => {
 export default SampleApp;
 
 </code></pre>
+<h3>For Expo support, please refer to this <a href="https://github.com/mixpanel/mixpanel-react-native/issues/82">issue</a></h3>
 <p>👋 👋  Tell us about the Mixpanel developer experience! <a href="https://www.mixpanel.com/devnps">https://www.mixpanel.com/devnps</a> 👍  👎</p>
 <h2>FAQ</h2>
 <p><strong>I want to stop tracking an event/event property in Mixpanel. Is that possible?</strong><br>
@@ -145,7 +146,7 @@ Yes, in Lexicon, you can intercept and drop incoming events or properties. Mixpa
 <p><strong>I have a test user I would like to opt out of tracking. How do I do that?</strong><br>
 Mixpanel’s client-side tracking library contains the  <a href="https://mixpanel.github.io/mixpanel-react-native/Mixpanel.html#optOutTracking">optOutTracking()</a>  method, which will set the user’s local opt-out state to “true” and will prevent data from being sent from a user’s device. More detailed instructions can be found in the section,  <a href="https://developer.mixpanel.com/docs/react-native#opting-users-out-of-tracking">Opting users out of tracking</a>.</p>
 <p><strong>Why aren't my events showing up?</strong><br>
-To preserve battery life and customer bandwidth, the Mixpanel library doesn't send the events you record immediately. Instead, it sends batches to the Mixpanel servers every 60 seconds while your application is running, as well as when the application transitions to the background. You can call  <a href="https://mixpanel.github.io/mixpanel-react-native/Mixpanel.html#flush">flush()</a>  manually if you want to force a flush at a particular moment.</p>
+First, make sure your test device has internet access. To preserve battery life and customer bandwidth, the Mixpanel library doesn't send the events you record immediately. Instead, it sends batches to the Mixpanel servers every 60 seconds while your application is running, as well as when the application transitions to the background. You can call  <a href="https://mixpanel.github.io/mixpanel-react-native/Mixpanel.html#flush">flush()</a>  manually if you want to force a flush at a particular moment.</p>
 <pre class="prettyprint source"><code>mixpanel.flush();
 </code></pre>
 <p>If your events are still not showing up after 60 seconds, check if you have opted out of tracking. You can also enable Mixpanel debugging and logging, it allows you to see the debug output from the Mixpanel library. To enable it, call  <a href="https://mixpanel.github.io/mixpanel-react-native/Mixpanel.html#setLoggingEnabled">setLoggingEnabled</a> with true, then run your iOS project with Xcode or android project with Android Studio. The logs should be available in the console.</p>
@@ -178,7 +179,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 Wed Mar 22 2023 21:33:52 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Jun 16 2023 16:47:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

package/docs/index.js.html

@@ -113,7 +113,7 @@ export class Mixpanel {
      */
     static async init(token, trackAutomaticEvents, optOutTrackingDefault = DEFAULT_OPT_OUT) {
         let metadata = Helper.getMetaData();
-        await MixpanelReactNative.initialize(token, trackAutomaticEvents, optOutTrackingDefault, metadata);
+        await MixpanelReactNative.initialize(token, trackAutomaticEvents, optOutTrackingDefault, metadata, "https://api.mixpanel.com");
         return new Mixpanel(token, trackAutomaticEvents);
     }
 
@@ -215,13 +215,24 @@ export class Mixpanel {
      *     Mixpanel using the same disinct_id will be considered associated with the
      *     same visitor/customer for retention and funnel reporting, so be sure that the given
      *     value is globally unique for each individual user you intend to track.
-     *
+     * @returns {Promise} A promise that resolves when the identify is successful.
+     *     It does not return any value.
+     * 
      */
     identify(distinctId) {
-        if (!StringHelper.isValid(distinctId)) {
-            StringHelper.raiseError(PARAMS.DISTINCT_ID);
-        }
-        MixpanelReactNative.identify(this.token, distinctId);
+        return new Promise((resolvem, reject) => {
+            if (!StringHelper.isValid(distinctId)) {
+                StringHelper.raiseError(PARAMS.DISTINCT_ID);
+                reject(new Error('Invalid distinctId'));
+            }
+            MixpanelReactNative.identify(this.token, distinctId)
+                .then(() => {
+                    resolve();
+                })
+                .catch(err => {
+                    reject(err);
+                });
+        });
     }
 
     /**
@@ -231,8 +242,8 @@ export class Mixpanel {
      *  `mixpane.alias("New ID", mixpane.distinctId)`
      *  `mixpane.alias("Newer ID", mixpane.distinctId)`
      *
-     * <p>This call does not identify the user after. You must still call both identify() and
-     * People.identify() if you wish the new alias to be used for Events and People.
+     * <p>This call does not identify the user after. You must still call identify()
+     *  if you wish the new alias to be used for Events and People.
      *
      * @param {string} alias A unique identifier that you want to use as an identifier for this user.
      * @param {string} distinctId the current distinct_id that alias will be mapped to.
@@ -929,7 +940,7 @@ class ObjectHelper {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Wed Mar 22 2023 21:33:52 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Jun 16 2023 16:47:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

package/index.d.ts

@@ -13,7 +13,7 @@ export class Mixpanel {
     hasOptedOutTracking(): Promise<boolean>;
     optInTracking(): void;
     optOutTracking(): void;
-    identify(distinctId: string): void;
+    identify(distinctId: string): Promise<void>;
     alias(alias: string, distinctId: string): void
     track(eventName: string, properties?: MixpanelProperties): void
     getPeople(): People;

package/index.js

@@ -85,7 +85,7 @@ export class Mixpanel {
      */
     static async init(token, trackAutomaticEvents, optOutTrackingDefault = DEFAULT_OPT_OUT) {
         let metadata = Helper.getMetaData();
-        await MixpanelReactNative.initialize(token, trackAutomaticEvents, optOutTrackingDefault, metadata);
+        await MixpanelReactNative.initialize(token, trackAutomaticEvents, optOutTrackingDefault, metadata, "https://api.mixpanel.com");
         return new Mixpanel(token, trackAutomaticEvents);
     }
 
@@ -187,13 +187,24 @@ export class Mixpanel {
      *     Mixpanel using the same disinct_id will be considered associated with the
      *     same visitor/customer for retention and funnel reporting, so be sure that the given
      *     value is globally unique for each individual user you intend to track.
-     *
+     * @returns {Promise} A promise that resolves when the identify is successful.
+     *     It does not return any value.
+     * 
      */
     identify(distinctId) {
-        if (!StringHelper.isValid(distinctId)) {
-            StringHelper.raiseError(PARAMS.DISTINCT_ID);
-        }
-        MixpanelReactNative.identify(this.token, distinctId);
+        return new Promise((resolvem, reject) => {
+            if (!StringHelper.isValid(distinctId)) {
+                StringHelper.raiseError(PARAMS.DISTINCT_ID);
+                reject(new Error('Invalid distinctId'));
+            }
+            MixpanelReactNative.identify(this.token, distinctId)
+                .then(() => {
+                    resolve();
+                })
+                .catch(err => {
+                    reject(err);
+                });
+        });
     }
 
     /**
@@ -203,8 +214,8 @@ export class Mixpanel {
      *  `mixpane.alias("New ID", mixpane.distinctId)`
      *  `mixpane.alias("Newer ID", mixpane.distinctId)`
      *
-     * <p>This call does not identify the user after. You must still call both identify() and
-     * People.identify() if you wish the new alias to be used for Events and People.
+     * <p>This call does not identify the user after. You must still call identify()
+     *  if you wish the new alias to be used for Events and People.
      *
      * @param {string} alias A unique identifier that you want to use as an identifier for this user.
      * @param {string} distinctId the current distinct_id that alias will be mapped to.

package/ios/MixpanelReactNative.swift

@@ -21,7 +21,7 @@ open class MixpanelReactNative: NSObject {
                     rejecter reject: RCTPromiseRejectBlock) -> Void {
         let autoProps = properties // copy
         AutomaticProperties.setAutomaticProperties(autoProps)
-        let propsProcessed = MixpanelTypeHandler.processProperties(properties: properties)
+        let propsProcessed = MixpanelTypeHandler.processProperties(properties: autoProps)
         Mixpanel.initialize(token: token, trackAutomaticEvents: trackAutomaticEvents, flushInterval: Constants.DEFAULT_FLUSH_INTERVAL,
                             instanceName: token, optOutTrackingByDefault: optOutTrackingByDefault,
                             superProperties: propsProcessed,
@@ -131,11 +131,12 @@ open class MixpanelReactNative: NSObject {
      
     @objc
     func identify(_ token: String, distinctId: String,
-                  resolver resolve: RCTPromiseResolveBlock,
-                  rejecter reject: RCTPromiseRejectBlock) -> Void {
+                  resolver resolve: @escaping RCTPromiseResolveBlock,
+                  rejecter reject: @escaping RCTPromiseRejectBlock) -> Void {
         let instance = MixpanelReactNative.getMixpanelInstance(token)
-        instance?.identify(distinctId: distinctId)
-        resolve(nil)
+        instance?.identify(distinctId: distinctId) {
+            resolve(nil)
+        }
     }
     
     @objc

package/package.json

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