@amplitude/session-replay-browser 1.26.2 → 1.28.0

package/lib/cjs/plugins/url-tracking-plugin.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.urlTrackingPlugin = exports.createUrlTrackingPlugin = void 0;
+var tslib_1 = require("tslib");
+var helpers_1 = require("../helpers");
+var constants_1 = require("../constants");
+/**
+ * Creates a URL tracking plugin for rrweb record function
+ *
+ * This plugin monitors URL changes in the browser and emits events when the URL changes.
+ * It supports three tracking modes:
+ * 1. Polling (if explicitly enabled) - periodically checks for URL changes
+ * 2. History API + Hash routing (default) - patches pushState/replaceState, listens to popstate and hashchange
+ * 3. Hash routing only (fallback) - listens to hashchange events when History API is unavailable
+ *
+ * The plugin handles edge cases gracefully:
+ * - Missing or null location objects
+ * - Undefined, null, or empty location.href values
+ * - Temporal dead zone issues with variable declarations
+ * - Consistent URL normalization across all code paths
+ *
+ * @param options Configuration options for URL tracking
+ * @returns RecordPlugin instance that can be used with rrweb
+ */
+function createUrlTrackingPlugin(options) {
+    if (options === void 0) { options = {}; }
+    return {
+        name: 'amplitude/url-tracking@1',
+        observer: function (cb, globalScope, pluginOptions) {
+            var _a, _b, _c;
+            // Merge options with plugin-level options taking precedence over constructor options
+            var config = tslib_1.__assign(tslib_1.__assign({}, options), pluginOptions);
+            var ugcFilterRules = config.ugcFilterRules || [];
+            var enablePolling = (_a = config.enablePolling) !== null && _a !== void 0 ? _a : false;
+            var pollingInterval = (_b = config.pollingInterval) !== null && _b !== void 0 ? _b : constants_1.DEFAULT_URL_CHANGE_POLLING_INTERVAL;
+            var captureDocumentTitle = (_c = config.captureDocumentTitle) !== null && _c !== void 0 ? _c : false;
+            // Early return if no global scope is available
+            if (!globalScope) {
+                return function () {
+                    // No cleanup needed if no global scope available
+                };
+            }
+            // Track the last URL to prevent duplicate events
+            // Initialize to undefined to ensure first call always emits an event
+            var lastTrackedUrl = undefined;
+            // Helper functions
+            /**
+             * Gets the current URL with proper normalization
+             * Handles edge cases where location.href might be undefined, null, or empty
+             * Ensures consistent behavior across all code paths
+             * @returns Normalized URL string (empty string if location unavailable)
+             */
+            var getCurrentUrl = function () {
+                if (!globalScope.location)
+                    return '';
+                return globalScope.location.href || '';
+            };
+            /**
+             * Creates a URL change event with current page information
+             * Applies UGC filtering if rules are configured
+             * Uses getCurrentUrl() for consistent URL normalization
+             * @returns URLChangeEvent with current page state
+             */
+            var createUrlChangeEvent = function () {
+                var innerHeight = globalScope.innerHeight, innerWidth = globalScope.innerWidth, document = globalScope.document;
+                var currentUrl = getCurrentUrl();
+                var currentTitle = '';
+                if (captureDocumentTitle) {
+                    currentTitle = (document === null || document === void 0 ? void 0 : document.title) || '';
+                }
+                // Apply UGC filtering if rules are provided, otherwise use original URL
+                var filteredUrl = ugcFilterRules.length > 0 ? (0, helpers_1.getPageUrl)(currentUrl, ugcFilterRules) : currentUrl;
+                return {
+                    href: filteredUrl,
+                    title: currentTitle,
+                    viewportHeight: innerHeight,
+                    viewportWidth: innerWidth,
+                    type: 'url-change-event',
+                };
+            };
+            /**
+             * Emits a URL change event if the URL has actually changed
+             * Always emits on first call (when lastTrackedUrl is undefined)
+             * Prevents duplicate events for the same URL on subsequent calls
+             * Handles edge cases like undefined/null/empty URLs gracefully
+             */
+            var emitUrlChange = function () {
+                var currentUrl = getCurrentUrl();
+                // Always emit on first call, or if URL actually changed
+                if (lastTrackedUrl === undefined || currentUrl !== lastTrackedUrl) {
+                    lastTrackedUrl = currentUrl;
+                    var event_1 = createUrlChangeEvent();
+                    cb(event_1);
+                }
+            };
+            /**
+             * Creates a patched version of history methods (pushState/replaceState)
+             * that calls the original method and then emits a URL change event
+             * Ensures URL changes are detected even when history methods are called programmatically
+             * @param originalMethod The original history method to patch
+             * @returns Patched function that calls original method then emits URL change event
+             */
+            var createHistoryMethodPatch = function (originalMethod) {
+                return function () {
+                    var args = [];
+                    for (var _i = 0; _i < arguments.length; _i++) {
+                        args[_i] = arguments[_i];
+                    }
+                    // Call the original history method first
+                    var result = originalMethod.apply(this, args);
+                    // Then emit URL change event
+                    emitUrlChange();
+                    return result;
+                };
+            };
+            // Hashchange event handler - delegates to emitUrlChange for consistency
+            var hashChangeHandler = function () {
+                emitUrlChange();
+            };
+            // 1. if explicitly enable polling → use polling
+            if (enablePolling) {
+                // Use polling (covers everything)
+                var urlChangeInterval_1 = globalScope.setInterval(function () {
+                    emitUrlChange();
+                }, pollingInterval);
+                // Emit initial URL immediately
+                emitUrlChange();
+                // Return cleanup function to stop polling
+                return function () {
+                    if (urlChangeInterval_1) {
+                        globalScope.clearInterval(urlChangeInterval_1);
+                    }
+                };
+            }
+            // 2. if polling not enabled → check history, if exist, use history
+            if (globalScope.history) {
+                // Use History API + hashchange (covers History API + hash routing)
+                // Store original history methods for restoration during cleanup
+                var originalPushState_1 = globalScope.history.pushState.bind(globalScope.history);
+                var originalReplaceState_1 = globalScope.history.replaceState.bind(globalScope.history);
+                /**
+                 * Sets up history method patching to intercept pushState and replaceState calls
+                 * This ensures URL changes are detected even when history methods are called programmatically
+                 */
+                var setupHistoryPatching = function () {
+                    // Patch pushState to emit URL change events
+                    globalScope.history.pushState = createHistoryMethodPatch(originalPushState_1);
+                    // Patch replaceState to emit URL change events
+                    globalScope.history.replaceState = createHistoryMethodPatch(originalReplaceState_1);
+                };
+                // Apply history method patches
+                setupHistoryPatching();
+                // Listen to popstate events for browser back/forward navigation
+                globalScope.addEventListener('popstate', emitUrlChange);
+                // Listen to hashchange events for hash routing
+                globalScope.addEventListener('hashchange', hashChangeHandler);
+                // Emit initial URL immediately
+                emitUrlChange();
+                // Return cleanup function to restore original state
+                return function () {
+                    // Restore original history methods
+                    globalScope.history.pushState = originalPushState_1;
+                    globalScope.history.replaceState = originalReplaceState_1;
+                    // Remove popstate event listener
+                    globalScope.removeEventListener('popstate', emitUrlChange);
+                    // Remove hashchange event listener
+                    globalScope.removeEventListener('hashchange', hashChangeHandler);
+                };
+            }
+            // 3. if not, then the framework is probably using hash router → do hash
+            // Fallback: just hashchange (for pure hash routing)
+            globalScope.addEventListener('hashchange', hashChangeHandler);
+            emitUrlChange();
+            return function () {
+                globalScope.removeEventListener('hashchange', hashChangeHandler);
+            };
+        },
+        options: options,
+    };
+}
+exports.createUrlTrackingPlugin = createUrlTrackingPlugin;
+/**
+ * Default URL tracking plugin instance with default options
+ * Can be used directly without custom configuration
+ */
+exports.urlTrackingPlugin = createUrlTrackingPlugin();
+//# sourceMappingURL=url-tracking-plugin.js.map

