mixpanel-browser 2.48.1 → 2.50.0

package/.eslintignore

@@ -0,0 +1,2 @@
+src/loaders/mixpanel.js
+src/loaders/mixpanel-jslib-snippet.js

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+**2.49.0** (5 Feb 2024)
+- SPA support in pageview-tracking
+- Support for configurable UTM parameter persistence
+- Initial-referrer profile properties are now stored with `set_once` instead of `set`
+- Ignore AhrefsSiteAudit crawler
+
 **2.48.1** (14 Nov 2023)
 - UTM campaign properties will always be persisted super properties (fixes discrepancy between
 minified and unminified package)

package/README.md

@@ -50,7 +50,7 @@ or
 
 2) Recompile the snippet with a custom `MIXPANEL_LIB_URL` using [Closure Compiler](https://developers.google.com/closure/compiler/):
 ```sh
-java -jar compiler.jar --js mixpanel-jslib-snippet.js --js_output_file mixpanel-jslib-snippet.min.js --compilation_level ADVANCED_OPTIMIZATIONS --define='MIXPANEL_LIB_URL="bower_components/mixpanel/mixpanel.js"'
+java -jar compiler.jar --js src/loaders/mixpanel-jslib-snippet.js --js_output_file mixpanel-jslib-snippet.min.js --compilation_level ADVANCED_OPTIMIZATIONS --define='MIXPANEL_LIB_URL="bower_components/mixpanel/mixpanel.js"'
 ```
 
 ### Upgrading from mixpanel-bower v2.2.0 or v2.0.0

package/bower.json

@@ -2,7 +2,7 @@
   "name": "mixpanel",
   "homepage": "https://github.com/mixpanel/mixpanel-js",
   "description": "Mixpanel JavaScript Library",
-  "main": "mixpanel-jslib-snippet.js",
+  "main": "src/loaders/mixpanel-jslib-snippet.js",
   "repository": {
     "type": "git",
     "url": "git@github.com:mixpanel/mixpanel-js.git"

package/build.sh

@@ -7,8 +7,9 @@ if [ ! -z "$DIST" ]; then
     export FULL=1
 fi
 
-echo 'Building main bundle'
-./node_modules/.bin/rollup -i src/loader-globals.js -f iife -o build/mixpanel.globals.js -n mixpanel -c rollup.config.js
+echo 'Building main bundles'
+npx rollup -i src/loaders/loader-globals.js -f iife -o build/mixpanel.globals.js -n mixpanel -c rollup.config.js
+npx rollup -i src/recorder/index.js -f iife -n mixpanel -c src/recorder/rollup.config.js
 ln -sf mixpanel.globals.js build/mixpanel.js
 
 if [ ! -z "$FULL" ]; then
@@ -16,17 +17,21 @@ if [ ! -z "$FULL" ]; then
     java -jar vendor/closure-compiler/compiler.jar --js build/mixpanel.js --js_output_file build/mixpanel.min.js --compilation_level ADVANCED_OPTIMIZATIONS --output_wrapper "(function() {
 %output%
 })();"
-    java -jar vendor/closure-compiler/compiler.jar --js mixpanel-jslib-snippet.js --js_output_file build/mixpanel-jslib-snippet.min.js --compilation_level ADVANCED_OPTIMIZATIONS
-    java -jar vendor/closure-compiler/compiler.jar --js mixpanel-jslib-snippet.js --js_output_file build/mixpanel-jslib-snippet.min.test.js --compilation_level ADVANCED_OPTIMIZATIONS --define='MIXPANEL_LIB_URL="../build/mixpanel.min.js"'
+    java -jar vendor/closure-compiler/compiler.jar --js src/loaders/mixpanel-jslib-snippet.js --js_output_file build/mixpanel-jslib-snippet.min.js --compilation_level ADVANCED_OPTIMIZATIONS
+    java -jar vendor/closure-compiler/compiler.jar --js src/loaders/mixpanel-jslib-snippet.js --js_output_file build/mixpanel-jslib-snippet.min.test.js --compilation_level ADVANCED_OPTIMIZATIONS --define='MIXPANEL_LIB_URL="../build/mixpanel.min.js"'
+
+    echo 'Building mixpanel-js-wrapper'
+    npx rollup src/loaders/mixpanel-js-wrapper.js -o build/mixpanel-js-wrapper.js -c rollup.config.js
+    java -jar vendor/closure-compiler/compiler.jar --js build/mixpanel-js-wrapper.js --js_output_file build/mixpanel-js-wrapper.min.js --compilation_level ADVANCED_OPTIMIZATIONS
 
     echo 'Building module bundles'
