mixpanel-browser 2.72.0 → 2.73.0

package/dist/mixpanel.amd.d.ts

@@ -2,7 +2,7 @@ export type Persistence = "cookie" | "localStorage";
 
 export type ApiPayloadFormat = "base64" | "json";
 
-export type PushItem = Array<string | Dict>;
+export type PushItem = Array<string | Dict | ((this: Mixpanel) => void)>;
 
 export type Query = string | Element | Element[];
 
@@ -155,6 +155,11 @@ export interface FlagsConfig {
   context: Dict;
 }
 
+export interface BeforeSendHookPayload {
+  event: string;
+  properties: Record<string, any>;
+}
+
 export interface Config {
   api_host: string;
   api_routes: {
@@ -167,10 +172,13 @@ export interface Config {
   app_host: string;
   api_payload_format: ApiPayloadFormat;
   autotrack: boolean;
+  batch_autostart: boolean;
+  batch_requests: boolean;
   cdn: string;
   cookie_domain: string;
   cross_site_cookie: boolean;
   cross_subdomain_cookie: boolean;
+  error_reporter: (msg: string, err?: Error) => void;
   flags: boolean | FlagsConfig;
   persistence: Persistence;
   persistence_name: string;
@@ -207,10 +215,10 @@ export interface Config {
   inapp_protocol: string;
   inapp_link_new_window: boolean;
   ignore_dnt: boolean;
-  batch_requests: boolean;
   batch_size: number;
   batch_flush_interval_ms: number;
   batch_request_timeout_ms: number;
+  recorder_src: string;
   record_block_class: string | RegExp;
   record_block_selector: string;
   record_collect_fonts: boolean;
@@ -223,6 +231,29 @@ export interface Config {
   record_sessions_percent: number;
   record_canvas: boolean;
   record_heatmap_data: boolean;
+  hooks: {
+    before_identify?: (new_distinct_id: string) => string | null;
+    before_register?: (
+      props: Dict,
+      days_or_options?: number | Partial<RegisterOptions>
+    ) => Dict | Array<Dict | number | Partial<RegisterOptions>> | null;
+    before_register_once?: (
+      props: Dict,
+      default_value?: any,
+      days_or_options?: number | Partial<RegisterOptions>
+    ) => Dict | Array<any | Dict | number | Partial<RegisterOptions>> | null;
+    before_send_events?: (
+      event: BeforeSendHookPayload
+    ) => BeforeSendHookPayload | null;
+    before_track?: (
+      event_name: string,
+      properties: Dict
+    ) => string | Array<string | Dict> | null;
+    before_unregister?: (
+      property: string,
+      options?: Partial<RegisterOptions>
+    ) => string | Partial<RegisterOptions> | null;
+  };
 }
 
 export type VerboseResponse =
@@ -323,10 +354,11 @@ export interface Mixpanel {
   get_distinct_id(): any;
   get_group(group_key: string, group_id: string): Group;
   get_property(property_name: string): any;
+  get_session_replay_url(): string;
   has_opted_in_tracking(options?: Partial<HasOptedInOutOptions>): boolean;
   has_opted_out_tracking(options?: Partial<HasOptedInOutOptions>): boolean;
   identify(unique_id?: string): any;
-  init(token: string, config: Partial<Config>, name: string): Mixpanel;
+  init(token: string, config: Partial<Config>, name?: string): Mixpanel;
   opt_in_tracking(options?: Partial<InTrackingOptions>): void;
   opt_out_tracking(options?: Partial<OutTrackingOptions>): void;
   push(item: PushItem): void;
@@ -351,6 +383,7 @@ export interface Mixpanel {
     group_ids: string | string[] | number | number[],
     callback?: Callback
   ): void;
+  start_batch_senders(): void;
   time_event(event_name: string): void;
   track(
     event_name: string,
@@ -380,6 +413,7 @@ export interface Mixpanel {
   ): void;
   unregister(property: string, options?: Partial<RegisterOptions>): void;
   people: People;
+  start_batch_senders(): void;
   start_session_recording(): void;
   stop_session_recording(): void;
   get_session_recording_properties(): { $mp_replay_id?: string } | {};

package/dist/mixpanel.amd.js

@@ -17,7 +17,9 @@ define((function () { 'use strict';
             screen: { width: 0, height: 0 },
             location: loc,
             addEventListener: function() {},
-            removeEventListener: function() {}
+            removeEventListener: function() {},
+            dispatchEvent: function() {},
+            CustomEvent: function () {}
         };
     } else {
         win = window;
@@ -14532,7 +14534,7 @@ define((function () { 'use strict';
 
     var Config = {
         DEBUG: false,
-        LIB_VERSION: '2.72.0'
+        LIB_VERSION: '2.73.0'
     };
 
     /* eslint camelcase: "off", eqeqeq: "off" */
@@ -21800,8 +21802,6 @@ define((function () { 'use strict';
     var INIT_MODULE  = 0;
     var INIT_SNIPPET = 1;
 
-    var IDENTITY_FUNC = function(x) {return x;};
-
     /** @const */ var PRIMARY_INSTANCE_NAME = 'mixpanel';
     /** @const */ var PAYLOAD_TYPE_BASE64   = 'base64';
     /** @const */ var PAYLOAD_TYPE_JSON     = 'json';
@@ -21967,6 +21967,17 @@ define((function () { 'use strict';
         // global debug to be true
         Config.DEBUG = Config.DEBUG || instance.get_config('debug');
 
+        var source = init_type === INIT_MODULE ? 'module' : 'snippet';
+        win.dispatchEvent(new win.CustomEvent('$mp_sdk_to_extension_event', {
+            'detail': {
+                'instance': instance,
+                'source': source,
+                'token': token,
+                'name': name,
+                'info': _.info
+            }
+        }));
+
         // 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)) {
@@ -22037,6 +22048,8 @@ define((function () { 'use strict';
             }
         }
 
+        this.hooks = {};
+
         this.set_config(_.extend({}, DEFAULT_CONFIG, variable_features, config, {
             'name': name,
             'token': token,
@@ -22637,7 +22650,12 @@ define((function () { 'use strict';
                             );
                         }, this),
                         beforeSendHook: _.bind(function(item) {
-                            return this._run_hook('before_send_' + attrs.type, item);
+                            var ret = this._run_hook('before_send_' + attrs.type, item);
+                            if (ret) {
+                                return ret[0];
+                            } else {
+                                return null;
+                            }
                         }, this),
                         stopAllBatchingFunc: _.bind(this.stop_batch_senders, this),
                         usePersistence: true,
@@ -22730,6 +22748,9 @@ define((function () { 'use strict';
         var send_request_immediately = _.bind(function() {
             if (!send_request_options.skip_hooks) {
                 truncated_data = this._run_hook('before_send_' + options.type, truncated_data);
+                if (truncated_data) {
+                    truncated_data = truncated_data[0];
+                }
             }
             if (truncated_data) {
                 console$1.log('MIXPANEL REQUEST:');
@@ -22784,6 +22805,17 @@ define((function () { 'use strict';
      * with the tracking payload sent to the API server is returned; otherwise false.
      */
     MixpanelLib.prototype.track = addOptOutCheckMixpanelLib(function(event_name, properties, options, callback) {
+        var ret;
+        if (!(options && options.skip_hooks)) {
+            ret = this._run_hook('before_track', event_name, properties);
+            if (ret === null) {
+                return;
+            } else {
+                event_name = ret[0];
+                properties = ret[1];
+            }
+        }
+
         if (!callback && typeof options === 'function') {
             callback = options;
             options = null;
@@ -22853,7 +22885,7 @@ define((function () { 'use strict';
             'event': event_name,
             'properties': properties
         };
-        var ret = this._track_or_batch({
+        ret = this._track_or_batch({
             type: 'events',
             data: data,
             endpoint: this.get_api_host('events') + '/' + this.get_config('api_routes')['track'],
@@ -23199,6 +23231,14 @@ define((function () { 'use strict';
      * @param {boolean} [days_or_options.persistent=true] - whether to put in persistent storage (cookie/localStorage)
      */
     MixpanelLib.prototype.register = function(props, days_or_options) {
+        var ret = this._run_hook('before_register', props, days_or_options);
+        if (ret === null) {
+            return;
+        } else {
+            props = ret[0];
+            days_or_options = ret[1];
+        }
+
         var options = options_for_register(days_or_options);
         if (options['persistent']) {
             this['persistence'].register(props, options['days']);
@@ -23235,6 +23275,15 @@ define((function () { 'use strict';
      * @param {boolean} [days_or_options.persistent=true] - whether to put in persistent storage (cookie/localStorage)
      */
     MixpanelLib.prototype.register_once = function(props, default_value, days_or_options) {
+        var ret = this._run_hook('before_register_once', props, default_value, days_or_options);
+        if (ret === null) {
+            return;
+        } else {
+            props = ret[0];
+            default_value = ret[1];
+            days_or_options = ret[2];
+        }
+
         var options = options_for_register(days_or_options);
         if (options['persistent']) {
             this['persistence'].register_once(props, default_value, options['days']);
@@ -23258,6 +23307,14 @@ define((function () { 'use strict';
      * @param {boolean} [options.persistent=true] - whether to look in persistent storage (cookie/localStorage)
      */
     MixpanelLib.prototype.unregister = function(property, options) {
+        var ret = this._run_hook('before_unregister', property, options);
+        if (ret === null) {
+            return;
+        } else {
+            property = ret[0];
+            options = ret[1];
+        }
+
         options = options_for_register(options);
         if (options['persistent']) {
             this['persistence'].unregister(property);
@@ -23306,6 +23363,13 @@ define((function () { 'use strict';
         //  _set_once_callback:function  A callback to be run if and when the People set_once queue is flushed
         //  _union_callback:function  A callback to be run if and when the People union queue is flushed
         //  _unset_callback:function  A callback to be run if and when the People unset queue is flushed
+        var ret = this._run_hook('before_identify', new_distinct_id);
+
+        if (ret === null) {
+            return -1;
+        } else {
+            new_distinct_id = ret[0];
+        }
 
         var previous_distinct_id = this.get_distinct_id();
         if (new_distinct_id && previous_distinct_id !== new_distinct_id) {
@@ -23630,6 +23694,25 @@ define((function () { 'use strict';
             if (('autocapture' in config || 'record_heatmap_data' in config) && this.autocapture) {
                 this.autocapture.init();
             }
+
+            if (_.isObject(config['hooks'])) {
+                this.hooks = {};
+                _.each(config['hooks'], function(hook_value, hook_name) {
+                    if (_.isFunction(hook_value)) {
+                        this.hooks[hook_name] = [hook_value];
+                    } else if (_.isArray(hook_value)) {
+                        this.hooks[hook_name] = [];
+                        for (var i = 0; i < hook_value.length; i++) {
+                            if (!_.isFunction(hook_value[i])) {
+                                console$1.critical('Invalid hook added. Hook is not a function');
+                            }
+                            this.hooks[hook_name].push(hook_value[i]);
+                        }
+                    } else {
+                        console$1.critical('Invalid hooks added. Ensure that the hook values passed into config.hooks are functions or arrays of functions.');
+                    }
+                }, this);
+            }
         }
     };
 
@@ -23647,12 +23730,26 @@ define((function () { 'use strict';
      * @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') {
-            this.report_error(hook_name + ' hook did not return a value');
-            ret = null;
-        }
-        return ret;
+        var hook_data = slice.call(arguments, 1);
+        _.each(this.hooks[hook_name], function(hook) {
+            if (hook_data === null) {
+                return null;
+            }
+
+            var ret = hook.apply(this, hook_data);
+
+            if (typeof ret === 'undefined') {
+                this.report_error(hook_name + ' hook did not return a valid value');
+                hook_data = null;
+            } else {
+                if (!_.isArray(ret)) {
+                    ret = [ret];
+                }
+                hook_data.splice.apply(hook_data, [0, ret.length].concat(ret));
+            }
+        }, this);
+
+        return hook_data;
     };
 
     /**
@@ -23963,6 +24060,25 @@ define((function () { 'use strict';
         }
     };
 
+    MixpanelLib.prototype.add_hook = function(hook_name, hook_fn) {
+        if (!this.hooks[hook_name]) {
+            this.hooks[hook_name] = [];
+        }
+        this.hooks[hook_name].push(hook_fn);
+    };
+
+    MixpanelLib.prototype.remove_hook = function(hook_name, hook_fn) {
+        var fn_index;
+        if (this.hooks[hook_name]) {
+            fn_index = this.hooks[hook_name].indexOf(hook_fn);
+            if (fn_index !== -1) {
+                this.hooks[hook_name].splice(fn_index, 1);
+            } else {
+                console$1.log('remove_hook failed. Matching hook was not found');
+            }
+        }
+    };
+
     // EXPORTS (for closure compiler)
 
     // MixpanelLib Exports
@@ -23995,6 +24111,8 @@ define((function () { 'use strict';
     MixpanelLib.prototype['set_group']                          = MixpanelLib.prototype.set_group;
     MixpanelLib.prototype['add_group']                          = MixpanelLib.prototype.add_group;
     MixpanelLib.prototype['remove_group']                       = MixpanelLib.prototype.remove_group;
+    MixpanelLib.prototype['add_hook']                           = MixpanelLib.prototype.add_hook;
+    MixpanelLib.prototype['remove_hook']                        = MixpanelLib.prototype.remove_hook;
     MixpanelLib.prototype['track_with_groups']                  = MixpanelLib.prototype.track_with_groups;
     MixpanelLib.prototype['start_batch_senders']                = MixpanelLib.prototype.start_batch_senders;
     MixpanelLib.prototype['stop_batch_senders']                 = MixpanelLib.prototype.stop_batch_senders;

package/dist/mixpanel.cjs.d.ts

@@ -2,7 +2,7 @@ export type Persistence = "cookie" | "localStorage";
 
 export type ApiPayloadFormat = "base64" | "json";
 
-export type PushItem = Array<string | Dict>;
+export type PushItem = Array<string | Dict | ((this: Mixpanel) => void)>;
 
 export type Query = string | Element | Element[];
 
@@ -155,6 +155,11 @@ export interface FlagsConfig {
   context: Dict;
 }
 
+export interface BeforeSendHookPayload {
+  event: string;
+  properties: Record<string, any>;
+}
+
 export interface Config {
   api_host: string;
   api_routes: {
@@ -167,10 +172,13 @@ export interface Config {
   app_host: string;
   api_payload_format: ApiPayloadFormat;
   autotrack: boolean;
+  batch_autostart: boolean;
+  batch_requests: boolean;
   cdn: string;
   cookie_domain: string;
   cross_site_cookie: boolean;
   cross_subdomain_cookie: boolean;
+  error_reporter: (msg: string, err?: Error) => void;
   flags: boolean | FlagsConfig;
   persistence: Persistence;
   persistence_name: string;
@@ -207,10 +215,10 @@ export interface Config {
   inapp_protocol: string;
   inapp_link_new_window: boolean;
   ignore_dnt: boolean;
-  batch_requests: boolean;
   batch_size: number;
   batch_flush_interval_ms: number;
   batch_request_timeout_ms: number;
+  recorder_src: string;
   record_block_class: string | RegExp;
   record_block_selector: string;
   record_collect_fonts: boolean;
@@ -223,6 +231,29 @@ export interface Config {
   record_sessions_percent: number;
   record_canvas: boolean;
   record_heatmap_data: boolean;
+  hooks: {
+    before_identify?: (new_distinct_id: string) => string | null;
+    before_register?: (
+      props: Dict,
+      days_or_options?: number | Partial<RegisterOptions>
+    ) => Dict | Array<Dict | number | Partial<RegisterOptions>> | null;
+    before_register_once?: (
+      props: Dict,
+      default_value?: any,
+      days_or_options?: number | Partial<RegisterOptions>
+    ) => Dict | Array<any | Dict | number | Partial<RegisterOptions>> | null;
+    before_send_events?: (
+      event: BeforeSendHookPayload
+    ) => BeforeSendHookPayload | null;
+    before_track?: (
+      event_name: string,
+      properties: Dict
+    ) => string | Array<string | Dict> | null;
+    before_unregister?: (
+      property: string,
+      options?: Partial<RegisterOptions>
+    ) => string | Partial<RegisterOptions> | null;
+  };
 }
 
 export type VerboseResponse =
@@ -323,10 +354,11 @@ export interface Mixpanel {
   get_distinct_id(): any;
   get_group(group_key: string, group_id: string): Group;
   get_property(property_name: string): any;
+  get_session_replay_url(): string;
   has_opted_in_tracking(options?: Partial<HasOptedInOutOptions>): boolean;
   has_opted_out_tracking(options?: Partial<HasOptedInOutOptions>): boolean;
   identify(unique_id?: string): any;
-  init(token: string, config: Partial<Config>, name: string): Mixpanel;
+  init(token: string, config: Partial<Config>, name?: string): Mixpanel;
   opt_in_tracking(options?: Partial<InTrackingOptions>): void;
   opt_out_tracking(options?: Partial<OutTrackingOptions>): void;
   push(item: PushItem): void;
@@ -351,6 +383,7 @@ export interface Mixpanel {
     group_ids: string | string[] | number | number[],
     callback?: Callback
   ): void;
+  start_batch_senders(): void;
   time_event(event_name: string): void;
   track(
     event_name: string,
@@ -380,6 +413,7 @@ export interface Mixpanel {
   ): void;
   unregister(property: string, options?: Partial<RegisterOptions>): void;
   people: People;
+  start_batch_senders(): void;
   start_session_recording(): void;
   stop_session_recording(): void;
   get_session_recording_properties(): { $mp_replay_id?: string } | {};