mixpanel-browser 2.39.0 → 2.42.0

package/dist/mixpanel.globals.js

@@ -3,7 +3,7 @@
 
     var Config = {
         DEBUG: false,
-        LIB_VERSION: '2.39.0'
+        LIB_VERSION: '2.42.0'
     };
 
     // since es6 imports are static and we run unit tests from the console, window won't be defined when importing this file
@@ -56,7 +56,7 @@
     };
 
     // Console override
-    var console$1 = {
+    var console = {
         /** @type {function(...*)} */
         log: function() {
             if (Config.DEBUG && !_.isUndefined(windowConsole) && windowConsole) {
@@ -70,6 +70,19 @@
             }
         },
         /** @type {function(...*)} */
+        warn: function() {
+            if (Config.DEBUG && !_.isUndefined(windowConsole) && windowConsole) {
+                var args = ['Mixpanel warning:'].concat(_.toArray(arguments));
+                try {
+                    windowConsole.warn.apply(windowConsole, args);
+                } catch (err) {
+                    _.each(args, function(arg) {
+                        windowConsole.warn(arg);
+                    });
+                }
+            }
+        },
+        /** @type {function(...*)} */
         error: function() {
             if (Config.DEBUG && !_.isUndefined(windowConsole) && windowConsole) {
                 var args = ['Mixpanel error:'].concat(_.toArray(arguments));
@@ -100,14 +113,14 @@
     var log_func_with_prefix = function(func, prefix) {
         return function() {
             arguments[0] = '[' + prefix + '] ' + arguments[0];
-            return func.apply(console$1, arguments);
+            return func.apply(console, arguments);
         };
     };
     var console_with_prefix = function(prefix) {
         return {
-            log: log_func_with_prefix(console$1.log, prefix),
-            error: log_func_with_prefix(console$1.error, prefix),
-            critical: log_func_with_prefix(console$1.critical, prefix)
+            log: log_func_with_prefix(console.log, prefix),
+            error: log_func_with_prefix(console.error, prefix),
+            critical: log_func_with_prefix(console.critical, prefix)
         };
     };
 
@@ -235,13 +248,13 @@
         return _.values(iterable);
     };
 
-    _.map = function(arr, callback) {
+    _.map = function(arr, callback, context) {
         if (nativeMap && arr.map === nativeMap) {
-            return arr.map(callback);
+            return arr.map(callback, context);
         } else {
             var results = [];
             _.each(arr, function(item) {
-                results.push(callback(item));
+                results.push(callback.call(context, item));
             });
             return results;
         }
@@ -269,10 +282,6 @@
         return results;
     };
 
-    _.identity = function(value) {
-        return value;
-    };
-
     _.include = function(obj, target) {
         var found = false;
         if (obj === null) {
@@ -373,9 +382,9 @@
             try {
                 return f.apply(this, arguments);
             } catch (e) {
-                console$1.critical('Implementation error. Please turn on debug and contact support@mixpanel.com.');
+                console.critical('Implementation error. Please turn on debug and contact support@mixpanel.com.');
                 if (Config.DEBUG){
-                    console$1.critical(e);
+                    console.critical(e);
                 }
             }
         };
@@ -935,9 +944,37 @@
     // _.isBlockedUA()
     // This is to block various web spiders from executing our JS and
     // sending false tracking data
+    var BLOCKED_UA_STRS = [
+        'baiduspider',
+        'bingbot',
+        'bingpreview',
+        'facebookexternal',
+        'pinterest',
+        'screaming frog',
+        'yahoo! slurp',
+        'yandexbot',
+
+        // a whole bunch of goog-specific crawlers
+        // https://developers.google.com/search/docs/advanced/crawling/overview-google-crawlers
+        'adsbot-google',
+        'apis-google',
+        'duplexweb-google',
+        'feedfetcher-google',
+        'google favicon',
+        'google web preview',
+        'google-read-aloud',
+        'googlebot',
+        'googleweblight',
+        'mediapartners-google',
+        'storebot-google'
+    ];
     _.isBlockedUA = function(ua) {
-        if (/(google web preview|baiduspider|yandexbot|bingbot|googlebot|yahoo! slurp)/i.test(ua)) {
-            return true;
+        var i;
+        ua = ua.toLowerCase();
+        for (i = 0; i < BLOCKED_UA_STRS.length; i++) {
+            if (ua.indexOf(BLOCKED_UA_STRS[i]) !== -1) {
+                return true;
+            }
         }
         return false;
     };
@@ -976,16 +1013,12 @@
             try {
                 result = decodeURIComponent(result);
             } catch(err) {
-                console$1.error('Skipping decoding for malformed query param: ' + result);
+                console.error('Skipping decoding for malformed query param: ' + result);
             }
             return result.replace(/\+/g, ' ');
         }
     };
 
-    _.getHashParam = function(hash, param) {
-        var matches = hash.match(new RegExp(param + '=([^&]*)'));
-        return matches ? matches[1] : null;
-    };
 
     // _.cookie
     // Methods partially borrowed from quirksmode.org/js/cookies.html
@@ -1107,13 +1140,13 @@
         is_supported: function(force_check) {
             var supported = localStorageSupported(null, force_check);
             if (!supported) {
-                console$1.error('localStorage unsupported; falling back to cookie store');
+                console.error('localStorage unsupported; falling back to cookie store');
             }
             return supported;
         },
 
         error: function(msg) {
-            console$1.error('localStorage error: ' + msg);
+            console.error('localStorage error: ' + msg);
         },
 
         get: function(name) {
@@ -1168,7 +1201,7 @@
          */
         var register_event = function(element, type, handler, oldSchool, useCapture) {
             if (!element) {
-                console$1.error('No valid element provided to register_event');
+                console.error('No valid element provided to register_event');
                 return;
             }
 
@@ -1652,28 +1685,6 @@
         return maxlen ? guid.substring(0, maxlen) : guid;
     };
 
-    /**
-     * Check deterministically whether to include or exclude from a feature rollout/test based on the
-     * given string and the desired percentage to include.
-     * @param {String} str - string to run the check against (for instance a project's token)
-     * @param {String} feature - name of feature (for inclusion in hash, to ensure different results
-     * for different features)
-     * @param {Number} percent_allowed - percentage chance that a given string will be included
-     * @returns {Boolean} whether the given string should be included
-     */
-    var determine_eligibility = _.safewrap(function(str, feature, percent_allowed) {
-        str = str + feature;
-
-        // Bernstein's hash: http://www.cse.yorku.ca/~oz/hash.html#djb2
-        var hash = 5381;
-        for (var i = 0; i < str.length; i++) {
-            hash = ((hash << 5) + hash) + str.charCodeAt(i);
-            hash = hash & hash;
-        }
-        var dart = (hash >>> 0) % 100;
-        return dart < percent_allowed;
-    });
-
     // naive way to extract domain name (example.com) from full hostname (my.sub.example.com)
     var SIMPLE_DOMAIN_MATCH_REGEX = /[a-z0-9][a-z0-9-]*\.[a-z]+$/i;
     // this next one attempts to account for some ccSLDs, e.g. extracting oxford.ac.uk from www.oxford.ac.uk
@@ -1724,539 +1735,6 @@
     _['info']['browserVersion'] = _.info.browserVersion;
     _['info']['properties']     = _.info.properties;
 
-    /*
-     * Get the className of an element, accounting for edge cases where element.className is an object
-     * @param {Element} el - element to get the className of
-     * @returns {string} the element's class
-     */
-    function getClassName(el) {
-        switch(typeof el.className) {
-            case 'string':
-                return el.className;
-            case 'object': // handle cases where className might be SVGAnimatedString or some other type
-                return el.className.baseVal || el.getAttribute('class') || '';
-            default: // future proof
-                return '';
-        }
-    }
-
-    /*
-     * Get the direct text content of an element, protecting against sensitive data collection.
-     * Concats textContent of each of the element's text node children; this avoids potential
-     * collection of sensitive data that could happen if we used element.textContent and the
-     * element had sensitive child elements, since element.textContent includes child content.
-     * Scrubs values that look like they could be sensitive (i.e. cc or ssn number).
-     * @param {Element} el - element to get the text of
-     * @returns {string} the element's direct text content
-     */
-    function getSafeText(el) {
-        var elText = '';
-
-        if (shouldTrackElement(el) && el.childNodes && el.childNodes.length) {
-            _.each(el.childNodes, function(child) {
-                if (isTextNode(child) && child.textContent) {
-                    elText += _.trim(child.textContent)
-                        // scrub potentially sensitive values
-                        .split(/(\s+)/).filter(shouldTrackValue).join('')
-                        // normalize whitespace
-                        .replace(/[\r\n]/g, ' ').replace(/[ ]+/g, ' ')
-                        // truncate
-                        .substring(0, 255);
-                }
-            });
-        }
-
-        return _.trim(elText);
-    }
-
-    /*
-     * Check whether an element has nodeType Node.ELEMENT_NODE
-     * @param {Element} el - element to check
-     * @returns {boolean} whether el is of the correct nodeType
-     */
-    function isElementNode(el) {
-        return el && el.nodeType === 1; // Node.ELEMENT_NODE - use integer constant for browser portability
-    }
-
-    /*
-     * Check whether an element is of a given tag type.
-     * Due to potential reference discrepancies (such as the webcomponents.js polyfill),
-     * we want to match tagNames instead of specific references because something like
-     * element === document.body won't always work because element might not be a native
-     * element.
-     * @param {Element} el - element to check
-     * @param {string} tag - tag name (e.g., "div")
-     * @returns {boolean} whether el is of the given tag type
-     */
-    function isTag(el, tag) {
-        return el && el.tagName && el.tagName.toLowerCase() === tag.toLowerCase();
-    }
-
-    /*
-     * Check whether an element has nodeType Node.TEXT_NODE
-     * @param {Element} el - element to check
-     * @returns {boolean} whether el is of the correct nodeType
-     */
-    function isTextNode(el) {
-        return el && el.nodeType === 3; // Node.TEXT_NODE - use integer constant for browser portability
-    }
-
-    /*
-     * Check whether a DOM event should be "tracked" or if it may contain sentitive data
-     * using a variety of heuristics.
-     * @param {Element} el - element to check
-     * @param {Event} event - event to check
-     * @returns {boolean} whether the event should be tracked
-     */
-    function shouldTrackDomEvent(el, event) {
-        if (!el || isTag(el, 'html') || !isElementNode(el)) {
-            return false;
-        }
-        var tag = el.tagName.toLowerCase();
-        switch (tag) {
-            case 'html':
-                return false;
-            case 'form':
-                return event.type === 'submit';
-            case 'input':
-                if (['button', 'submit'].indexOf(el.getAttribute('type')) === -1) {
-                    return event.type === 'change';
-                } else {
-                    return event.type === 'click';
-                }
-            case 'select':
-            case 'textarea':
-                return event.type === 'change';
-            default:
-                return event.type === 'click';
-        }
-    }
-
-    /*
-     * Check whether a DOM element should be "tracked" or if it may contain sentitive data
-     * using a variety of heuristics.
-     * @param {Element} el - element to check
-     * @returns {boolean} whether the element should be tracked
-     */
-    function shouldTrackElement(el) {
-        for (var curEl = el; curEl.parentNode && !isTag(curEl, 'body'); curEl = curEl.parentNode) {
-            var classes = getClassName(curEl).split(' ');
-            if (_.includes(classes, 'mp-sensitive') || _.includes(classes, 'mp-no-track')) {
-                return false;
-            }
-        }
-
-        if (_.includes(getClassName(el).split(' '), 'mp-include')) {
-            return true;
-        }
-
-        // don't send data from inputs or similar elements since there will always be
-        // a risk of clientside javascript placing sensitive data in attributes
-        if (
-            isTag(el, 'input') ||
-            isTag(el, 'select') ||
-            isTag(el, 'textarea') ||
-            el.getAttribute('contenteditable') === 'true'
-        ) {
-            return false;
-        }
-
-        // don't include hidden or password fields
-        var type = el.type || '';
-        if (typeof type === 'string') { // it's possible for el.type to be a DOM element if el is a form with a child input[name="type"]
-            switch(type.toLowerCase()) {
-                case 'hidden':
-                    return false;
-                case 'password':
-                    return false;
-            }
-        }
-
-        // filter out data from fields that look like sensitive fields
-        var name = el.name || el.id || '';
-        if (typeof name === 'string') { // it's possible for el.name or el.id to be a DOM element if el is a form with a child input[name="name"]
-            var sensitiveNameRegex = /^cc|cardnum|ccnum|creditcard|csc|cvc|cvv|exp|pass|pwd|routing|seccode|securitycode|securitynum|socialsec|socsec|ssn/i;
-            if (sensitiveNameRegex.test(name.replace(/[^a-zA-Z0-9]/g, ''))) {
-                return false;
-            }
-        }
-
-        return true;
-    }
-
-    /*
-     * Check whether a string value should be "tracked" or if it may contain sentitive data
-     * using a variety of heuristics.
-     * @param {string} value - string value to check
-     * @returns {boolean} whether the element should be tracked
-     */
-    function shouldTrackValue(value) {
-        if (value === null || _.isUndefined(value)) {
-            return false;
-        }
-
-        if (typeof value === 'string') {
-            value = _.trim(value);
-
-            // check to see if input value looks like a credit card number
-            // see: https://www.safaribooksonline.com/library/view/regular-expressions-cookbook/9781449327453/ch04s20.html
-            var ccRegex = /^(?:(4[0-9]{12}(?:[0-9]{3})?)|(5[1-5][0-9]{14})|(6(?:011|5[0-9]{2})[0-9]{12})|(3[47][0-9]{13})|(3(?:0[0-5]|[68][0-9])[0-9]{11})|((?:2131|1800|35[0-9]{3})[0-9]{11}))$/;
-            if (ccRegex.test((value || '').replace(/[- ]/g, ''))) {
-                return false;
-            }
-
-            // check to see if input value looks like a social security number
-            var ssnRegex = /(^\d{3}-?\d{2}-?\d{4}$)/;
-            if (ssnRegex.test(value)) {
-                return false;
-            }
-        }
-
-        return true;
-    }
-
-    var autotrack = {
-        _initializedTokens: [],
-
-        _previousElementSibling: function(el) {
-            if (el.previousElementSibling) {
-                return el.previousElementSibling;
-            } else {
-                do {
-                    el = el.previousSibling;
-                } while (el && !isElementNode(el));
-                return el;
-            }
-        },
-
-        _loadScript: function(scriptUrlToLoad, callback) {
-            var scriptTag = document.createElement('script');
-            scriptTag.type = 'text/javascript';
-            scriptTag.src = scriptUrlToLoad;
-            scriptTag.onload = callback;
-
-            var scripts = document.getElementsByTagName('script');
-            if (scripts.length > 0) {
-                scripts[0].parentNode.insertBefore(scriptTag, scripts[0]);
-            } else {
-                document.body.appendChild(scriptTag);
-            }
-        },
-
-        _getPropertiesFromElement: function(elem) {
-            var props = {
-                'classes': getClassName(elem).split(' '),
-                'tag_name': elem.tagName.toLowerCase()
-            };
-
-            if (shouldTrackElement(elem)) {
-                _.each(elem.attributes, function(attr) {
-                    if (shouldTrackValue(attr.value)) {
-                        props['attr__' + attr.name] = attr.value;
-                    }
-                });
-            }
-
-            var nthChild = 1;
-            var nthOfType = 1;
-            var currentElem = elem;
-            while (currentElem = this._previousElementSibling(currentElem)) { // eslint-disable-line no-cond-assign
-                nthChild++;
-                if (currentElem.tagName === elem.tagName) {
-                    nthOfType++;
-                }
-            }
-            props['nth_child'] = nthChild;
-            props['nth_of_type'] = nthOfType;
-
-            return props;
-        },
-
-        _getDefaultProperties: function(eventType) {
-            return {
-                '$event_type': eventType,
-                '$ce_version': 1,
-                '$host': window.location.host,
-                '$pathname': window.location.pathname
-            };
-        },
-
-        _extractCustomPropertyValue: function(customProperty) {
-            var propValues = [];
-            _.each(document.querySelectorAll(customProperty['css_selector']), function(matchedElem) {
-                var value;
-
-                if (['input', 'select'].indexOf(matchedElem.tagName.toLowerCase()) > -1) {
-                    value = matchedElem['value'];
-                } else if (matchedElem['textContent']) {
-                    value = matchedElem['textContent'];
-                }
-
-                if (shouldTrackValue(value)) {
-                    propValues.push(value);
-                }
-            });
-            return propValues.join(', ');
-        },
-
-        _getCustomProperties: function(targetElementList) {
-            var props = {};
-            _.each(this._customProperties, function(customProperty) {
-                _.each(customProperty['event_selectors'], function(eventSelector) {
-                    var eventElements = document.querySelectorAll(eventSelector);
-                    _.each(eventElements, function(eventElement) {
-                        if (_.includes(targetElementList, eventElement) && shouldTrackElement(eventElement)) {
-                            props[customProperty['name']] = this._extractCustomPropertyValue(customProperty);
-                        }
-                    }, this);
-                }, this);
-            }, this);
-            return props;
-        },
-
-        _getEventTarget: function(e) {
-            // https://developer.mozilla.org/en-US/docs/Web/API/Event/target#Compatibility_notes
-            if (typeof e.target === 'undefined') {
-                return e.srcElement;
-            } else {
-                return e.target;
-            }
-        },
-
-        _trackEvent: function(e, instance) {
-            /*** Don't mess with this code without running IE8 tests on it ***/
-            var target = this._getEventTarget(e);
-            if (isTextNode(target)) { // defeat Safari bug (see: http://www.quirksmode.org/js/events_properties.html)
-                target = target.parentNode;
-            }
-
-            if (shouldTrackDomEvent(target, e)) {
-                var targetElementList = [target];
-                var curEl = target;
-                while (curEl.parentNode && !isTag(curEl, 'body')) {
-                    targetElementList.push(curEl.parentNode);
-                    curEl = curEl.parentNode;
-                }
-
-                var elementsJson = [];
-                var href, explicitNoTrack = false;
-                _.each(targetElementList, function(el) {
-                    var shouldTrackEl = shouldTrackElement(el);
-
-                    // if the element or a parent element is an anchor tag
-                    // include the href as a property
-                    if (el.tagName.toLowerCase() === 'a') {
-                        href = el.getAttribute('href');
-                        href = shouldTrackEl && shouldTrackValue(href) && href;
-                    }
-
-                    // allow users to programatically prevent tracking of elements by adding class 'mp-no-track'
-                    var classes = getClassName(el).split(' ');
-                    if (_.includes(classes, 'mp-no-track')) {
-                        explicitNoTrack = true;
-                    }
-
-                    elementsJson.push(this._getPropertiesFromElement(el));
-                }, this);
-
-                if (explicitNoTrack) {
-                    return false;
-                }
-
-                // only populate text content from target element (not parents)
-                // to prevent text within a sensitive element from being collected
-                // as part of a parent's el.textContent
-                var elementText;
-                var safeElementText = getSafeText(target);
-                if (safeElementText && safeElementText.length) {
-                    elementText = safeElementText;
-                }
-
-                var props = _.extend(
-                    this._getDefaultProperties(e.type),
-                    {
-                        '$elements':  elementsJson,
-                        '$el_attr__href': href,
-                        '$el_text': elementText
-                    },
-                    this._getCustomProperties(targetElementList)
-                );
-
-                instance.track('$web_event', props);
-                return true;
-            }
-        },
-
-        // only reason is to stub for unit tests
-        // since you can't override window.location props
-        _navigate: function(href) {
-            window.location.href = href;
-        },
-
-        _addDomEventHandlers: function(instance) {
-            var handler = _.bind(function(e) {
-                e = e || window.event;
-                this._trackEvent(e, instance);
-            }, this);
-            _.register_event(document, 'submit', handler, false, true);
-            _.register_event(document, 'change', handler, false, true);
-            _.register_event(document, 'click', handler, false, true);
-        },
-
-        _customProperties: {},
-        init: function(instance) {
-            if (!(document && document.body)) {
-                console.log('document not ready yet, trying again in 500 milliseconds...');
-                var that = this;
-                setTimeout(function() { that.init(instance); }, 500);
-                return;
-            }
-
-            var token = instance.get_config('token');
-            if (this._initializedTokens.indexOf(token) > -1) {
-                console.log('autotrack already initialized for token "' + token + '"');
-                return;
-            }
-            this._initializedTokens.push(token);
-
-            if (!this._maybeLoadEditor(instance)) { // don't autotrack actions when the editor is enabled
-                var parseDecideResponse = _.bind(function(response) {
-                    if (response && response['config'] && response['config']['enable_collect_everything'] === true) {
-
-                        if (response['custom_properties']) {
-                            this._customProperties = response['custom_properties'];
-                        }
-
-                        instance.track('$web_event', _.extend({
-                            '$title': document.title
-                        }, this._getDefaultProperties('pageview')));
-
-                        this._addDomEventHandlers(instance);
-
-                    } else {
-                        instance['__autotrack_enabled'] = false;
-                    }
-                }, this);
-
-                instance._send_request(
-                    instance.get_config('api_host') + '/decide/', {
-                        'verbose': true,
-                        'version': '1',
-                        'lib': 'web',
-                        'token': token
-                    },
-                    {method: 'GET', transport: 'XHR'},
-                    instance._prepare_callback(parseDecideResponse)
-                );
-            }
-        },
-
-        _editorParamsFromHash: function(instance, hash) {
-            var editorParams;
-            try {
-                var state = _.getHashParam(hash, 'state');
-                state = JSON.parse(decodeURIComponent(state));
-                var expiresInSeconds = _.getHashParam(hash, 'expires_in');
-                editorParams = {
-                    'accessToken': _.getHashParam(hash, 'access_token'),
-                    'accessTokenExpiresAt': (new Date()).getTime() + (Number(expiresInSeconds) * 1000),
-                    'bookmarkletMode': !!state['bookmarkletMode'],
-                    'projectId': state['projectId'],
-                    'projectOwnerId': state['projectOwnerId'],
-                    'projectToken': state['token'],
-                    'readOnly': state['readOnly'],
-                    'userFlags': state['userFlags'],
-                    'userId': state['userId']
-                };
-                window.sessionStorage.setItem('editorParams', JSON.stringify(editorParams));
-
-                if (state['desiredHash']) {
-                    window.location.hash = state['desiredHash'];
-                } else if (window.history) {
-                    history.replaceState('', document.title, window.location.pathname + window.location.search); // completely remove hash
-                } else {
-                    window.location.hash = ''; // clear hash (but leaves # unfortunately)
-                }
-            } catch (e) {
-                console.error('Unable to parse data from hash', e);
-            }
-            return editorParams;
-        },
-
-        /**
-         * To load the visual editor, we need an access token and other state. That state comes from one of three places:
-         * 1. In the URL hash params if the customer is using an old snippet
-         * 2. From session storage under the key `_mpcehash` if the snippet already parsed the hash
-         * 3. From session storage under the key `editorParams` if the editor was initialized on a previous page
-         */
-        _maybeLoadEditor: function(instance) {
-            try {
-                var parseFromUrl = false;
-                if (_.getHashParam(window.location.hash, 'state')) {
-                    var state = _.getHashParam(window.location.hash, 'state');
-                    state = JSON.parse(decodeURIComponent(state));
-                    parseFromUrl = state['action'] === 'mpeditor';
-                }
-                var parseFromStorage = !!window.sessionStorage.getItem('_mpcehash');
-                var editorParams;
-
-                if (parseFromUrl) { // happens if they are initializing the editor using an old snippet
-                    editorParams = this._editorParamsFromHash(instance, window.location.hash);
-                } else if (parseFromStorage) { // happens if they are initialized the editor and using the new snippet
-                    editorParams = this._editorParamsFromHash(instance, window.sessionStorage.getItem('_mpcehash'));
-                    window.sessionStorage.removeItem('_mpcehash');
-                } else { // get credentials from sessionStorage from a previous initialzation
-                    editorParams = JSON.parse(window.sessionStorage.getItem('editorParams') || '{}');
-                }
-
-                if (editorParams['projectToken'] && instance.get_config('token') === editorParams['projectToken']) {
-                    this._loadEditor(instance, editorParams);
-                    return true;
-                } else {
-                    return false;
-                }
-            } catch (e) {
-                return false;
-            }
-        },
-
-        _loadEditor: function(instance, editorParams) {
-            if (!window['_mpEditorLoaded']) { // only load the codeless event editor once, even if there are multiple instances of MixpanelLib
-                window['_mpEditorLoaded'] = true;
-                var editorUrl = instance.get_config('app_host')
-                  + '/js-bundle/reports/collect-everything/editor.js?_ts='
-                  + (new Date()).getTime();
-                this._loadScript(editorUrl, function() {
-                    window['mp_load_editor'](editorParams);
-                });
-                return true;
-            }
-            return false;
-        },
-
-        // this is a mechanism to ramp up CE with no server-side interaction.
-        // when CE is active, every page load results in a decide request. we
-        // need to gently ramp this up so we don't overload decide. this decides
-        // deterministically if CE is enabled for this project by modding the char
-        // value of the project token.
-        enabledForProject: function(token, numBuckets, numEnabledBuckets) {
-            numBuckets = !_.isUndefined(numBuckets) ? numBuckets : 10;
-            numEnabledBuckets = !_.isUndefined(numEnabledBuckets) ? numEnabledBuckets : 10;
-            var charCodeSum = 0;
-            for (var i = 0; i < token.length; i++) {
-                charCodeSum += token.charCodeAt(i);
-            }
-            return (charCodeSum % numBuckets) < numEnabledBuckets;
-        },
-
-        isBrowserSupported: function() {
-            return _.isFunction(document.querySelectorAll);
-        }
-    };
-
-    _.bind_instance_methods(autotrack);
-    _.safewrap_instance_methods(autotrack);
-
     /**
      * DomTracker Object
      * @constructor
@@ -2285,7 +1763,7 @@
         var elements = _.dom_query(query);
 
         if (elements.length === 0) {
-            console$1.error('The DOM query (' + query + ') returned 0 elements');
+            console.error('The DOM query (' + query + ') returned 0 elements');
             return;
         }
 
@@ -2650,6 +2128,7 @@
                 for (var i = 0; i < storedQueue.length; i++) {
                     var item = storedQueue[i];
                     if (new Date().getTime() > item['flushAfter'] && !idsInBatch[item['id']]) {
+                        item.orphaned = true;
                         batch.push(item);
                         if (batch.length >= batchSize) {
                             break;
@@ -2706,6 +2185,52 @@
         }, this.pid);
     };
 
+    // internal helper for RequestQueue.updatePayloads
+    var updatePayloads = function(existingItems, itemsToUpdate) {
+        var newItems = [];
+        _.each(existingItems, function(item) {
+            var id = item['id'];
+            if (id in itemsToUpdate) {
+                var newPayload = itemsToUpdate[id];
+                if (newPayload !== null) {
+                    item['payload'] = newPayload;
+                    newItems.push(item);
+                }
+            } else {
+                // no update
+                newItems.push(item);
+            }
+        });
+        return newItems;
+    };
+
+    /**
+     * Update payloads of given items in both in-memory queue and
+     * persisted queue. Items set to null are removed from queues.
+     */
+    RequestQueue.prototype.updatePayloads = function(itemsToUpdate, cb) {
+        this.memQueue = updatePayloads(this.memQueue, itemsToUpdate);
+        this.lock.withLock(_.bind(function lockAcquired() {
+            var succeeded;
+            try {
+                var storedQueue = this.readFromStorage();
+                storedQueue = updatePayloads(storedQueue, itemsToUpdate);
+                succeeded = this.saveToStorage(storedQueue);
+            } catch(err) {
+                logger$1.error('Error updating items', itemsToUpdate);
+                succeeded = false;
+            }
+            if (cb) {
+                cb(succeeded);
+            }
+        }, this), function lockFailure(err) {
+            logger$1.error('Error acquiring storage lock', err);
+            if (cb) {
+                cb(false);
+            }
+        }, this.pid);
+    };
+
     /**
      * Read and parse items array from localStorage entry, handling
      * malformed/missing data if necessary.
@@ -2762,18 +2287,18 @@
      * Uses RequestQueue to manage the backing store.
      * @constructor
      */
-    var RequestBatcher = function(storageKey, endpoint, options) {
+    var RequestBatcher = function(storageKey, options) {
         this.queue = new RequestQueue(storageKey, {storage: options.storage});
-        this.endpoint = endpoint;
 
         this.libConfig = options.libConfig;
         this.sendRequest = options.sendRequestFunc;
+        this.beforeSendHook = options.beforeSendHook;
 
         // seed variable batch size + flush interval with configured values
         this.batchSize = this.libConfig['batch_size'];
         this.flushInterval = this.libConfig['batch_flush_interval_ms'];
 
-        this.stopped = false;
+        this.stopped = !this.libConfig['batch_autostart'];
     };
 
     /**
@@ -2853,18 +2378,29 @@
             }
 
             options = options || {};
+            var timeoutMS = this.libConfig['batch_request_timeout_ms'];
+            var startTime = new Date().getTime();
             var currentBatchSize = this.batchSize;
             var batch = this.queue.fillBatch(currentBatchSize);
-            if (batch.length < 1) {
+            var dataForRequest = [];
+            var transformedItems = {};
+            _.each(batch, function(item) {
+                var payload = item['payload'];
+                if (this.beforeSendHook && !item.orphaned) {
+                    payload = this.beforeSendHook(payload);
+                }
+                if (payload) {
+                    dataForRequest.push(payload);
+                }
+                transformedItems[item['id']] = payload;
+            }, this);
+            if (dataForRequest.length < 1) {
                 this.resetFlush();
                 return; // nothing to do
             }
 
             this.requestInProgress = true;
 
-            var timeoutMS = this.libConfig['batch_request_timeout_ms'];
-            var startTime = new Date().getTime();
-            var dataForRequest = _.map(batch, function(item) { return item['payload']; });
             var batchSendCallback = _.bind(function(res) {
                 this.requestInProgress = false;
 
@@ -2874,7 +2410,10 @@
                     // flush operation if something goes wrong
 
                     var removeItemsFromQueue = false;
-                    if (
+                    if (options.unloading) {
+                        // update persisted data to include hook transformations
+                        this.queue.updatePayloads(transformedItems);
+                    } else if (
                         _.isObject(res) &&
                         res.error === 'timeout' &&
                         new Date().getTime() - startTime >= timeoutMS
@@ -2884,9 +2423,9 @@
                     } else if (
                         _.isObject(res) &&
                         res.xhr_req &&
-                        (res.xhr_req['status'] >= 500 || res.xhr_req['status'] <= 0)
+                        (res.xhr_req['status'] >= 500 || res.xhr_req['status'] === 429 || res.error === 'timeout')
                     ) {
-                        // network or API error, retry
+                        // network or API error, or 429 Too Many Requests, retry
                         var retryMS = this.flushInterval * 2;
                         var headers = res.xhr_req['responseHeaders'];
                         if (headers) {
@@ -2934,11 +2473,11 @@
                 ignore_json_errors: true, // eslint-disable-line camelcase
                 timeout_ms: timeoutMS // eslint-disable-line camelcase
             };
-            if (options.sendBeacon) {
+            if (options.unloading) {
                 requestOptions.transport = 'sendBeacon';
             }
-            logger.log('MIXPANEL REQUEST:', this.endpoint, dataForRequest);
-            this.sendRequest(this.endpoint, dataForRequest, requestOptions, batchSendCallback);
+            logger.log('MIXPANEL REQUEST:', dataForRequest);
+            this.sendRequest(dataForRequest, requestOptions, batchSendCallback);
 
         } catch(err) {
             logger.error('Error flushing request queue', err);
@@ -3016,9 +2555,14 @@
      */
     function hasOptedOut(token, options) {
         if (_hasDoNotTrackFlagOn(options)) {
+            console.warn('This browser has "Do Not Track" enabled. This will prevent the Mixpanel SDK from sending any data. To ignore the "Do Not Track" browser setting, initialize the Mixpanel instance with the config "ignore_dnt: true"');
             return true;
         }
-        return _getStorageValue(token, options) === '0';
+        var optedOut = _getStorageValue(token, options) === '0';
+        if (optedOut) {
+            console.warn('You are opted out of Mixpanel tracking. This will prevent the Mixpanel SDK from sending any data.');
+        }
+        return optedOut;
     }
 
     /**
@@ -3451,9 +2995,13 @@
      * Permanently delete a group.
      *
      * ### Usage:
+     *
      *     mixpanel.get_group('company', 'mixpanel').delete();
+     *
+     * @param {Function} [callback] If provided, the callback will be called after the tracking event
      */
     MixpanelGroup.prototype['delete'] = addOptOutCheckMixpanelGroup(function(callback) {
+        // bracket notation above prevents a minification error related to reserved words
         var data = this.delete_action();
         return this._send_request(data, callback);
     });
@@ -3481,7 +3029,8 @@
 
         var date_encoded_data = _.encodeDates(data);
         return this._mixpanel._track_or_batch({
-            truncated_data: _.truncate(date_encoded_data, 255),
+            type: 'groups',
+            data: date_encoded_data,
             endpoint: this._get_config('api_host') + '/groups/',
             batcher: this._mixpanel.request_batchers.groups
         }, callback);
@@ -3552,7 +3101,7 @@
 
         var storage_type = config['persistence'];
         if (storage_type !== 'cookie' && storage_type !== 'localStorage') {
-            console$1.critical('Unknown persistence type ' + storage_type + '; falling back to cookie');
+            console.critical('Unknown persistence type ' + storage_type + '; falling back to cookie');
             storage_type = config['persistence'] = 'cookie';
         }
 
@@ -3910,8 +3459,8 @@
             this._pop_from_people_queue(UNSET_ACTION, q_data);
         }
 
-        console$1.log('MIXPANEL PEOPLE REQUEST (QUEUED, PENDING IDENTIFY):');
-        console$1.log(data);
+        console.log('MIXPANEL PEOPLE REQUEST (QUEUED, PENDING IDENTIFY):');
+        console.log(data);
 
         this.save();
     };
@@ -3954,7 +3503,7 @@
         } else if (queue === UNION_ACTION) {
             return UNION_QUEUE_KEY;
         } else {
-            console$1.error('Invalid queue:', queue);
+            console.error('Invalid queue:', queue);
         }
     };
 
@@ -5922,7 +5471,7 @@
             _.each(prop, function(v, k) {
                 if (!this._is_reserved_property(k)) {
                     if (isNaN(parseFloat(v))) {
-                        console$1.error('Invalid increment value passed to mixpanel.people.increment - must be a number');
+                        console.error('Invalid increment value passed to mixpanel.people.increment - must be a number');
                         return;
                     } else {
                         $add[k] = v;
@@ -6046,7 +5595,7 @@
         if (!_.isNumber(amount)) {
             amount = parseFloat(amount);
             if (isNaN(amount)) {
-                console$1.error('Invalid value passed to mixpanel.people.track_charge - must be a number');
+                console.error('Invalid value passed to mixpanel.people.track_charge - must be a number');
                 return;
             }
         }
@@ -6082,7 +5631,7 @@
     */
     MixpanelPeople.prototype.delete_user = function() {
         if (!this._identify_called()) {
-            console$1.error('mixpanel.people.delete_user() requires you to call identify() first');
+            console.error('mixpanel.people.delete_user() requires you to call identify() first');
             return;
         }
         var data = {'$delete': this._mixpanel.get_distinct_id()};
@@ -6110,7 +5659,6 @@
         }
 
         var date_encoded_data = _.encodeDates(data);
-        var truncated_data = _.truncate(date_encoded_data, 255);
 
         if (!this._identify_called()) {
             this._enqueue(data);
@@ -6121,11 +5669,12 @@
                     callback(-1);
                 }
             }
-            return truncated_data;
+            return _.truncate(date_encoded_data, 255);
         }
 
         return this._mixpanel._track_or_batch({
-            truncated_data: truncated_data,
+            type: 'people',
+            data: date_encoded_data,
             endpoint: this._get_config('api_host') + '/engage/',
             batcher: this._mixpanel.request_batchers.people
         }, callback);
@@ -6156,7 +5705,7 @@
         } else if (UNION_ACTION in data) {
             this._mixpanel['persistence']._add_to_people_queue(UNION_ACTION, data);
         } else {
-            console$1.error('Invalid call to _enqueue():', data);
+            console.error('Invalid call to _enqueue():', data);
         }
     };
 
@@ -6289,6 +5838,9 @@
     var INIT_MODULE  = 0;
     var INIT_SNIPPET = 1;
 
+    var IDENTITY_FUNC = function(x) {return x;};
+    var NOOP_FUNC = function() {};
+
     /** @const */ var PRIMARY_INSTANCE_NAME = 'mixpanel';
 
 
@@ -6321,7 +5873,6 @@
         'api_method':                        'POST',
         'api_transport':                     'XHR',
         'app_host':                          'https://mixpanel.com',
-        'autotrack':                         true,
         'cdn':                               'https://cdn.mxpnl.com',
         'cross_site_cookie':                 false,
         'cross_subdomain_cookie':            true,
@@ -6329,7 +5880,7 @@
         'persistence_name':                  '',
         'cookie_domain':                     '',
         'cookie_name':                       '',
-        'loaded':                            function() {},
+        'loaded':                            NOOP_FUNC,
         'store_google':                      true,
         'save_referrer':                     true,
         'test':                              false,
@@ -6352,10 +5903,12 @@
         'inapp_protocol':                    '//',
         'inapp_link_new_window':             false,
         'ignore_dnt':                        false,
-        'batch_requests':                    false, // for now
+        'batch_requests':                    true,
         'batch_size':                        50,
         'batch_flush_interval_ms':           5000,
-        'batch_request_timeout_ms':          90000
+        'batch_request_timeout_ms':          90000,
+        'batch_autostart':                   true,
+        'hooks':                             {}
     };
 
     var DOM_LOADED = false;
@@ -6383,7 +5936,7 @@
             instance = target;
         } else {
             if (target && !_.isArray(target)) {
-                console$1.error('You have already initialized ' + name);
+                console.error('You have already initialized ' + name);
                 return;
             }
             instance = new MixpanelLib();
@@ -6402,21 +5955,6 @@
         // global debug to be true
         Config.DEBUG = Config.DEBUG || instance.get_config('debug');
 
-        instance['__autotrack_enabled'] = instance.get_config('autotrack');
-        if (instance.get_config('autotrack')) {
-            var num_buckets = 100;
-            var num_enabled_buckets = 100;
-            if (!autotrack.enabledForProject(instance.get_config('token'), num_buckets, num_enabled_buckets)) {
-                instance['__autotrack_enabled'] = false;
-                console$1.log('Not in active bucket: disabling Automatic Event Collection.');
-            } else if (!autotrack.isBrowserSupported()) {
-                instance['__autotrack_enabled'] = false;
-                console$1.log('Disabling Automatic Event Collection because this browser is not supported');
-            } else {
-                autotrack.init(instance);
-            }
-        }
-
         // if target is not defined, we called init after the lib already
         // loaded, so there won't be an array of things to execute
         if (!_.isUndefined(target) && _.isArray(target)) {
@@ -6455,11 +5993,11 @@
      */
     MixpanelLib.prototype.init = function (token, config, name) {
         if (_.isUndefined(name)) {
-            console$1.error('You must name your new library: init(token, config, name)');
+            console.error('You must name your new library: init(token, config, name)');
             return;
         }
         if (name === PRIMARY_INSTANCE_NAME) {
-            console$1.error('You must initialize the main mixpanel object right after you include the Mixpanel js snippet');
+            console.error('You must initialize the main mixpanel object right after you include the Mixpanel js snippet');
             return;
         }
 
@@ -6484,23 +6022,13 @@
         this['config'] = {};
         this['_triggered_notifs'] = [];
 
-        // rollout: enable batch_requests by default for 30% of projects
-        // (only if they have not specified a value in their init config
-        // and they aren't using a custom API host)
-        var variable_features = {};
-        var api_host = config['api_host'];
-        var is_custom_api = !!api_host && !api_host.match(/\.mixpanel\.com$/);
-        if (!('batch_requests' in config) && !is_custom_api && determine_eligibility(token, 'batch', 30)) {
-            variable_features['batch_requests'] = true;
-        }
-
-        this.set_config(_.extend({}, DEFAULT_CONFIG, variable_features, config, {
+        this.set_config(_.extend({}, DEFAULT_CONFIG, config, {
             'name': name,
             'token': token,
             'callback_fn': ((name === PRIMARY_INSTANCE_NAME) ? name : PRIMARY_INSTANCE_NAME + '.' + name) + '._jsc'
         }));
 
-        this['_jsc'] = function() {};
+        this['_jsc'] = NOOP_FUNC;
 
         this.__dom_loaded_queue = [];
         this.__request_queue = [];
@@ -6516,22 +6044,42 @@
         if (this._batch_requests) {
             if (!_.localStorage.is_supported(true) || !USE_XHR) {
                 this._batch_requests = false;
-                console$1.log('Turning off Mixpanel request-queueing; needs XHR and localStorage support');
+                console.log('Turning off Mixpanel request-queueing; needs XHR and localStorage support');
             } else {
-                this.start_batch_requests();
+                this.init_batchers();
                 if (sendBeacon && window$1.addEventListener) {
-                    window$1.addEventListener('unload', _.bind(function() {
-                        // Before page closes, attempt to flush any events queued up via navigator.sendBeacon.
-                        // Since sendBeacon doesn't report success/failure, events will not be removed from
-                        // the persistent store; if the site is loaded again, the events will be flushed again
-                        // on startup and deduplicated on the Mixpanel server side.
-                        this.request_batchers.events.flush({sendBeacon: true});
-                    }, this));
+                    // Before page closes or hides (user tabs away etc), attempt to flush any events
+                    // queued up via navigator.sendBeacon. Since sendBeacon doesn't report success/failure,
+                    // events will not be removed from the persistent store; if the site is loaded again,
+                    // the events will be flushed again on startup and deduplicated on the Mixpanel server
+                    // side.
+                    // There is no reliable way to capture only page close events, so we lean on the
+                    // visibilitychange and pagehide events as recommended at
+                    // https://developer.mozilla.org/en-US/docs/Web/API/Window/unload_event#usage_notes.
+                    // These events fire when the user clicks away from the current page/tab, so will occur
+                    // more frequently than page unload, but are the only mechanism currently for capturing
+                    // this scenario somewhat reliably.
+                    var flush_on_unload = _.bind(function() {
+                        if (!this.request_batchers.events.stopped) {
+                            this.request_batchers.events.flush({unloading: true});
+                        }
+                    }, this);
+                    window$1.addEventListener('pagehide', function(ev) {
+                        if (ev['persisted']) {
+                            flush_on_unload();
+                        }
+                    });
+                    window$1.addEventListener('visibilitychange', function() {
+                        if (document$1['visibilityState'] === 'hidden') {
+                            flush_on_unload();
+                        }
+                    });
                 }
             }
         }
 
         this['persistence'] = this['cookie'] = new MixpanelPersistence(this['config']);
+        this.unpersisted_superprops = {};
         this._gdpr_init();
 
         var uuid = _.UUID();
@@ -6581,7 +6129,7 @@
 
     MixpanelLib.prototype._track_dom = function(DomClass, args) {
         if (this.get_config('img')) {
-            console$1.error('You can\'t use DOM tracking functions with img = true.');
+            console.error('You can\'t use DOM tracking functions with img = true.');
             return false;
         }
 
@@ -6691,9 +6239,16 @@
             try {
                 succeeded = sendBeacon(url, body_data);
             } catch (e) {
-                console$1.error(e);
+                console.error(e);
                 succeeded = false;
             }
+            try {
+                if (callback) {
+                    callback(succeeded ? 1 : 0);
+                }
+            } catch (e) {
+                console.error(e);
+            }
         } else if (USE_XHR) {
             try {
                 var req = new XMLHttpRequest();
@@ -6724,7 +6279,7 @@
                                     try {
                                         response = _.JSONDecode(req.responseText);
                                     } catch (e) {
-                                        console$1.error(e);
+                                        console.error(e);
                                         if (options.ignore_json_errors) {
                                             response = req.responseText;
                                         } else {
@@ -6747,7 +6302,7 @@
                             } else {
                                 error = 'Bad HTTP status: ' + req.status + ' ' + req.statusText;
                             }
-                            console$1.error(error);
+                            console.error(error);
                             if (callback) {
                                 if (verbose_mode) {
                                     callback({status: 0, error: error, xhr_req: req});
@@ -6760,7 +6315,7 @@
                 };
                 req.send(body_data);
             } catch (e) {
-                console$1.error(e);
+                console.error(e);
                 succeeded = false;
             }
         } else {
@@ -6828,32 +6383,53 @@
 
     // request queueing utils
 
-    MixpanelLib.prototype.start_batch_requests = function() {
+    MixpanelLib.prototype.are_batchers_initialized = function() {
+        return !!this.request_batchers.events;
+    };
+
+    MixpanelLib.prototype.init_batchers = function() {
         var token = this.get_config('token');
-        if (!this.request_batchers.events) { // no batchers initialized yet
-            var batcher_config = {
-                libConfig: this['config'],
-                sendRequestFunc: _.bind(function(endpoint, data, options, cb) {
-                    this._send_request(
-                        this.get_config('api_host') + endpoint,
-                        encode_data_for_request(data),
-                        options,
-                        this._prepare_callback(cb, data)
-                    );
-                }, this)
-            };
+        if (!this.are_batchers_initialized()) {
+            var batcher_for = _.bind(function(attrs) {
+                return new RequestBatcher(
+                    '__mpq_' + token + attrs.queue_suffix,
+                    {
+                        libConfig: this['config'],
+                        sendRequestFunc: _.bind(function(data, options, cb) {
+                            this._send_request(
+                                this.get_config('api_host') + attrs.endpoint,
+                                encode_data_for_request(data),
+                                options,
+                                this._prepare_callback(cb, data)
+                            );
+                        }, this),
+                        beforeSendHook: _.bind(function(item) {
+                            return this._run_hook('before_send_' + attrs.type, item);
+                        }, this)
+                    }
+                );
+            }, this);
             this.request_batchers = {
-                events: new RequestBatcher('__mpq_' + token + '_ev', '/track/', batcher_config),
-                people: new RequestBatcher('__mpq_' + token + '_pp', '/engage/', batcher_config),
-                groups: new RequestBatcher('__mpq_' + token + '_gr', '/groups/', batcher_config)
+                events: batcher_for({type: 'events', endpoint: '/track/', queue_suffix: '_ev'}),
+                people: batcher_for({type: 'people', endpoint: '/engage/', queue_suffix: '_pp'}),
+                groups: batcher_for({type: 'groups', endpoint: '/groups/', queue_suffix: '_gr'})
             };
         }
-        _.each(this.request_batchers, function(batcher) {
-            batcher.start();
-        });
+        if (this.get_config('batch_autostart')) {
+            this.start_batch_senders();
+        }
     };
 
-    MixpanelLib.prototype.stop_batch_requests = function() {
+    MixpanelLib.prototype.start_batch_senders = function() {
+        if (this.are_batchers_initialized()) {
+            this._batch_requests = true;
+            _.each(this.request_batchers, function(batcher) {
+                batcher.start();
+            });
+        }
+    };
+
+    MixpanelLib.prototype.stop_batch_senders = function() {
         this._batch_requests = false;
         _.each(this.request_batchers, function(batcher) {
             batcher.stop();
@@ -6898,23 +6474,30 @@
 
     // internal method for handling track vs batch-enqueue logic
     MixpanelLib.prototype._track_or_batch = function(options, callback) {
-        var truncated_data = options.truncated_data;
+        var truncated_data = _.truncate(options.data, 255);
         var endpoint = options.endpoint;
         var batcher = options.batcher;
         var should_send_immediately = options.should_send_immediately;
         var send_request_options = options.send_request_options || {};
-        callback = callback || function() {};
+        callback = callback || NOOP_FUNC;
 
         var request_enqueued_or_initiated = true;
         var send_request_immediately = _.bind(function() {
-            console$1.log('MIXPANEL REQUEST:');
-            console$1.log(truncated_data);
-            return this._send_request(
-                endpoint,
-                encode_data_for_request(truncated_data),
-                send_request_options,
-                this._prepare_callback(callback, truncated_data)
-            );
+            if (!send_request_options.skip_hooks) {
+                truncated_data = this._run_hook('before_send_' + options.type, truncated_data);
+            }
+            if (truncated_data) {
+                console.log('MIXPANEL REQUEST:');
+                console.log(truncated_data);
+                return this._send_request(
+                    endpoint,
+                    encode_data_for_request(truncated_data),
+                    send_request_options,
+                    this._prepare_callback(callback, truncated_data)
+                );
+            } else {
+                return null;
+            }
         }, this);
 
         if (this._batch_requests && !should_send_immediately) {
@@ -6967,11 +6550,11 @@
         }
         var should_send_immediately = options['send_immediately'];
         if (typeof callback !== 'function') {
-            callback = function() {};
+            callback = NOOP_FUNC;
         }
 
         if (_.isUndefined(event_name)) {
-            console$1.error('No event name provided to mixpanel.track');
+            console.error('No event name provided to mixpanel.track');
             return;
         }
 
@@ -7002,6 +6585,7 @@
             {},
             _.info.properties(),
             this['persistence'].properties(),
+            this.unpersisted_superprops,
             properties
         );
 
@@ -7011,7 +6595,7 @@
                 delete properties[blacklisted_prop];
             });
         } else {
-            console$1.error('Invalid value for property_blacklist config: ' + property_blacklist);
+            console.error('Invalid value for property_blacklist config: ' + property_blacklist);
         }
 
         var data = {
@@ -7019,7 +6603,8 @@
             'properties': properties
         };
         var ret = this._track_or_batch({
-            truncated_data: _.truncate(data, 255),
+            type: 'events',
+            data: data,
             endpoint: this.get_config('api_host') + '/track/',
             batcher: this.request_batchers.events,
             should_send_immediately: should_send_immediately,
@@ -7255,7 +6840,7 @@
      */
     MixpanelLib.prototype.time_event = function(event_name) {
         if (_.isUndefined(event_name)) {
-            console$1.error('No event name provided to mixpanel.time_event');
+            console.error('No event name provided to mixpanel.time_event');
             return;
         }
 
@@ -7266,6 +6851,27 @@
         this['persistence'].set_event_timer(event_name,  new Date().getTime());
     };
 
+    var REGISTER_DEFAULTS = {
+        'persistent': true
+    };
+    /**
+     * Helper to parse options param for register methods, maintaining
+     * legacy support for plain "days" param instead of options object
+     * @param {Number|Object} [days_or_options] 'days' option (Number), or Options object for register methods
+     * @returns {Object} options object
+     */
+    var options_for_register = function(days_or_options) {
+        var options;
+        if (_.isObject(days_or_options)) {
+            options = days_or_options;
+        } else if (!_.isUndefined(days_or_options)) {
+            options = {'days': days_or_options};
+        } else {
+            options = {};
+        }
+        return _.extend({}, REGISTER_DEFAULTS, options);
+    };
+
     /**
      * Register a set of super properties, which are included with all
      * events. This will overwrite previous super property values.
@@ -7281,11 +6887,21 @@
      *         'Account Type': 'Free'
      *     });
      *
+     *     // register only for the current pageload
+     *     mixpanel.register({'Name': 'Pat'}, {persistent: false});
+     *
      * @param {Object} properties An associative array of properties to store about the user
-     * @param {Number} [days] How many days since the user's last visit to store the super properties
+     * @param {Number|Object} [days_or_options] Options object or number of days since the user's last visit to store the super properties (only valid for persisted props)
+     * @param {boolean} [days_or_options.days] - number of days since the user's last visit to store the super properties (only valid for persisted props)
+     * @param {boolean} [days_or_options.persistent=true] - whether to put in persistent storage (cookie/localStorage)
      */
-    MixpanelLib.prototype.register = function(props, days) {
-        this['persistence'].register(props, days);
+    MixpanelLib.prototype.register = function(props, days_or_options) {
+        var options = options_for_register(days_or_options);
+        if (options['persistent']) {
+            this['persistence'].register(props, options['days']);
+        } else {
+            _.extend(this.unpersisted_superprops, props);
+        }
     };
 
     /**
@@ -7299,6 +6915,11 @@
      *         'First Login Date': new Date().toISOString()
      *     });
      *
+     *     // register once, only for the current pageload
+     *     mixpanel.register_once({
+     *         'First interaction time': new Date().toISOString()
+     *     }, 'None', {persistent: false});
+     *
      * ### Notes:
      *
      * If default_value is specified, current super properties
@@ -7306,19 +6927,40 @@
      *
      * @param {Object} properties An associative array of properties to store about the user
      * @param {*} [default_value] Value to override if already set in super properties (ex: 'False') Default: 'None'
-     * @param {Number} [days] How many days since the users last visit to store the super properties
+     * @param {Number|Object} [days_or_options] Options object or number of days since the user's last visit to store the super properties (only valid for persisted props)
+     * @param {boolean} [days_or_options.days] - number of days since the user's last visit to store the super properties (only valid for persisted props)
+     * @param {boolean} [days_or_options.persistent=true] - whether to put in persistent storage (cookie/localStorage)
      */
-    MixpanelLib.prototype.register_once = function(props, default_value, days) {
-        this['persistence'].register_once(props, default_value, days);
+    MixpanelLib.prototype.register_once = function(props, default_value, days_or_options) {
+        var options = options_for_register(days_or_options);
+        if (options['persistent']) {
+            this['persistence'].register_once(props, default_value, options['days']);
+        } else {
+            if (typeof(default_value) === 'undefined') {
+                default_value = 'None';
+            }
+            _.each(props, function(val, prop) {
+                if (!this.unpersisted_superprops.hasOwnProperty(prop) || this.unpersisted_superprops[prop] === default_value) {
+                    this.unpersisted_superprops[prop] = val;
+                }
+            }, this);
+        }
     };
 
     /**
      * Delete a super property stored with the current user.
      *
      * @param {String} property The name of the super property to remove
+     * @param {Object} [options]
+     * @param {boolean} [options.persistent=true] - whether to look in persistent storage (cookie/localStorage)
      */
-    MixpanelLib.prototype.unregister = function(property) {
-        this['persistence'].unregister(property);
+    MixpanelLib.prototype.unregister = function(property, options) {
+        options = options_for_register(options);
+        if (options['persistent']) {
+            this['persistence'].unregister(property);
+        } else {
+            delete this.unpersisted_superprops[property];
+        }
     };
 
     MixpanelLib.prototype._register_single = function(prop, value) {
@@ -7389,7 +7031,10 @@
         // send an $identify event any time the distinct_id is changing - logic on the server
         // will determine whether or not to do anything with it.
         if (new_distinct_id !== previous_distinct_id) {
-            this.track('$identify', { 'distinct_id': new_distinct_id, '$anon_distinct_id': previous_distinct_id });
+            this.track('$identify', {
+                'distinct_id': new_distinct_id,
+                '$anon_distinct_id': previous_distinct_id
+            }, {skip_hooks: true});
         }
     };
 
@@ -7468,7 +7113,7 @@
         // mixpanel.people.identify() call made for this user. It is VERY BAD to make an alias with
         // this ID, as it will duplicate users.
         if (alias === this.get_property(PEOPLE_DISTINCT_ID_KEY)) {
-            console$1.critical('Attempting to create alias for existing People user - aborting.');
+            console.critical('Attempting to create alias for existing People user - aborting.');
             return -2;
         }
 
@@ -7478,12 +7123,17 @@
         }
         if (alias !== original) {
             this._register_single(ALIAS_ID_KEY, alias);
-            return this.track('$create_alias', { 'alias': alias, 'distinct_id': original }, function() {
+            return this.track('$create_alias', {
+                'alias': alias,
+                'distinct_id': original
+            }, {
+                skip_hooks: true
+            }, function() {
                 // Flush the people queue
                 _this.identify(alias);
             });
         } else {
-            console$1.error('alias matches current distinct_id - skipping api call.');
+            console.error('alias matches current distinct_id - skipping api call.');
             this.identify(alias);
             return -1;
         }
@@ -7657,6 +7307,21 @@
         return this['config'][prop_name];
     };
 
+    /**
+     * Fetch a hook function from config, with safe default, and run it
+     * against the given arguments
+     * @param {string} hook_name which hook to retrieve
+     * @returns {any|null} return value of user-provided hook, or null if nothing was returned
+     */
+    MixpanelLib.prototype._run_hook = function(hook_name) {
+        var ret = (this['config']['hooks'][hook_name] || IDENTITY_FUNC).apply(this, slice.call(arguments, 1));
+        if (typeof ret === 'undefined') {
+            console.error(hook_name + ' hook did not return a value');
+            ret = null;
+        }
+        return ret;
+    };
+
     /**
      * Returns the value of the super property named property_name. If no such
      * property is set, get_property() will return the undefined value.
@@ -7717,7 +7382,7 @@
             return;
         }
 
-        console$1.log('MIXPANEL NOTIFICATION CHECK');
+        console.log('MIXPANEL NOTIFICATION CHECK');
 
         var data = {
             'verbose':     true,
@@ -8042,7 +7707,8 @@
     MixpanelLib.prototype['add_group']                          = MixpanelLib.prototype.add_group;
     MixpanelLib.prototype['remove_group']                       = MixpanelLib.prototype.remove_group;
     MixpanelLib.prototype['track_with_groups']                  = MixpanelLib.prototype.track_with_groups;
-    MixpanelLib.prototype['stop_batch_requests']                = MixpanelLib.prototype.stop_batch_requests;
+    MixpanelLib.prototype['start_batch_senders']                = MixpanelLib.prototype.start_batch_senders;
+    MixpanelLib.prototype['stop_batch_senders']                 = MixpanelLib.prototype.stop_batch_senders;
 
     // MixpanelPersistence Exports
     MixpanelPersistence.prototype['properties']            = MixpanelPersistence.prototype.properties;
@@ -8162,18 +7828,18 @@
         // Initialization
         if (_.isUndefined(mixpanel_master)) {
             // mixpanel wasn't initialized properly, report error and quit
-            console$1.critical('"mixpanel" object not initialized. Ensure you are using the latest version of the Mixpanel JS Library along with the snippet we provide.');
+            console.critical('"mixpanel" object not initialized. Ensure you are using the latest version of the Mixpanel JS Library along with the snippet we provide.');
             return;
         }
         if (mixpanel_master['__loaded'] || (mixpanel_master['config'] && mixpanel_master['persistence'])) {
             // lib has already been loaded at least once; we don't want to override the global object this time so bomb early
-            console$1.error('Mixpanel library has already been downloaded at least once.');
+            console.critical('The Mixpanel library has already been downloaded at least once. Ensure that the Mixpanel code snippet only appears once on the page (and is not double-loaded by a tag manager) in order to avoid errors.');
             return;
         }
         var snippet_version = mixpanel_master['__SV'] || 0;
         if (snippet_version < 1.1) {
             // mixpanel wasn't initialized properly, report error and quit
-            console$1.critical('Version mismatch; please ensure you\'re using the latest version of the Mixpanel code snippet.');
+            console.critical('Version mismatch; please ensure you\'re using the latest version of the Mixpanel code snippet.');
             return;
         }