mixpanel-browser 2.52.0 → 2.54.0

package/.vscode/launch.json

@@ -0,0 +1,23 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+      {
+        "name": "Mocha (Test single file)",
+        "type": "node",
+        "request": "launch",
+        "env": {
+            "BABEL_ENV": "test"
+        },
+        "runtimeArgs": [
+          "--require",
+          "babel-core/register",
+          "${workspaceRoot}/node_modules/.bin/mocha",
+          "--inspect-brk",
+          "${relativeFile}",
+        ],
+        "console": "integratedTerminal",
+        "internalConsoleOptions": "neverOpen",
+        "port": 9229
+      }
+    ]
+}

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+**2.54.0** (23 Jul 2024)
+- Provides optional builds without session recording module and without asynchronous script loading.
+- Integrates request batcher with session recording module for increased reliability.
+- Improved user inactivity heuristic for session recording timeout.
+- Adds config options to inline images and collect fonts during session recording.
+
+**2.53.0** (21 Jun 2024)
+- Switch to new session-recording network payload format, utilizing client-side compression when available
+- Session-recording methods are now available through Google Tag Manager wrapper
+
+**2.52.0** (7 Jun 2024)
+- Reverted UTM param persistence change from 2.51.0: UTM parameters are again persisted by default
+
+**2.51.0** (30 May 2024)
+- UTM parameter properties are no longer persisted by default
+- Existing superproperties persisted in localStorage are now copied back to cookie storage if the library is initialized with cookie persistence (support migrations from localStorage->cookie)
+- Added session-recording options `record_block_class`, `record_block_selector`, and `record_mask_text_class`
+- Added method `mixpanel.get_session_recording_properties()` for interop with other client-side SDKs
+
+**2.50.0** (26 Apr 2024)
+- Initial support for session recording
+
 **2.49.0** (5 Feb 2024)
 - SPA support in pageview-tracking
 - Support for configurable UTM parameter persistence

package/README.md

@@ -23,6 +23,18 @@ mixpanel.init("YOUR_TOKEN");
 mixpanel.track("An event");
 ```
 
+NOTE: the default `mixpanel-browser` bundle includes a bundled `mixpanel-recorder` SDK. We provide the following options to exclude `mixpanel-recorder` if you do not intend to use session replay or want to reduce bundle size:
+
+To load the core SDK with no option of session recording:
+```javascript
+import mixpanel from 'mixpanel-browser/src/loaders/loader-module-core';
+```
+
+To load the core SDK and optionally load session recording bundle asynchronously (via script tag):
+```javascript
+import mixpanel from 'mixpanel-browser/src/loaders/loader-module-with-async-recorder';
+```
+
 ## Alternative installation via Bower
 `mixpanel-js` is also available via front-end package manager [Bower](http://bower.io/). After installing Bower, fetch into your project's `bower_components` dir with:
 ```sh

package/build.sh

@@ -27,6 +27,8 @@ if [ ! -z "$FULL" ]; then
     echo 'Building module bundles'
     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-core.js -f cjs -o build/mixpanel-core.cjs.js -c rollup.config.js
+    npx rollup -i src/loaders/loader-module-with-async-recorder.js -f cjs -o build/mixpanel-with-async-recorder.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'