-    ./node_modules/.bin/rollup -i src/loader-module.js -f amd -o build/mixpanel.amd.js -c rollup.config.js
-    ./node_modules/.bin/rollup -i src/loader-module.js -f cjs -o build/mixpanel.cjs.js -c rollup.config.js
-    ./node_modules/.bin/rollup -i src/loader-module.js -f umd -o build/mixpanel.umd.js -n mixpanel -c rollup.config.js
+    npx rollup -i src/loaders/loader-module.js -f amd -o build/mixpanel.amd.js -c rollup.config.js
+    npx rollup -i src/loaders/loader-module.js -f cjs -o build/mixpanel.cjs.js -c rollup.config.js
+    npx rollup -i src/loaders/loader-module.js -f umd -o build/mixpanel.umd.js -n mixpanel -c rollup.config.js
 
     echo 'Bundling module-loader test runners'
-    ./node_modules/.bin/webpack tests/module-cjs.js tests/module-cjs.bundle.js
-    ./node_modules/.bin/browserify tests/module-es2015.js -t [ babelify --compact false ] --outfile tests/module-es2015.bundle.js
+    npx webpack tests/module-cjs.js tests/module-cjs.bundle.js
+    npx browserify tests/module-es2015.js -t [ babelify --compact false ] --outfile tests/module-es2015.bundle.js
 
     echo 'Bundling module-loader examples'
     pushd examples/commonjs-browserify; npm install && npm run build; popd

package/dist/mixpanel-js-wrapper.js

