mixpanel-browser 2.73.0 → 2.75.0

package/.eslintrc.json

@@ -8,7 +8,9 @@
         "sourceType": "module"
     },
     "rules": {
-        "camelcase": "error",
+        "camelcase": ["error", {
+            "properties": "never"
+        }],
         "eol-last": "error",
         "eqeqeq": "error",
         "indent":
@@ -29,13 +31,14 @@
         ]
     },
     "overrides": [{
-        "files": ["tests/unit/**/*.js"],
+        "files": ["tests/unit/**/*.js", "tests/browser/**/*.js", "*.mjs"],
         "parserOptions": {
-            "ecmaVersion": 8,
+            "ecmaVersion": 9,
             "sourceType": "module"
         },
         "env": {
-            "mocha": true
+            "mocha": true,
+            "node": true
         },
         "rules": {
             "camelcase": "error",

package/.github/workflows/integration-tests.yml

@@ -0,0 +1,52 @@
+name: Integration Tests
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      checks: write  # for dorny/test-reporter to post results
+
+    strategy:
+      fail-fast: false
+      matrix:
+        browser: [chrome-latest, edge-latest, safari-latest, firefox-latest, ios-safari-sim, android-chrome-sim]
+
+    env:
+      SAUCE_USERNAME: ${{ secrets.SAUCE_USERNAME }}
+      SAUCE_ACCESS_KEY: ${{ secrets.SAUCE_ACCESS_KEY }}
+      SAUCE_TUNNEL_NAME: ci-js-sdk-test-${{ matrix.browser }}-${{ github.run_id }}
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js 22.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.x
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build-full
+
+      - name: Sauce test
+        # for some reason, android emulator tests don't work with localhost so we need an IP to give to the runner...
+        run: BROWSER=${{ matrix.browser }} ROOT_DIR=$(pwd) SAUCE_HOST=$(hostname -I | awk '{print $1; exit}') npm run integration-test:sauce
+
+      - name: Test Report
+        uses: dorny/test-reporter@7b7927aa7da8b82e81e755810cb51f39941a2cc7 # v2
+        if: success() || failure() # run this step even if previous step failed
+        with:
+          name: Browser Tests            # Name of the check run which will be created
+          reporter: mocha-json        # Format of test results
+          path: 'tests/browser/results/*.json'    # Path to test results
+          list-tests: 'failed'
+          fail-on-error: 'false'

package/.github/workflows/unit-tests.yml

@@ -0,0 +1,40 @@
+name: Unit Tests
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      checks: write  # for dorny/test-reporter to post results
+
+    strategy:
+      matrix:
+        node-version: [20.x, 22.x, 24.x]
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+      - run: npm ci
+      - run: npm run test:ci
+      - run: npm run build-dist
+
+      - name: Test Report
+        uses: dorny/test-reporter@7b7927aa7da8b82e81e755810cb51f39941a2cc7 # v2
+        if: success() || failure()
+        with:
+          name: Unit Tests
+          reporter: mocha-json
+          path: 'tests/unit/results/*.json'
+          list-tests: 'failed'
+          fail-on-error: 'false'
+

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+**2.75.0** (24 Feb 2026)
+- Adds support for Feature Flags targeting based on events tracked during the current session (Runtime Targeting)
+- Fixes memory leaks in Session Recording on sites which create/destroy iframes
+- Fixes usage of arrow functions in `hooks` config
+
+**2.74.0** (27 Jan 2026)
+- New session recording masking configuration options, including the ability to unmask inputs and allowlist-based selector masking.
+- Adds initial support for the remote settings API, allowing remote configuration of SDK config options.
+- Adds new automated browser test suite that runs in CI and locally in chrome headless. See tests/browser/README.html for more information.
+- Fixes type definitions for api_routes
+- Removes outdated examples in the examples/ dir
+
 **2.73.0** (23 Dec 2025)
 - Adds several new hooks: `before_identify`, `before_register`, `before_register_once`, `before_track`, `before_unregister`
 - Adds instance-initialization notification to allow Data Inspector browser extension to hook into SDK actions

package/README.md

@@ -30,9 +30,9 @@ To load the core SDK with no option of session recording:
 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):
+To load the core SDK and optionally load session recording and targeting bundles asynchronously (via script tag):
 ```javascript
-import mixpanel from 'mixpanel-browser/src/loaders/loader-module-with-async-recorder';
+import mixpanel from 'mixpanel-browser/src/loaders/loader-module-with-async-modules';
 ```
 
 ## Use as a browser JavaScript module
@@ -67,7 +67,7 @@ mixpanel.init('YOUR_TOKEN', {autocapture: true, debug: true, persistence: 'local
 - Install development dependencies: `npm install`
 - Run unit tests: `npm test`
 - Start test server for browser tests: `npm run integration_test`
-- Browse to [http://localhost:3000/tests/](http://localhost:3000/tests/) and choose a scenario to run
+- Browse to [http://localhost:3001/tests/](http://localhost:3001/tests/) and choose a scenario to run
 
 In the future we plan to automate the last step with a headless browser to streamline development (although
 Mixpanel production releases are tested against a large matrix of browsers and operating systems).

package/build.sh

@@ -19,15 +19,11 @@ if [ ! -z "$FULL" ]; then
     npx webpack tests/module-cjs.js tests/module-cjs.bundle.js
     npx browserify tests/module-es2015.js -t [ babelify --compact false ] --outfile tests/module-es2015.bundle.js
 
-    echo 'Bundling module-loader examples'
-    pushd examples/commonjs-browserify; npm install && npm run build; popd
-    pushd examples/es2015-babelify; npm install && npm run build; popd
-    pushd examples/umd-webpack; npm install && npm run build; popd
     pushd examples/typescript; npm install && npm run build; popd
 fi
 
 if [ ! -z "$DIST" ]; then
     echo 'Copying to dist/'
     rm -r dist
-    cp -r build dist
+    rsync -av --exclude='test' build/ dist/
 fi

package/dist/mixpanel-core.cjs.d.ts

@@ -6,6 +6,8 @@ export type PushItem = Array<string | Dict | ((this: Mixpanel) => void)>;
 
 export type Query = string | Element | Element[];
 
+export type RemoteSettingType = "disabled" | "fallback" | "strict";
+
 export interface Dict {
   [key: string]: any;
 }
@@ -166,6 +168,8 @@ export interface Config {
     track?: string;
     engage?: string;
     groups?: string;
+    record?: string;
+    flags?: string;
   };
   api_method: string;
   api_transport: string;
@@ -225,12 +229,18 @@ export interface Config {
   record_idle_timeout_ms: number;
   record_inline_images: boolean;
   record_mask_text_class: string | RegExp;
-  record_mask_text_selector: string;
+  record_mask_text_selector: string | string[];
+  record_unmask_text_selector: string | string[];
+  record_mask_all_text: boolean;
+  record_mask_input_selector: string | string[];
+  record_unmask_input_selector: string | string[];
+  record_mask_all_inputs: boolean;
   record_min_ms: number;
   record_max_ms: number;
   record_sessions_percent: number;
   record_canvas: boolean;
   record_heatmap_data: boolean;
+  remote_settings_mode: RemoteSettingType;
   hooks: {
     before_identify?: (new_distinct_id: string) => string | null;
     before_register?: (
@@ -256,6 +266,7 @@ export interface Config {
   };
 }
 
+
 export type VerboseResponse =
   | {
       status: 1;