package/lib/cjs/plugins/url-tracking-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-tracking-plugin.js","sourceRoot":"","sources":["../../../src/plugins/url-tracking-plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import { getPageUrl } from '../helpers';\nimport { UGCFilterRule } from '../config/types';\nimport { DEFAULT_URL_CHANGE_POLLING_INTERVAL } from '../constants';\nimport { RecordPlugin } from '@amplitude/rrweb-types';\n\n/**\n * Event emitted when URL changes are detected by the plugin\n * Contains the current page URL, title, and viewport dimensions\n */\nexport interface URLChangeEvent {\n  /** The current page URL (may be filtered if UGC rules are applied) */\n  href: string;\n  /** The current page title */\n  title: string;\n  /** Viewport height in pixels */\n  viewportHeight: number;\n  /** Viewport width in pixels */\n  viewportWidth: number;\n  /** The type of URL change event */\n  type: string;\n}\n\n/**\n * Configuration options for the URL tracking plugin\n */\nexport interface URLTrackingPluginOptions {\n  /** Rules for filtering sensitive URLs (User Generated Content) */\n  ugcFilterRules?: UGCFilterRule[];\n  /** Whether to use polling instead of history API events for URL detection */\n  enablePolling?: boolean;\n  /** Interval in milliseconds for polling URL changes (default: 1000ms) */\n  pollingInterval?: number;\n  /** Whether to capture document title in URL change events (default: false) */\n  captureDocumentTitle?: boolean;\n}\n\n/**\n * Creates a URL tracking plugin for rrweb record function\n *\n * This plugin monitors URL changes in the browser and emits events when the URL changes.\n * It supports three tracking modes:\n * 1. Polling (if explicitly enabled) - periodically checks for URL changes\n * 2. History API + Hash routing (default) - patches pushState/replaceState, listens to popstate and hashchange\n * 3. Hash routing only (fallback) - listens to hashchange events when History API is unavailable\n *\n * The plugin handles edge cases gracefully:\n * - Missing or null location objects\n * - Undefined, null, or empty location.href values\n * - Temporal dead zone issues with variable declarations\n * - Consistent URL normalization across all code paths\n *\n * @param options Configuration options for URL tracking\n * @returns RecordPlugin instance that can be used with rrweb\n */\nexport function createUrlTrackingPlugin(\n  options: URLTrackingPluginOptions = {},\n): RecordPlugin<URLTrackingPluginOptions> {\n  return {\n    name: 'amplitude/url-tracking@1',\n    observer(cb, globalScope, pluginOptions?: URLTrackingPluginOptions) {\n      // Merge options with plugin-level options taking precedence over constructor options\n      const config = { ...options, ...pluginOptions };\n      const ugcFilterRules = config.ugcFilterRules || [];\n      const enablePolling = config.enablePolling ?? false;\n      const pollingInterval = config.pollingInterval ?? DEFAULT_URL_CHANGE_POLLING_INTERVAL;\n      const captureDocumentTitle = config.captureDocumentTitle ?? false;\n\n      // Early return if no global scope is available\n      if (!globalScope) {\n        return () => {\n          // No cleanup needed if no global scope available\n        };\n      }\n\n      // Track the last URL to prevent duplicate events\n      // Initialize to undefined to ensure first call always emits an event\n      let lastTrackedUrl: string | undefined = undefined;\n\n      // Helper functions\n      /**\n       * Gets the current URL with proper normalization\n       * Handles edge cases where location.href might be undefined, null, or empty\n       * Ensures consistent behavior across all code paths\n       * @returns Normalized URL string (empty string if location unavailable)\n       */\n      const getCurrentUrl = (): string => {\n        if (!globalScope.location) return '';\n        return globalScope.location.href || '';\n      };\n\n      /**\n       * Creates a URL change event with current page information\n       * Applies UGC filtering if rules are configured\n       * Uses getCurrentUrl() for consistent URL normalization\n       * @returns URLChangeEvent with current page state\n       */\n      const createUrlChangeEvent = (): URLChangeEvent => {\n        const { innerHeight, innerWidth, document } = globalScope;\n        const currentUrl = getCurrentUrl();\n        let currentTitle = '';\n        if (captureDocumentTitle) {\n          currentTitle = document?.title || '';\n        }\n\n        // Apply UGC filtering if rules are provided, otherwise use original URL\n        const filteredUrl = ugcFilterRules.length > 0 ? getPageUrl(currentUrl, ugcFilterRules) : currentUrl;\n\n        return {\n          href: filteredUrl,\n          title: currentTitle,\n          viewportHeight: innerHeight,\n          viewportWidth: innerWidth,\n          type: 'url-change-event',\n        };\n      };\n\n      /**\n       * Emits a URL change event if the URL has actually changed\n       * Always emits on first call (when lastTrackedUrl is undefined)\n       * Prevents duplicate events for the same URL on subsequent calls\n       * Handles edge cases like undefined/null/empty URLs gracefully\n       */\n      const emitUrlChange = (): void => {\n        const currentUrl = getCurrentUrl();\n\n        // Always emit on first call, or if URL actually changed\n        if (lastTrackedUrl === undefined || currentUrl !== lastTrackedUrl) {\n          lastTrackedUrl = currentUrl;\n          const event = createUrlChangeEvent();\n          cb(event);\n        }\n      };\n\n      /**\n       * Creates a patched version of history methods (pushState/replaceState)\n       * that calls the original method and then emits a URL change event\n       * Ensures URL changes are detected even when history methods are called programmatically\n       * @param originalMethod The original history method to patch\n       * @returns Patched function that calls original method then emits URL change event\n       */\n      const createHistoryMethodPatch = <T extends typeof history.pushState | typeof history.replaceState>(\n        originalMethod: T,\n      ) => {\n        return function (this: History, ...args: Parameters<T>) {\n          // Call the original history method first\n          const result = originalMethod.apply(this, args);\n          // Then emit URL change event\n          emitUrlChange();\n          return result;\n        };\n      };\n\n      // Hashchange event handler - delegates to emitUrlChange for consistency\n      const hashChangeHandler = () => {\n        emitUrlChange();\n      };\n\n      // 1. if explicitly enable polling → use polling\n      if (enablePolling) {\n        // Use polling (covers everything)\n        const urlChangeInterval = globalScope.setInterval(() => {\n          emitUrlChange();\n        }, pollingInterval);\n\n        // Emit initial URL immediately\n        emitUrlChange();\n\n        // Return cleanup function to stop polling\n        return () => {\n          if (urlChangeInterval) {\n            globalScope.clearInterval(urlChangeInterval);\n          }\n        };\n      }\n\n      // 2. if polling not enabled → check history, if exist, use history\n      if (globalScope.history) {\n        // Use History API + hashchange (covers History API + hash routing)\n        // Store original history methods for restoration during cleanup\n        const originalPushState = globalScope.history.pushState.bind(globalScope.history);\n        const originalReplaceState = globalScope.history.replaceState.bind(globalScope.history);\n\n        /**\n         * Sets up history method patching to intercept pushState and replaceState calls\n         * This ensures URL changes are detected even when history methods are called programmatically\n         */\n        const setupHistoryPatching = (): void => {\n          // Patch pushState to emit URL change events\n          globalScope.history.pushState = createHistoryMethodPatch(originalPushState);\n\n          // Patch replaceState to emit URL change events\n          globalScope.history.replaceState = createHistoryMethodPatch(originalReplaceState);\n        };\n\n        // Apply history method patches\n        setupHistoryPatching();\n\n        // Listen to popstate events for browser back/forward navigation\n        globalScope.addEventListener('popstate', emitUrlChange);\n        // Listen to hashchange events for hash routing\n        globalScope.addEventListener('hashchange', hashChangeHandler);\n\n        // Emit initial URL immediately\n        emitUrlChange();\n\n        // Return cleanup function to restore original state\n        return () => {\n          // Restore original history methods\n          globalScope.history.pushState = originalPushState;\n          globalScope.history.replaceState = originalReplaceState;\n\n          // Remove popstate event listener\n          globalScope.removeEventListener('popstate', emitUrlChange);\n          // Remove hashchange event listener\n          globalScope.removeEventListener('hashchange', hashChangeHandler);\n        };\n      }\n\n      // 3. if not, then the framework is probably using hash router → do hash\n      // Fallback: just hashchange (for pure hash routing)\n      globalScope.addEventListener('hashchange', hashChangeHandler);\n      emitUrlChange();\n      return () => {\n        globalScope.removeEventListener('hashchange', hashChangeHandler);\n      };\n    },\n    options,\n  };\n}\n\n/**\n * Default URL tracking plugin instance with default options\n * Can be used directly without custom configuration\n */\nexport const urlTrackingPlugin = createUrlTrackingPlugin();\n"]}

package/lib/cjs/session-replay-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-replay-factory.d.ts","sourceRoot":"","sources":["../../src/session-replay-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,eAAO,MAAM,YAAY,kBAAmB,aAAa,WAAS,SAOjE,CAAC;;AA0BF,wBAAgC"}
+{"version":3,"file":"session-replay-factory.d.ts","sourceRoot":"","sources":["../../src/session-replay-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,eAAO,MAAM,YAAY,kBAAmB,aAAa,WAAS,SAOjE,CAAC;;AA+BF,wBAAgC"}

package/lib/cjs/session-replay-factory.js

@@ -17,6 +17,7 @@ var createInstance = function () {
     var sessionReplay = new session_replay_1.SessionReplay();
     return {
         init: (0, analytics_core_1.debugWrapper)(sessionReplay.init.bind(sessionReplay), 'init', (0, exports.getLogConfig)(sessionReplay)),
+        evaluateTargetingAndCapture: (0, analytics_core_1.debugWrapper)(sessionReplay.evaluateTargetingAndCapture.bind(sessionReplay), 'evaluateTargetingAndRecord', (0, exports.getLogConfig)(sessionReplay)),
         setSessionId: (0, analytics_core_1.debugWrapper)(sessionReplay.setSessionId.bind(sessionReplay), 'setSessionId', (0, exports.getLogConfig)(sessionReplay)),
         getSessionId: (0, analytics_core_1.debugWrapper)(sessionReplay.getSessionId.bind(sessionReplay), 'getSessionId', (0, exports.getLogConfig)(sessionReplay)),
         getSessionReplayProperties: (0, analytics_core_1.debugWrapper)(sessionReplay.getSessionReplayProperties.bind(sessionReplay), 'getSessionReplayProperties', (0, exports.getLogConfig)(sessionReplay)),

package/lib/cjs/session-replay-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-replay-factory.js","sourceRoot":"","sources":["../../src/session-replay-factory.ts"],"names":[],"mappings":";;;AAAA,4DAAoE;AACpE,sDAAyD;AACzD,mDAAiD;AAG1C,IAAM,YAAY,GAAG,UAAC,aAA4B,IAAK,OAAA;IACpD,IAAA,MAAM,GAAK,aAAa,OAAlB,CAAmB;IAC3B,IAAA,KAAuC,MAAM,IAAI,IAAA,+BAAgB,GAAE,EAAjD,MAAM,oBAAA,EAAE,QAAQ,cAAiC,CAAC;IAC1E,OAAO;QACL,MAAM,QAAA;QACN,QAAQ,UAAA;KACT,CAAC;AACJ,CAAC,EAP6D,CAO7D,CAAC;AAPW,QAAA,YAAY,gBAOvB;AAEF,IAAM,cAAc,GAAiC;IACnD,IAAM,aAAa,GAAG,IAAI,8BAAa,EAAE,CAAC;IAC1C,OAAO;QACL,IAAI,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;QAC/F,YAAY,EAAE,IAAA,6BAAY,EACxB,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,EAC9C,cAAc,EACd,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,YAAY,EAAE,IAAA,6BAAY,EACxB,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,EAC9C,cAAc,EACd,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,0BAA0B,EAAE,IAAA,6BAAY,EACtC,aAAa,CAAC,0BAA0B,CAAC,IAAI,CAAC,aAAa,CAAC,EAC5D,4BAA4B,EAC5B,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,KAAK,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;QAClG,QAAQ,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;KAC5G,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,cAAc,EAAE,CAAC","sourcesContent":["import { debugWrapper, LogConfig } from '@amplitude/analytics-core';\nimport { getDefaultConfig } from './config/local-config';\nimport { SessionReplay } from './session-replay';\nimport { AmplitudeSessionReplay } from './typings/session-replay';\n\nexport const getLogConfig = (sessionReplay: SessionReplay) => (): LogConfig => {\n  const { config } = sessionReplay;\n  const { loggerProvider: logger, logLevel } = config || getDefaultConfig();\n  return {\n    logger,\n    logLevel,\n  };\n};\n\nconst createInstance: () => AmplitudeSessionReplay = () => {\n  const sessionReplay = new SessionReplay();\n  return {\n    init: debugWrapper(sessionReplay.init.bind(sessionReplay), 'init', getLogConfig(sessionReplay)),\n    setSessionId: debugWrapper(\n      sessionReplay.setSessionId.bind(sessionReplay),\n      'setSessionId',\n      getLogConfig(sessionReplay),\n    ),\n    getSessionId: debugWrapper(\n      sessionReplay.getSessionId.bind(sessionReplay),\n      'getSessionId',\n      getLogConfig(sessionReplay),\n    ),\n    getSessionReplayProperties: debugWrapper(\n      sessionReplay.getSessionReplayProperties.bind(sessionReplay),\n      'getSessionReplayProperties',\n      getLogConfig(sessionReplay),\n    ),\n    flush: debugWrapper(sessionReplay.flush.bind(sessionReplay), 'flush', getLogConfig(sessionReplay)),\n    shutdown: debugWrapper(sessionReplay.shutdown.bind(sessionReplay), 'shutdown', getLogConfig(sessionReplay)),\n  };\n};\n\nexport default createInstance();\n"]}
+{"version":3,"file":"session-replay-factory.js","sourceRoot":"","sources":["../../src/session-replay-factory.ts"],"names":[],"mappings":";;;AAAA,4DAAoE;AACpE,sDAAyD;AACzD,mDAAiD;AAG1C,IAAM,YAAY,GAAG,UAAC,aAA4B,IAAK,OAAA;IACpD,IAAA,MAAM,GAAK,aAAa,OAAlB,CAAmB;IAC3B,IAAA,KAAuC,MAAM,IAAI,IAAA,+BAAgB,GAAE,EAAjD,MAAM,oBAAA,EAAE,QAAQ,cAAiC,CAAC;IAC1E,OAAO;QACL,MAAM,QAAA;QACN,QAAQ,UAAA;KACT,CAAC;AACJ,CAAC,EAP6D,CAO7D,CAAC;AAPW,QAAA,YAAY,gBAOvB;AAEF,IAAM,cAAc,GAAiC;IACnD,IAAM,aAAa,GAAG,IAAI,8BAAa,EAAE,CAAC;IAC1C,OAAO;QACL,IAAI,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;QAC/F,2BAA2B,EAAE,IAAA,6BAAY,EACvC,aAAa,CAAC,2BAA2B,CAAC,IAAI,CAAC,aAAa,CAAC,EAC7D,4BAA4B,EAC5B,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,YAAY,EAAE,IAAA,6BAAY,EACxB,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,EAC9C,cAAc,EACd,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,YAAY,EAAE,IAAA,6BAAY,EACxB,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,EAC9C,cAAc,EACd,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,0BAA0B,EAAE,IAAA,6BAAY,EACtC,aAAa,CAAC,0BAA0B,CAAC,IAAI,CAAC,aAAa,CAAC,EAC5D,4BAA4B,EAC5B,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,KAAK,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;QAClG,QAAQ,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;KAC5G,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,cAAc,EAAE,CAAC","sourcesContent":["import { debugWrapper, LogConfig } from '@amplitude/analytics-core';\nimport { getDefaultConfig } from './config/local-config';\nimport { SessionReplay } from './session-replay';\nimport { AmplitudeSessionReplay } from './typings/session-replay';\n\nexport const getLogConfig = (sessionReplay: SessionReplay) => (): LogConfig => {\n  const { config } = sessionReplay;\n  const { loggerProvider: logger, logLevel } = config || getDefaultConfig();\n  return {\n    logger,\n    logLevel,\n  };\n};\n\nconst createInstance: () => AmplitudeSessionReplay = () => {\n  const sessionReplay = new SessionReplay();\n  return {\n    init: debugWrapper(sessionReplay.init.bind(sessionReplay), 'init', getLogConfig(sessionReplay)),\n    evaluateTargetingAndCapture: debugWrapper(\n      sessionReplay.evaluateTargetingAndCapture.bind(sessionReplay),\n      'evaluateTargetingAndRecord',\n      getLogConfig(sessionReplay),\n    ),\n    setSessionId: debugWrapper(\n      sessionReplay.setSessionId.bind(sessionReplay),\n      'setSessionId',\n      getLogConfig(sessionReplay),\n    ),\n    getSessionId: debugWrapper(\n      sessionReplay.getSessionId.bind(sessionReplay),\n      'getSessionId',\n      getLogConfig(sessionReplay),\n    ),\n    getSessionReplayProperties: debugWrapper(\n      sessionReplay.getSessionReplayProperties.bind(sessionReplay),\n      'getSessionReplayProperties',\n      getLogConfig(sessionReplay),\n    ),\n    flush: debugWrapper(sessionReplay.flush.bind(sessionReplay), 'flush', getLogConfig(sessionReplay)),\n    shutdown: debugWrapper(sessionReplay.shutdown.bind(sessionReplay), 'shutdown', getLogConfig(sessionReplay)),\n  };\n};\n\nexport default createInstance();\n"]}

package/lib/cjs/session-replay.d.ts

@@ -1,8 +1,9 @@
 import { ILogger } from '@amplitude/analytics-core';
+import { TargetingParameters } from '@amplitude/targeting';
 import { LoggingConfig, SessionReplayJoinedConfig, SessionReplayJoinedConfigGenerator } from './config/types';
 import { CustomRRwebEvent } from './constants';
-import { AmplitudeSessionReplay, SessionReplayEventsManager as AmplitudeSessionReplayEventsManager, SessionIdentifiers as ISessionIdentifiers, SessionReplayOptions } from './typings/session-replay';
 import { EventCompressor } from './events/event-compressor';
+import { AmplitudeSessionReplay, SessionReplayEventsManager as AmplitudeSessionReplayEventsManager, SessionIdentifiers as ISessionIdentifiers, SessionReplayOptions } from './typings/session-replay';
 import type { RecordFunction } from './utils/rrweb';
 type PageLeaveFn = (e: PageTransitionEvent | Event) => void;
 export declare class SessionReplay implements AmplitudeSessionReplay {
@@ -15,6 +16,9 @@ export declare class SessionReplay implements AmplitudeSessionReplay {
     recordCancelCallback: ReturnType<RecordFunction> | null;
     eventCount: number;
     eventCompressor: EventCompressor | undefined;
+    sessionTargetingMatch: boolean;
+    private lastTargetingParams?;
+    private lastShouldRecordDecision?;
     pageLeaveFns: PageLeaveFn[];
     private scrollHook?;
     private networkObservers?;
@@ -25,7 +29,11 @@ export declare class SessionReplay implements AmplitudeSessionReplay {
     private teardownEventListeners;
     protected _init(apiKey: string, options: SessionReplayOptions): Promise<void>;
     setSessionId(sessionId: string | number, deviceId?: string): import("@amplitude/analytics-core").AmplitudeReturn<void>;
-    asyncSetSessionId(sessionId: string | number, deviceId?: string): Promise<void>;
+    asyncSetSessionId(sessionId: string | number, deviceId?: string, options?: {
+        userProperties?: {
+            [key: string]: any;
+        };
+    }): Promise<void>;
     getSessionReplayProperties(): {
         [key: string]: string | null;
     };
@@ -37,13 +45,14 @@ export declare class SessionReplay implements AmplitudeSessionReplay {
      * prevent duplicate listener actions from firing.
      */
     private pageLeaveListener;
+    evaluateTargetingAndCapture: (targetingParams: Pick<TargetingParameters, 'event' | 'userProperties'>, isInit?: boolean) => Promise<void>;
     sendEvents(sessionId?: string | number): void;
     initialize(shouldSendStoredEvents?: boolean): Promise<void>;
     shouldOptOut(): boolean | undefined;
     getShouldRecord(): boolean;
     getBlockSelectors(): string | string[] | undefined;
     getMaskTextSelectors(): string | undefined;
-    getRecordingPlugins(loggingConfig: LoggingConfig | undefined): Promise<import("@amplitude/rrweb-types").RecordPlugin<unknown>[] | undefined>;
+    getRecordingPlugins(loggingConfig: LoggingConfig | undefined): Promise<(import("@amplitude/rrweb-types").RecordPlugin<import("./plugins/url-tracking-plugin").URLTrackingPluginOptions> | import("@amplitude/rrweb-types").RecordPlugin<unknown>)[] | undefined>;
     private getRecordFunction;
     recordEvents(shouldLogMetadata?: boolean): Promise<void>;
     addCustomRRWebEvent: (eventName: CustomRRwebEvent, eventData?: {

package/lib/cjs/session-replay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/session-replay.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,OAAO,EAER,MAAM,2BAA2B,CAAC;AAKnC,OAAO,EACL,aAAa,EACb,yBAAyB,EACzB,kCAAkC,EAInC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,gBAAgB,EAMjB,MAAM,aAAa,CAAC;AAOrB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,IAAI,mCAAmC,EAIjE,kBAAkB,IAAI,mBAAmB,EACzC,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAK5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,KAAK,WAAW,GAAG,CAAC,CAAC,EAAE,mBAAmB,GAAG,KAAK,KAAK,IAAI,CAAC;AAE5D,qBAAa,aAAc,YAAW,sBAAsB;IAC1D,IAAI,SAAuC;IAC3C,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAC9C,qBAAqB,EAAE,kCAAkC,GAAG,SAAS,CAAC;IACtE,WAAW,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC7C,aAAa,CAAC,EAAE,mCAAmC,CAAC,QAAQ,GAAG,aAAa,EAAE,MAAM,CAAC,CAAC;IACtF,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,UAAU,CAAC,cAAc,CAAC,GAAG,IAAI,CAAQ;IAC/D,UAAU,SAAK;IACf,eAAe,EAAE,eAAe,GAAG,SAAS,CAAC;IAG7C,YAAY,EAAE,WAAW,EAAE,CAAM;IACjC,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAoC;IAGpD,OAAO,CAAC,cAAc,CAA+B;;IAMrD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB;IAIlD,OAAO,CAAC,sBAAsB,CAmB5B;cAEc,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB;IAwFnE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAIpD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAqBrE,0BAA0B;;;IAsC1B,YAAY,aAEV;IAEF,aAAa,aAIX;IAEF;;;;OAIG;IACH,OAAO,CAAC,iBAAiB,CAIvB;IAEF,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAShC,UAAU,CAAC,sBAAsB,UAAQ;IAgB/C,YAAY;IAUZ,eAAe;IAwBf,iBAAiB,IAAI,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAWlD,oBAAoB,IAAI,MAAM,GAAG,SAAS;IAapC,mBAAmB,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS;YA2BpD,iBAAiB;IAezB,YAAY,CAAC,iBAAiB,UAAO;IA4G3C,mBAAmB,cACN,gBAAgB;;kDAmC3B;IAEF,mBAAmB,aAUjB;IAEF,WAAW;IAIX,YAAY;IAIN,KAAK,CAAC,QAAQ,UAAQ;IAI5B,QAAQ;IAMR,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,WAAW;YAyBL,0BAA0B;CAUzC"}
+{"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/session-replay.ts"],"names":[],"mappings":"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"}

package/lib/cjs/session-replay.js

@@ -7,21 +7,24 @@ var analytics_core_1 = require("@amplitude/analytics-core");
 var rrweb_types_1 = require("@amplitude/rrweb-types");
 var joined_config_1 = require("./config/joined-config");
 var constants_1 = require("./constants");
+var event_compressor_1 = require("./events/event-compressor");
 var events_manager_1 = require("./events/events-manager");
 var multi_manager_1 = require("./events/multi-manager");
 var helpers_1 = require("./helpers");
 var click_1 = require("./hooks/click");
 var scroll_1 = require("./hooks/scroll");
 var identifiers_1 = require("./identifiers");
-var version_1 = require("./version");
-var event_compressor_1 = require("./events/event-compressor");
 var logger_1 = require("./logger");
+var targeting_manager_1 = require("./targeting/targeting-manager");
+var version_1 = require("./version");
+var url_tracking_plugin_1 = require("./plugins/url-tracking-plugin");
 var SessionReplay = /** @class */ (function () {
     function SessionReplay() {
         var _this = this;
         this.name = '@amplitude/session-replay-browser';
         this.recordCancelCallback = null;
         this.eventCount = 0;
+        this.sessionTargetingMatch = false;
         // Visible for testing only
         this.pageLeaveFns = [];
         // Cache the dynamically imported record function
@@ -65,6 +68,60 @@ var SessionReplay = /** @class */ (function () {
                 fn(e);
             });
         };
+        this.evaluateTargetingAndCapture = function (targetingParams, isInit) {
+            if (isInit === void 0) { isInit = false; }
+            return tslib_1.__awaiter(_this, void 0, void 0, function () {
+                var eventForTargeting, _a;
+                return tslib_1.__generator(this, function (_b) {
+                    switch (_b.label) {
+                        case 0:
+                            if (!this.identifiers || !this.identifiers.sessionId || !this.config) {
+                                if (this.identifiers && !this.identifiers.sessionId) {
+                                    this.loggerProvider.log('Session ID has not been set yet, cannot evaluate targeting for Session Replay.');
+                                }
+                                else {
+                                    this.loggerProvider.warn('Session replay init has not been called, cannot evaluate targeting.');
+                                }
+                                return [2 /*return*/];
+                            }
+                            // Store targeting parameters for use in getShouldRecord
+                            this.lastTargetingParams = targetingParams;
+                            if (!(this.config.targetingConfig && !this.sessionTargetingMatch)) return [3 /*break*/, 2];
+                            eventForTargeting = targetingParams.event;
+                            if (eventForTargeting &&
+                                Object.values(analytics_core_1.SpecialEventType).includes(eventForTargeting.event_type)) {
+                                eventForTargeting = undefined;
+                            }
+                            // We're setting this on this class because fetching the value from idb
+                            // is async, we need to access this value synchronously (for record
+                            // and for getSessionReplayProperties - both synchronous fns)
+                            _a = this;
+                            return [4 /*yield*/, (0, targeting_manager_1.evaluateTargetingAndStore)({
+                                    sessionId: this.identifiers.sessionId,
+                                    targetingConfig: this.config.targetingConfig,
+                                    loggerProvider: this.loggerProvider,
+                                    apiKey: this.config.apiKey,
+                                    targetingParams: { userProperties: targetingParams.userProperties, event: eventForTargeting },
+                                })];
+                        case 1:
+                            // We're setting this on this class because fetching the value from idb
+                            // is async, we need to access this value synchronously (for record
+                            // and for getSessionReplayProperties - both synchronous fns)
+                            _a.sessionTargetingMatch = _b.sent();
+                            _b.label = 2;
+                        case 2:
+                            if (!isInit) return [3 /*break*/, 3];
+                            void this.initialize(true);
+                            return [3 /*break*/, 5];
+                        case 3: return [4 /*yield*/, this.recordEvents()];
+                        case 4:
+                            _b.sent();
+                            _b.label = 5;
+                        case 5: return [2 /*return*/];
+                    }
+                });
+            });
+        };
         this.addCustomRRWebEvent = function (eventName, eventData, addStorageInfo) {
             if (eventData === void 0) { eventData = {}; }
             if (addStorageInfo === void 0) { addStorageInfo = true; }
@@ -212,7 +269,9 @@ var SessionReplay = /** @class */ (function () {
                         _j.sent();
                         this.loggerProvider.log('Installing @amplitude/session-replay-browser.');
                         this.teardownEventListeners(false);
-                        void this.initialize(true);
+                        return [4 /*yield*/, this.evaluateTargetingAndCapture({ userProperties: options.userProperties }, true)];
+                    case 12:
+                        _j.sent();
                         return [2 /*return*/];
                 }
             });
@@ -221,12 +280,14 @@ var SessionReplay = /** @class */ (function () {
     SessionReplay.prototype.setSessionId = function (sessionId, deviceId) {
         return (0, analytics_core_1.returnWrapper)(this.asyncSetSessionId(sessionId, deviceId));
     };
-    SessionReplay.prototype.asyncSetSessionId = function (sessionId, deviceId) {
+    SessionReplay.prototype.asyncSetSessionId = function (sessionId, deviceId, options) {
         return tslib_1.__awaiter(this, void 0, void 0, function () {
             var previousSessionId, deviceIdForReplayId, joinedConfig;
             return tslib_1.__generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
+                        this.sessionTargetingMatch = false;
+                        this.lastShouldRecordDecision = undefined; // Reset targeting decision for new session
                         previousSessionId = this.identifiers && this.identifiers.sessionId;
                         if (previousSessionId) {
                             this.sendEvents(previousSessionId);
@@ -242,8 +303,9 @@ var SessionReplay = /** @class */ (function () {
                         joinedConfig = (_a.sent()).joinedConfig;
                         this.config = joinedConfig;
                         _a.label = 2;
-                    case 2:
-                        void this.recordEvents();
+                    case 2: return [4 /*yield*/, this.evaluateTargetingAndCapture({ userProperties: options === null || options === void 0 ? void 0 : options.userProperties })];
+                    case 3:
+                        _a.sent();
                         return [2 /*return*/];
                 }
             });
@@ -330,11 +392,49 @@ var SessionReplay = /** @class */ (function () {
             this.loggerProvider.log("Opting session ".concat(this.identifiers.sessionId, " out of recording due to optOut config."));
             return false;
         }
-        var isInSample = (0, helpers_1.isSessionInSample)(this.identifiers.sessionId, this.config.sampleRate);
-        if (!isInSample) {
-            this.loggerProvider.log("Opting session ".concat(this.identifiers.sessionId, " out of recording due to sample rate."));
+        var shouldRecord = false;
+        var message = '';
+        var matched = false;
+        // If targetingConfig exists, we'll use the sessionTargetingMatch to determine whether to record
+        // Otherwise, we'll evaluate the session against the overall sample rate
+        if (this.config.targetingConfig) {
+            if (!this.sessionTargetingMatch) {
+                message = "Not capturing replays for session ".concat(this.identifiers.sessionId, " due to not matching targeting conditions.");
+                this.loggerProvider.log(message);
+                shouldRecord = false;
+                matched = false;
+            }
+            else {
+                message = "Capturing replays for session ".concat(this.identifiers.sessionId, " due to matching targeting conditions.");
+                this.loggerProvider.log(message);
+                shouldRecord = true;
+                matched = true;
+            }
+        }
+        else {
+            var isInSample = (0, helpers_1.isSessionInSample)(this.identifiers.sessionId, this.config.sampleRate);
+            if (!isInSample) {
+                message = "Opting session ".concat(this.identifiers.sessionId, " out of recording due to sample rate.");
+                this.loggerProvider.log(message);
+                shouldRecord = false;
+                matched = false;
+            }
+            else {
+                shouldRecord = true;
+                matched = true;
+            }
         }
-        return isInSample;
+        // Only send custom rrweb event for targeting decision when the decision changes
+        if (this.lastShouldRecordDecision !== shouldRecord && this.config.targetingConfig) {
+            void this.addCustomRRWebEvent(constants_1.CustomRRwebEvent.TARGETING_DECISION, {
+                message: message,
+                sessionId: this.identifiers.sessionId,
+                matched: matched,
+                targetingParams: this.lastTargetingParams,
+            });
+            this.lastShouldRecordDecision = shouldRecord;
+        }
+        return shouldRecord;
     };
     SessionReplay.prototype.getBlockSelectors = function () {
         var _a, _b, _c;
@@ -359,24 +459,37 @@ var SessionReplay = /** @class */ (function () {
         return maskSelector;
     };
     SessionReplay.prototype.getRecordingPlugins = function (loggingConfig) {
-        var _a;
+        var _a, _b, _c, _d, _e, _f;
         return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var plugins, getRecordConsolePlugin, error_3;
-            return tslib_1.__generator(this, function (_b) {
-                switch (_b.label) {
+            var plugins, urlTrackingPlugin, getRecordConsolePlugin, error_3;
+            return tslib_1.__generator(this, function (_g) {
+                switch (_g.label) {
                     case 0:
                         plugins = [];
-                        if (!((_a = loggingConfig === null || loggingConfig === void 0 ? void 0 : loggingConfig.console) === null || _a === void 0 ? void 0 : _a.enabled)) return [3 /*break*/, 4];
-                        _b.label = 1;
+                        // Add URL tracking plugin
+                        try {
+                            urlTrackingPlugin = (0, url_tracking_plugin_1.createUrlTrackingPlugin)({
+                                ugcFilterRules: ((_b = (_a = this.config) === null || _a === void 0 ? void 0 : _a.interactionConfig) === null || _b === void 0 ? void 0 : _b.ugcFilterRules) || [],
+                                enablePolling: ((_c = this.config) === null || _c === void 0 ? void 0 : _c.enableUrlChangePolling) || false,
+                                pollingInterval: (_d = this.config) === null || _d === void 0 ? void 0 : _d.urlChangePollingInterval,
+                                captureDocumentTitle: (_e = this.config) === null || _e === void 0 ? void 0 : _e.captureDocumentTitle,
+                            });
+                            plugins.push(urlTrackingPlugin);
+                        }
+                        catch (error) {
+                            this.loggerProvider.warn('Failed to create URL tracking plugin:', error);
+                        }
+                        if (!((_f = loggingConfig === null || loggingConfig === void 0 ? void 0 : loggingConfig.console) === null || _f === void 0 ? void 0 : _f.enabled)) return [3 /*break*/, 4];
+                        _g.label = 1;
                     case 1:
-                        _b.trys.push([1, 3, , 4]);
+                        _g.trys.push([1, 3, , 4]);
                         return [4 /*yield*/, Promise.resolve().then(function () { return tslib_1.__importStar(require('@amplitude/rrweb-plugin-console-record')); })];
                     case 2:
-                        getRecordConsolePlugin = (_b.sent()).getRecordConsolePlugin;
+                        getRecordConsolePlugin = (_g.sent()).getRecordConsolePlugin;
                         plugins.push(getRecordConsolePlugin({ level: loggingConfig.console.levels }));
                         return [3 /*break*/, 4];
                     case 3:
-                        error_3 = _b.sent();
+                        error_3 = _g.sent();
                         this.loggerProvider.warn('Failed to load console plugin:', error_3);
                         return [3 /*break*/, 4];
                     case 4: return [2 /*return*/, plugins.length > 0 ? plugins : undefined];