@@ -0,0 +1,247 @@
+// ==ClosureCompiler==
+// @compilation_level SIMPLE_OPTIMIZATIONS
+// @output_file_name mixpanel-jslib-2.2-snippet.min.js
+// ==/ClosureCompiler==
+
+/** @define {string} */
+var MIXPANEL_LIB_URL = '//cdn.mxpnl.com/libs/mixpanel-2-latest.min.js';
+
+(function(document, mixpanel) {
+    // Only stub out if this is the first time running the snippet.
+    if (!mixpanel['__SV']) {
+        var script, first_script, functions, i, lib_name = "mixpanel";
+        window[lib_name] = mixpanel;
+
+        mixpanel['_i'] = [];
+
+        mixpanel['init'] = function (token, config, name) {
+            // support multiple mixpanel instances
+            var target = mixpanel;
+            if (typeof(name) !== 'undefined') {
+                target = mixpanel[name] = [];
+            } else {
+                name = lib_name;
+            }
+
+            // Pass in current people object if it exists
+            target['people'] = target['people'] || [];
+            target['toString'] = function(no_stub) {
+                var str = lib_name;
+                if (name !== lib_name) {
+                    str += "." + name;
+                }
+                if (!no_stub) {
+                    str += " (stub)";
+                }
+                return str;
+            };
+            target['people']['toString'] = function() {
+                // 1 instead of true for minifying
+                return target.toString(1) + ".people (stub)";
+            };
+
+            function _set_and_defer(target, fn) {
+                var split = fn.split(".");
+                if (split.length == 2) {
+                    target = target[split[0]];
+                    fn = split[1];
+                }
+                target[fn] = function() {
+                    target.push([fn].concat(Array.prototype.slice.call(arguments, 0)));
+                };
+            }
+
+            // create shallow clone of the public mixpanel interface
+            // Note: only supports 1 additional level atm, e.g. mixpanel.people.set, not mixpanel.people.set.do_something_else.
+            functions = "disable time_event track track_pageview track_links track_forms track_with_groups add_group set_group remove_group register register_once alias unregister identify name_tag set_config reset opt_in_tracking opt_out_tracking has_opted_in_tracking has_opted_out_tracking clear_opt_in_out_tracking start_batch_senders people.set people.set_once people.unset people.increment people.append people.union people.track_charge people.clear_charges people.delete_user people.remove".split(' ');
+            for (i = 0; i < functions.length; i++) {
+                _set_and_defer(target, functions[i]);
+            }
+
+            // special case for get_group(): chain method calls like mixpanel.get_group('foo', 'bar').unset('baz')
+            var group_functions = "set set_once union unset remove delete".split(' ');
+            target['get_group'] = function() {
+                var mock_group = {};
+
+                var call1_args = arguments;
+                var call1 = ['get_group'].concat(Array.prototype.slice.call(call1_args, 0));
+
+                function _set_and_defer_chained(fn_name) {
+                    mock_group[fn_name] = function() {
+                        var call2_args = arguments;
+                        var call2 = [fn_name].concat(Array.prototype.slice.call(call2_args, 0));
+                        target.push([call1, call2]);
+                    };
+                }
+                for (var i = 0; i < group_functions.length; i++) {
+                    _set_and_defer_chained(group_functions[i]);
+                }
+                return mock_group;
+            };
+
+            // register mixpanel instance
+            mixpanel['_i'].push([token, config, name]);
+        };
+
+        // Snippet version, used to fail on new features w/ old snippet
+        mixpanel['__SV'] = 1.2;
+
+        script = document.createElement("script");
+        script.type = "text/javascript";
+        script.async = true;
+
+        if (typeof MIXPANEL_CUSTOM_LIB_URL !== 'undefined') {
+            script.src = MIXPANEL_CUSTOM_LIB_URL;
+        } else if (document.location.protocol === 'file:' && MIXPANEL_LIB_URL.match(/^\/\//)) {
+            script.src = 'https:' + MIXPANEL_LIB_URL;
+        } else {
+            script.src = MIXPANEL_LIB_URL;
+        }
+
+        first_script = document.getElementsByTagName("script")[0];
+        first_script.parentNode.insertBefore(script, first_script);
+    }
+// Pass in current Mixpanel object if it exists (for ppl like Optimizely)
+})(document, window['mixpanel'] || []);
+
+/*
+ * @see src/loaders/mixpanel-js-wrapper.md
+ */
+(function (win, wrapper) {
+
+    // If window.mixpanel doesn't exist, return
+    if (!win['mixpanel'] || typeof win['mixpanel']['init'] !== 'function') return;
+
+    // Enumerate available commands
+    var commandEnum = [
+        'add_group',
+        'alias',
+        'clear_opt_in_out_tracking',
+        'disable',
+        /* Ignore getters
+        'get_config',
+        'get_distinct_id',
+        'get_group',
+        'get_property',
+        'has_opted_in_tracking',
+        'has_opted_out_tracking',
+        */
+        /* Ignore init
+        'init'
+        */
+        'identify',
+        'opt_in_tracking',
+        'opt_out_tracking',
+        /* Ignore push
+        'push',
+        */
+        'register',
+        'register_once',
+        'remove_group',
+        'reset',
+        'set_config',
+        'set_group',
+        'time_event',
+        'track',
+        'track_forms',
+        'track_links',
+        'track_pageview',
+        'track_with_groups',
+        'unregister',
+        'people.append',
+        'people.clear_charges',
+        'people.delete_user',
+        'people.increment',
+        'people.remove',
+        'people.set',
+        'people.set_once',
+        'people.track_charge',
+        'people.union',
+        'people.unset',
+        'group.remove',
+        'group.set',
+        'group.set_once',
+        'group.union',
+        'group.unset'
+    ];
+
+    /* The people API can't be used with the .push() interface, so it requires its
+     * own helper method. To interact with it, simply use the _mixpanel interface
+     * as before.
+     *
+     * window._mixpanel('<libraryName.>people.set', 'gender', 'm');
+     *
+     */
+    var people = function (mp, cmd, args) {
+        // Extract the command
+        var peopleCmd = cmd.split('.').pop();
+
+        // Call the respective mixpanel method
+        mp['people'][peopleCmd].apply(mp['people'], args);
+    };
+
+    /* To utilize the group API, the command must include the group key and ID as
+     * an array in the second argument.
+     *
+     * window._mixpanel('<libraryName.>.group.set', ['group_key', 'group_id'], {
+     *   someGroupProperty: 'someGroupValue'
+     * });
+     *
+     */
+    var group = function (mp, cmd, args) {
+        // Extract the command
+        var groupCmd = cmd.split('.').pop();
+
+        // Extract the group info
+        var groupInfo = args.shift();
+
+        // Validate the group array
+        if (!Array.isArray(groupInfo) || groupInfo.length !== 2) return;
+
+        // Get group reference
+        var group = mp['get_group'].apply(mp, groupInfo);
+
+        // Call the respective group method
+        group[groupCmd].apply(group, args);
+
+    };
+
+    // Build the command wrapper logic
+    win[wrapper] = win[wrapper] || function () {
+
+        // Build array out of arguments
+        var args = [].slice.call(arguments, 0);
+
+        // Pick the first argument as the command
+        var cmd = args.shift();
+
+        /* Commands can be passed to different namespaces with syntax:
+         * window._mixpanel('libraryName.command', arguments)
+         */
+        var libraryName = null;
+        var cmdParts = cmd.match(/^([^.]+)\.(.+)$/);
+        if (cmdParts && cmdParts.length === 3 && !/people|group/.test(cmdParts[1])) {
+            libraryName = cmdParts[1];
+            cmd = cmdParts[2];
+        }
+
+        // If libraryName is set, use that as the mixpanel interface
+        var mp = libraryName ? window['mixpanel'][libraryName] : window['mixpanel'];
+
+        // Return if namespace not found
+        if (!mp) return;
+
+        // If cmd is not one of the available ones, return
+        if (commandEnum.indexOf(cmd) === -1) return;
+
+        // Handle people command
+        if (/^people\./.test(cmd)) return people(mp, cmd, args);
+
+        // Handle group command
+        if (/^group\./.test(cmd)) return group(mp, cmd, args);
+
+        // Push the command to mixpanel
+        return mp.push.apply(mp, [[cmd].concat(args)]);
+
+    };
+})(window, '_mixpanel');

package/dist/mixpanel-js-wrapper.min.js

@@ -0,0 +1,5 @@
+(function(d,c){if(!c.__SV){var e,g,b,a;window.mixpanel=c;c._i=[];c.init=function(i,g,d){function e(b,a){var d=a.split(".");2==d.length&&(b=b[d[0]],a=d[1]);b[a]=function(){b.push([a].concat(Array.prototype.slice.call(arguments,0)))}}var f=c;"undefined"!==typeof d?f=c[d]=[]:d="mixpanel";f.people=f.people||[];f.toString=function(b){var a="mixpanel";"mixpanel"!==d&&(a+="."+d);b||(a+=" (stub)");return a};f.people.toString=function(){return f.toString(1)+".people (stub)"};b="disable time_event track track_pageview track_links track_forms track_with_groups add_group set_group remove_group register register_once alias unregister identify name_tag set_config reset opt_in_tracking opt_out_tracking has_opted_in_tracking has_opted_out_tracking clear_opt_in_out_tracking start_batch_senders people.set people.set_once people.unset people.increment people.append people.union people.track_charge people.clear_charges people.delete_user people.remove".split(" ");
+for(a=0;a<b.length;a++)e(f,b[a]);var h="set set_once union unset remove delete".split(" ");f.get_group=function(){function a(c){b[c]=function(){var a=[c].concat(Array.prototype.slice.call(arguments,0));f.push([d,a])}}for(var b={},d=["get_group"].concat(Array.prototype.slice.call(arguments,0)),c=0;c<h.length;c++)a(h[c]);return b};c._i.push([i,g,d])};c.__SV=1.2;e=d.createElement("script");e.type="text/javascript";e.async=!0;e.src="undefined"!==typeof MIXPANEL_CUSTOM_LIB_URL?MIXPANEL_CUSTOM_LIB_URL:
+"file:"===d.location.protocol&&"//cdn.mxpnl.com/libs/mixpanel-2-latest.min.js".match(/^\/\//)?"https://cdn.mxpnl.com/libs/mixpanel-2-latest.min.js":"//cdn.mxpnl.com/libs/mixpanel-2-latest.min.js";g=d.getElementsByTagName("script")[0];g.parentNode.insertBefore(e,g)}})(document,window.mixpanel||[]);
+(function(d,c){if(d.mixpanel&&"function"===typeof d.mixpanel.init){var e="add_group,alias,clear_opt_in_out_tracking,disable,identify,opt_in_tracking,opt_out_tracking,register,register_once,remove_group,reset,set_config,set_group,time_event,track,track_forms,track_links,track_pageview,track_with_groups,unregister,people.append,people.clear_charges,people.delete_user,people.increment,people.remove,people.set,people.set_once,people.track_charge,people.union,people.unset,group.remove,group.set,group.set_once,group.union,group.unset".split(",");d[c]=
+d[c]||function(){var d=[].slice.call(arguments,0),b=d.shift(),a=null,c=b.match(/^([^.]+)\.(.+)$/);c&&3===c.length&&!/people|group/.test(c[1])&&(a=c[1],b=c[2]);if((a=a?window.mixpanel[a]:window.mixpanel)&&-1!==e.indexOf(b))return/^people\./.test(b)?(b=b.split(".").pop(),a.people[b].apply(a.people,d),b=void 0):/^group\./.test(b)?(b=b.split(".").pop(),c=d.shift(),Array.isArray(c)&&2===c.length&&(a=a.get_group.apply(a,c),a[b].apply(a,d)),b=void 0):b=a.push.apply(a,[[b].concat(d)]),b}}})(window,"_mixpanel");