mixpanel-react-native 1.3.6 → 1.3.9

package/CHANGELOG.md

@@ -1,6 +1,23 @@
 #
 
+## [v1.3.8](https://github.com/mixpanel/mixpanel-react-native/tree/v1.3.8) (2022-02-25)
+
+### Enhancements
+
+- add init super props & declare multi-prop interfaces [\#127](https://github.com/mixpanel/mixpanel-react-native/pull/127)
+
+#
+
+## [v1.3.7](https://github.com/mixpanel/mixpanel-react-native/tree/v1.3.7) (2022-01-26)
+
+### Fixes
+
+- Bump iOS SDK to v3.1.2 [\#125](https://github.com/mixpanel/mixpanel-react-native/pull/125)
+
+#
+
 ## [v1.3.6](https://github.com/mixpanel/mixpanel-react-native/tree/v1.3.6) (2022-01-13)
+### Caution: Please DO NOT use this build! In this version, we have a bug in iOS that event names with `&` or `%` will be rejected by the server. We recommend you update to 1.3.7 or above.
 
 ### Fixes
 
@@ -149,4 +166,8 @@
 
 
 
+
+
+
+
 

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2020 Mixpanel, Inc.
+Copyright 2022 Mixpanel, Inc.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this work except in compliance with the License.

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.0'
+  s.dependency "Mixpanel-swift", '3.1.5'
 end

package/Samples/ContextAPIMixpanel/yarn.lock

@@ -4831,7 +4831,7 @@ mixin-deep@^1.2.0:
     is-extendable "^1.0.1"
 
 "mixpanel-react-native@file:../..":
-  version "1.3.6"
+  version "1.3.8"
 
 mkdirp@^0.5.1:
   version "0.5.5"

package/Samples/MixpanelDemo/yarn.lock

@@ -4734,7 +4734,7 @@ mixin-deep@^1.2.0:
     is-extendable "^1.0.1"
 
 "mixpanel-react-native@file:../..":
-  version "1.3.6"
+  version "1.3.8"
 
 mkdirp@^0.5.1:
   version "0.5.5"

package/Samples/SimpleMixpanel/yarn.lock

@@ -4867,7 +4867,7 @@ mixin-deep@^1.2.0:
     is-extendable "^1.0.1"
 
 "mixpanel-react-native@file:../..":
-  version "1.3.6"
+  version "1.3.8"
 
 mkdirp@^0.5.1:
   version "0.5.5"

package/__tests__/index.test.js

@@ -9,7 +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.6", "mp_lib": "react-native"});
+  expect(NativeModules.MixpanelReactNative.initialize).toBeCalledWith("token", false, {"$lib_version": "1.3.9", "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.9", "mp_lib": "react-native", "super": "property"});
 });
 
 test(`it calls MixpanelReactNative setServerURL`, async () => {

package/docs/Mixpanel.html

@@ -285,7 +285,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#line78">line 78</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line79">line 79</a>
     </li></ul></dd>
     
 
@@ -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#line288">line 288</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line289">line 289</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#line189">line 189</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line190">line 190</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#line396">line 396</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line397">line 397</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#line316">line 316</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line317">line 317</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#line421">line 421</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line422">line 422</a>
     </li></ul></dd>
     
 
@@ -1120,7 +1120,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#line463">line 463</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line464">line 464</a>
     </li></ul></dd>
     
 
@@ -1164,13 +1164,13 @@ send all remaining messages to the server.
 
 
 <div class="description">
-    Returns the current distinct id of the user. 
+    Returns the current distinct id of the user.
 This is either the id automatically generated by the library or the id that has been passed by a call to identify().
 
-example of usage: 
+example of usage:
 <pre>
 <code>
-const distinctId = await mixpanel.getDistinctId(); 
+const distinctId = await mixpanel.getDistinctId();
 </code>
 </pre>
 </div>
@@ -1216,7 +1216,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#line450">line 450</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line451">line 451</a>
     </li></ul></dd>
     
 
@@ -1399,7 +1399,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#line278">line 278</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line279">line 279</a>
     </li></ul></dd>
     
 
@@ -1499,7 +1499,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#line228">line 228</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line229">line 229</a>
     </li></ul></dd>
     
 
@@ -1613,7 +1613,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#line384">line 384</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line385">line 385</a>
     </li></ul></dd>
     
 
@@ -1723,7 +1723,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#line126">line 126</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line127">line 127</a>
     </li></ul></dd>
     
 
@@ -1894,7 +1894,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#line169">line 169</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line170">line 170</a>
     </li></ul></dd>
     
 
@@ -1930,7 +1930,7 @@ your application.
     
 
     
-    <h4 class="name" id="init"><span class="type-signature">(async) </span>init<span class="signature">(Optional)</span><span class="type-signature"></span></h4>
+    <h4 class="name" id="init"><span class="type-signature">(async) </span>init<span class="signature">(Optional, Optional)</span><span class="type-signature"></span></h4>
     
 
     
@@ -1994,6 +1994,29 @@ your application.
         </tr>
 
     
+
+        <tr>
+            
+                <td class="name"><code>Optional</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">object</span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last">A Map containing the key value pairs of the super properties to register</td>
+        </tr>
+
+    
     </tbody>
 </table>
 
@@ -2031,7 +2054,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#line59">line 59</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line60">line 60</a>
     </li></ul></dd>
     
 
@@ -2121,7 +2144,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#line136">line 136</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line137">line 137</a>
     </li></ul></dd>
     
 
@@ -2213,7 +2236,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#line147">line 147</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line148">line 148</a>
     </li></ul></dd>
     
 
@@ -2360,7 +2383,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#line338">line 338</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line339">line 339</a>
     </li></ul></dd>
     
 
@@ -2500,7 +2523,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#line353">line 353</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line354">line 354</a>
     </li></ul></dd>
     
 
@@ -2660,7 +2683,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#line301">line 301</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line302">line 302</a>
     </li></ul></dd>
     
 
@@ -2749,7 +2772,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#line432">line 432</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line433">line 433</a>
     </li></ul></dd>
     
 
@@ -2909,7 +2932,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#line262">line 262</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line263">line 263</a>
     </li></ul></dd>
     
 
@@ -3048,7 +3071,7 @@ you are running into issues with the SDK that you want to debug
     
     <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#line104">line 104</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line105">line 105</a>
     </li></ul></dd>
     
 
@@ -3187,7 +3210,7 @@ To route data to Mixpanel's EU servers, set to https://api-eu.mixpanel.com
     
     <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#line92">line 92</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line93">line 93</a>
     </li></ul></dd>
     
 
@@ -3232,7 +3255,7 @@ To route data to Mixpanel's EU servers, set to https://api-eu.mixpanel.com
 
 <div class="description">
     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, 
+With an IP address, geo-location is possible down to neighborhoods within a city,
 although the Mixpanel Dashboard will just show you city level location specificity.
 </div>
 
@@ -3285,7 +3308,7 @@ although the Mixpanel Dashboard will just show you city level location specifici
 
             
 
-            <td class="description last">whether to automatically send the client IP Address. 
+            <td class="description last">whether to automatically send the client IP Address.
 Defaults to true.</td>
         </tr>
 
@@ -3327,7 +3350,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#line117">line 117</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line118">line 118</a>
     </li></ul></dd>
     
 
@@ -3466,7 +3489,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#line407">line 407</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line408">line 408</a>
     </li></ul></dd>
     
 
@@ -3632,7 +3655,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#line211">line 211</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line212">line 212</a>
     </li></ul></dd>
     
 
@@ -3821,7 +3844,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#line246">line 246</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line247">line 247</a>
     </li></ul></dd>
     
 
@@ -3962,7 +3985,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#line369">line 369</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line370">line 370</a>
     </li></ul></dd>
     
 
@@ -4014,7 +4037,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 Thu Jan 13 2022 14:18:25 GMT-0800 (Pacific Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Feb 25 2022 13:58:49 GMT-0800 (Pacific Standard 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#line680">line 680</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line681">line 681</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#line751">line 751</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line752">line 752</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#line699">line 699</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line700">line 700</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#line718">line 718</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line719">line 719</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#line767">line 767</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line768">line 768</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#line736">line 736</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line737">line 737</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 Thu Jan 13 2022 14:18:25 GMT-0800 (Pacific Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Feb 25 2022 13:58:49 GMT-0800 (Pacific Standard 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#line479">line 479</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line480">line 480</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#line570">line 570</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line571">line 571</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#line660">line 660</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line661">line 661</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#line670">line 670</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line671">line 671</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#line538">line 538</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line539">line 539</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#line614">line 614</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line615">line 615</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#line496">line 496</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line497">line 497</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#line515">line 515</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line516">line 516</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#line646">line 646</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line647">line 647</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#line593">line 593</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line594">line 594</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#line633">line 633</a>
+        <a href="index.js.html">index.js</a>, <a href="index.js.html#line634">line 634</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 Thu Jan 13 2022 14:18:25 GMT-0800 (Pacific Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Feb 25 2022 13:58:49 GMT-0800 (Pacific Standard 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 Thu Jan 13 2022 14:18:25 GMT-0800 (Pacific Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Feb 25 2022 13:58:49 GMT-0800 (Pacific Standard Time)
 </footer>
 
 <script> prettyPrint(); </script>

package/docs/index.js.html

@@ -82,11 +82,12 @@ export class Mixpanel {
      * Initializes Mixpanel
      *
      * @param {boolean} Optional Whether or not Mixpanel can start tracking by default. See optOutTracking()
+     * @param {object}  Optional A Map containing the key value pairs of the super properties to register
      *
      */
-    async init(optOutTrackingDefault = DEFAULT_OPT_OUT) {
+    async init(optOutTrackingDefault = DEFAULT_OPT_OUT, superProperties = {}) {
         let metadata = Helper.getMetaData();
-        await MixpanelReactNative.initialize(this.token, optOutTrackingDefault, metadata);
+        await MixpanelReactNative.initialize(this.token, optOutTrackingDefault, {...metadata, ...superProperties});
     }
 
     /**
@@ -96,12 +97,12 @@ export class Mixpanel {
      * const mixpanel = new Mixpanel('your project token');
      * mixpanel.init();
      * </code></pre>
-     * 
+     *
      * Initializes Mixpanel and return an instance of Mixpanel the given project token.
      *
      * @param {string} token your project token.
      * @param {boolean} Optional Whether or not Mixpanel can start tracking by default. See optOutTracking()
-     * 
+     *
      */
     static async init(token, optOutTrackingDefault = DEFAULT_OPT_OUT) {
         let metadata = Helper.getMetaData();
@@ -115,7 +116,7 @@ export class Mixpanel {
      * To route data to Mixpanel's EU servers, set to https://api-eu.mixpanel.com
      *
      * @param {string} serverURL the base URL used for Mixpanel API requests
-     * 
+     *
      */
     setServerURL(serverURL) {
         MixpanelReactNative.setServerURL(this.token, serverURL);
@@ -124,10 +125,10 @@ export class Mixpanel {
     /**
      * This allows enabling or disabling of all Mixpanel logs at run time.
      * All logging is disabled by default. Usually, this is only required if
-     * you are running into issues with the SDK that you want to debug 
-     * 
+     * you are running into issues with the SDK that you want to debug
+     *
      * @param {boolean} loggingEnabled whether to enable logging
-     * 
+     *
      */
     setLoggingEnabled(loggingEnabled) {
         MixpanelReactNative.setLoggingEnabled(this.token, loggingEnabled);
@@ -135,12 +136,12 @@ export class Mixpanel {
 
     /**
      * 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, 
+     * With an IP address, geo-location is possible down to neighborhoods within a city,
      * although the Mixpanel Dashboard will just show you city level location specificity.
-     * 
-     * @param {boolean} useIpAddressForGeolocation whether to automatically send the client IP Address. 
+     *
+     * @param {boolean} useIpAddressForGeolocation whether to automatically send the client IP Address.
      * Defaults to true.
-     * 
+     *
      */
     setUseIpAddressForGeolocation(useIpAddressForGeolocation) {
         MixpanelReactNative.setUseIpAddressForGeolocation(this.token, useIpAddressForGeolocation);
@@ -154,7 +155,7 @@ export class Mixpanel {
     hasOptedOutTracking() {
         return MixpanelReactNative.hasOptedOutTracking(this.token);
     }
-  
+
     /**
      * Use this method to opt-in an already opted-out user from tracking. People updates and track
      * calls will be sent to Mixpanel after using this method.
@@ -204,10 +205,10 @@ export class Mixpanel {
     /**
      * The alias method creates an alias which Mixpanel will use to remap one id to another.
      * 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.
      *
@@ -270,7 +271,7 @@ export class Mixpanel {
      *                   Pass null if no extra properties exist.
      * @param {object} groups A Map containing the group key value pairs for this event.
      *
-     */ 
+     */
     trackWithGroups(eventName, properties, groups) {
         if (!StringHelper.isValid(eventName)) {
             StringHelper.raiseError(PARAMS.EVENT_NAME);
@@ -462,13 +463,13 @@ export class Mixpanel {
     }
 
     /**
-     * Returns the current distinct id of the user. 
+     * Returns the current distinct id of the user.
      * This is either the id automatically generated by the library or the id that has been passed by a call to identify().
-     * 
-     * example of usage: 
+     *
+     * example of usage:
      * <pre>
      * <code>
-     * const distinctId = await mixpanel.getDistinctId(); 
+     * const distinctId = await mixpanel.getDistinctId();
      * </code>
      * </pre>
      *
@@ -758,7 +759,7 @@ export class MixpanelGroup {
 
     /**
      * Permanently removes the property with the given name from the group's profile
-     * 
+     *
      * @param {string} prop name of a property to unset
      */
     unset(prop) {
@@ -772,7 +773,7 @@ export class MixpanelGroup {
      * Remove value from a list-valued property only if it is already present in the list.
      * If the property does not currently exist, the remove will be ignored.
      * If the property exists and is not list-valued, the remove will be ignored.
-     * 
+     *
      * @param {string} name the Group Analytics list-valued property that should have a value removed
      * @param {any} value the value that will be removed from the list
      */
@@ -888,7 +889,7 @@ class ObjectHelper {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Thu Jan 13 2022 14:18:25 GMT-0800 (Pacific Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.6</a> on Fri Feb 25 2022 13:58:49 GMT-0800 (Pacific Standard Time)
 </footer>
 
 <script> prettyPrint(); </script>

package/index.d.ts

@@ -4,7 +4,7 @@ type MixpanelProperties = { [key: string]: MixpanelType };
 export class Mixpanel {
     constructor(token: string);
     static init(token: string, optOutTrackingDefault?: boolean): Promise<Mixpanel>;
-    init(optOutTrackingDefault?: boolean): Promise<void>;
+    init(optOutTrackingDefault?: boolean, superProperties?: MixpanelProperties): Promise<void>;
     setServerURL(serverURL: string): void;
     setLoggingEnabled(loggingEnabled: boolean): void;
     setUseIpAddressForGeolocation(useIpAddressForGeolocation: boolean): void;
@@ -36,8 +36,11 @@ export class Mixpanel {
 export class People {
     constructor(token: string);
     set(prop: string, to: MixpanelType): void;
+    set(properties: MixpanelProperties): void;
     setOnce(prop: string, to: MixpanelType): void;
+    setOnce(properties: MixpanelProperties): void;
     increment(prop: string, by: number): void;
+    increment(properties: MixpanelProperties): void;
     append(name: string, value: MixpanelType): void;
     union(name: string, value: Array<MixpanelType>): void;
     remove(name: string, value: MixpanelType): void;

package/index.js

@@ -54,11 +54,12 @@ export class Mixpanel {
      * Initializes Mixpanel
      *
      * @param {boolean} Optional Whether or not Mixpanel can start tracking by default. See optOutTracking()
+     * @param {object}  Optional A Map containing the key value pairs of the super properties to register
      *
      */
-    async init(optOutTrackingDefault = DEFAULT_OPT_OUT) {
+    async init(optOutTrackingDefault = DEFAULT_OPT_OUT, superProperties = {}) {
         let metadata = Helper.getMetaData();
-        await MixpanelReactNative.initialize(this.token, optOutTrackingDefault, metadata);
+        await MixpanelReactNative.initialize(this.token, optOutTrackingDefault, {...metadata, ...superProperties});
     }
 
     /**
@@ -68,12 +69,12 @@ export class Mixpanel {
      * const mixpanel = new Mixpanel('your project token');
      * mixpanel.init();
      * </code></pre>
-     * 
+     *
      * Initializes Mixpanel and return an instance of Mixpanel the given project token.
      *
      * @param {string} token your project token.
      * @param {boolean} Optional Whether or not Mixpanel can start tracking by default. See optOutTracking()
-     * 
+     *
      */
     static async init(token, optOutTrackingDefault = DEFAULT_OPT_OUT) {
         let metadata = Helper.getMetaData();
@@ -87,7 +88,7 @@ export class Mixpanel {
      * To route data to Mixpanel's EU servers, set to https://api-eu.mixpanel.com
      *
      * @param {string} serverURL the base URL used for Mixpanel API requests
-     * 
+     *
      */
     setServerURL(serverURL) {
         MixpanelReactNative.setServerURL(this.token, serverURL);
@@ -96,10 +97,10 @@ export class Mixpanel {
     /**
      * This allows enabling or disabling of all Mixpanel logs at run time.
      * All logging is disabled by default. Usually, this is only required if
-     * you are running into issues with the SDK that you want to debug 
-     * 
+     * you are running into issues with the SDK that you want to debug
+     *
      * @param {boolean} loggingEnabled whether to enable logging
-     * 
+     *
      */
     setLoggingEnabled(loggingEnabled) {
         MixpanelReactNative.setLoggingEnabled(this.token, loggingEnabled);
@@ -107,12 +108,12 @@ export class Mixpanel {
 
     /**
      * 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, 
+     * With an IP address, geo-location is possible down to neighborhoods within a city,
      * although the Mixpanel Dashboard will just show you city level location specificity.
-     * 
-     * @param {boolean} useIpAddressForGeolocation whether to automatically send the client IP Address. 
+     *
+     * @param {boolean} useIpAddressForGeolocation whether to automatically send the client IP Address.
      * Defaults to true.
-     * 
+     *
      */
     setUseIpAddressForGeolocation(useIpAddressForGeolocation) {
         MixpanelReactNative.setUseIpAddressForGeolocation(this.token, useIpAddressForGeolocation);
@@ -126,7 +127,7 @@ export class Mixpanel {
     hasOptedOutTracking() {
         return MixpanelReactNative.hasOptedOutTracking(this.token);
     }
-  
+
     /**
      * Use this method to opt-in an already opted-out user from tracking. People updates and track
      * calls will be sent to Mixpanel after using this method.
@@ -176,10 +177,10 @@ export class Mixpanel {
     /**
      * The alias method creates an alias which Mixpanel will use to remap one id to another.
      * 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.
      *
@@ -242,7 +243,7 @@ export class Mixpanel {
      *                   Pass null if no extra properties exist.
      * @param {object} groups A Map containing the group key value pairs for this event.
      *
-     */ 
+     */
     trackWithGroups(eventName, properties, groups) {
         if (!StringHelper.isValid(eventName)) {
             StringHelper.raiseError(PARAMS.EVENT_NAME);
@@ -434,13 +435,13 @@ export class Mixpanel {
     }
 
     /**
-     * Returns the current distinct id of the user. 
+     * Returns the current distinct id of the user.
      * This is either the id automatically generated by the library or the id that has been passed by a call to identify().
-     * 
-     * example of usage: 
+     *
+     * example of usage:
      * <pre>
      * <code>
-     * const distinctId = await mixpanel.getDistinctId(); 
+     * const distinctId = await mixpanel.getDistinctId();
      * </code>
      * </pre>
      *
@@ -730,7 +731,7 @@ export class MixpanelGroup {
 
     /**
      * Permanently removes the property with the given name from the group's profile
-     * 
+     *
      * @param {string} prop name of a property to unset
      */
     unset(prop) {
@@ -744,7 +745,7 @@ export class MixpanelGroup {
      * Remove value from a list-valued property only if it is already present in the list.
      * If the property does not currently exist, the remove will be ignored.
      * If the property exists and is not list-valued, the remove will be ignored.
-     * 
+     *
      * @param {string} name the Group Analytics list-valued property that should have a value removed
      * @param {any} value the value that will be removed from the list
      */

package/package.json

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

package/release.py

@@ -11,14 +11,14 @@ args = parser.parse_args()
 def bump_version():
     replace_version('package.json', "\"version\": \"" + args.old + "\"", "\"version\": \"" + args.new + "\"")
     replace_version('__tests__/index.test.js', "\"$lib_version\": \"" + args.old + "\"", "\"$lib_version\": \"" + args.new + "\"")
-    subprocess.call('cd Samples/MixpanelDemo;yarn upgrade mixpanel-react-native --latest', shell=True)
-    subprocess.call('cd Samples/SimpleMixpanel;yarn upgrade mixpanel-react-native --latest', shell=True)
-    subprocess.call('cd Samples/ContextAPIMixpanel;yarn upgrade mixpanel-react-native --latest', shell=True)
+    #subprocess.call('cd Samples/MixpanelDemo;yarn upgrade mixpanel-react-native --latest', shell=True)
+    #subprocess.call('cd Samples/SimpleMixpanel;yarn upgrade mixpanel-react-native --latest', shell=True)
+    #subprocess.call('cd Samples/ContextAPIMixpanel;yarn upgrade mixpanel-react-native --latest', shell=True)
     subprocess.call('git add package.json', shell=True)
     subprocess.call('git add __tests__/index.test.js', shell=True)
-    subprocess.call('git add Samples/MixpanelDemo/yarn.lock', shell=True)
-    subprocess.call('git add Samples/SimpleMixpanel/yarn.lock', shell=True)
-    subprocess.call('git add Samples/ContextAPIMixpanel/yarn.lock', shell=True)
+    #subprocess.call('git add Samples/MixpanelDemo/yarn.lock', shell=True)
+    #subprocess.call('git add Samples/SimpleMixpanel/yarn.lock', shell=True)
+    #subprocess.call('git add Samples/ContextAPIMixpanel/yarn.lock', shell=True)
     subprocess.call('git commit -m "Version {}"'.format(args.new), shell=True)
     subprocess.call('git push', shell=True)
 

package/Samples/ContextAPIMixpanel/android/.project

@@ -1,28 +0,0 @@
-<?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>1632526110612</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

@@ -1,28 +0,0 @@
-<?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>1632526110615</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

@@ -1,28 +0,0 @@
-<?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>1632526110607</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>