@amplitude/session-replay-browser 1.51.4 → 1.52.0-codexsemantic-review-integration.0

package/lib/esm/session-replay.js

@@ -1,4 +1,7 @@
 import { __assign, __awaiter, __generator, __read, __spreadArray, __values } from "tslib";
+import { ReplaySemanticAdapter } from './semantic';
+import { getSemanticIdentity } from './semantic-identity';
+import { finder } from './libs/finder';
 import { createPrivacyRecorderOptions, getBlockSelectors, getMaskTextSelectors, } from '@amplitude/session-replay-dom-privacy';
 import { getAnalyticsConnector, getGlobalScope, Logger, returnWrapper, SpecialEventType, generateHashCode, getOrCreateWindowMessenger, enableBackgroundCapture, AMPLITUDE_ORIGINS_MAP, } from '@amplitude/analytics-core';
 // Import only specific types to avoid pulling in the entire rrweb-types package
@@ -261,18 +264,21 @@ var SessionReplay = /** @class */ (function () {
                 });
             });
         };
-        this.stopRecordingEvents = function () {
-            var _a, _b, _c;
+        this.stopRecordingEvents = function (reason, state) {
+            var _a, _b, _c, _d;
+            if (reason === void 0) { reason = 'targeting'; }
+            if (state === void 0) { state = 'stop'; }
             try {
+                (_a = _this.semanticAdapter) === null || _a === void 0 ? void 0 : _a.stop(reason, state);
                 _this.loggerProvider.log('Session Replay capture stopping.');
                 _this.recordCancelCallback && _this.recordCancelCallback();
                 _this.recordCancelCallback = null;
-                (_a = _this.networkObservers) === null || _a === void 0 ? void 0 : _a.stop();
-                (_b = _this.crossOriginIframeCoordinator) === null || _b === void 0 ? void 0 : _b.stop();
+                (_b = _this.networkObservers) === null || _b === void 0 ? void 0 : _b.stop();
+                (_c = _this.crossOriginIframeCoordinator) === null || _c === void 0 ? void 0 : _c.stop();
                 _this.crossOriginIframeCoordinator = null;
                 // Remove the child-mode parent signal listener so a later mode change
                 // (e.g. crossOriginIframes disabled) does not leave a stale listener.
-                (_c = _this.crossOriginParentSignalCleanup) === null || _c === void 0 ? void 0 : _c.call(_this);
+                (_d = _this.crossOriginParentSignalCleanup) === null || _d === void 0 ? void 0 : _d.call(_this);
                 _this.crossOriginParentSignalCleanup = null;
             }
             catch (error) {
@@ -343,17 +349,19 @@ var SessionReplay = /** @class */ (function () {
         return currentUrl != null ? { url: currentUrl } : undefined;
     };
     SessionReplay.prototype._init = function (apiKey, options) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
         return __awaiter(this, void 0, void 0, function () {
-            var now, _q, _r, joinedConfig, localConfig, remoteConfig, scrollWatcher, managers, storeType, compressionWorkerScript, trackDestinationWorkerScript, globalScope, _s, compressionScript, trackDestinationScript, rrwebEventManager, error_1, typedError, payloadBatcher, interactionEventManager, error_2, typedError, onFullSnapshotProcessed, pending_2, pending_1, pending_1_1, _t, event_1, sessionId, messenger, needsUrlTracking;
-            var e_2, _u;
+            var now, _r, _s, joinedConfig, localConfig, remoteConfig, scrollWatcher, managers, storeType, compressionWorkerScript, trackDestinationWorkerScript, globalScope, _t, compressionScript, trackDestinationScript, rrwebEventManager, error_1, typedError, payloadBatcher, interactionEventManager, error_2, typedError, onFullSnapshotProcessed, pending_2, pending_1, pending_1_1, _u, event_1, sessionId, messenger, needsUrlTracking;
+            var e_2, _v;
             var _this = this;
-            return __generator(this, function (_v) {
-                switch (_v.label) {
+            return __generator(this, function (_w) {
+                switch (_w.label) {
                     case 0:
                         // Re-init should always tear down any previous URL-change subscription, even when the
                         // next config has no targeting config and we don't subscribe again.
                         (_a = this.urlChangeCleanup) === null || _a === void 0 ? void 0 : _a.call(this);
+                        (_b = this.semanticAdapter) === null || _b === void 0 ? void 0 : _b.stop('customer_stop');
+                        this.semanticAdapter = undefined;
                         // A new init always allows capture again. `stop()` only pauses the current instance.
                         this.recordingEnabled = true;
                         this.startChildRecordingOnSetup = false;
@@ -366,19 +374,19 @@ var SessionReplay = /** @class */ (function () {
                         pruneStaleReplayStartTimes(apiKey, now, this.loggerProvider);
                         this.sessionStartTime =
                             options.sessionId !== undefined
-                                ? (_b = getOrInitReplayStartTime(apiKey, options.sessionId, now, this.loggerProvider)) !== null && _b !== void 0 ? _b : now
+                                ? (_c = getOrInitReplayStartTime(apiKey, options.sessionId, now, this.loggerProvider)) !== null && _c !== void 0 ? _c : now
                                 : now;
-                        _q = this;
+                        _r = this;
                         return [4 /*yield*/, createSessionReplayJoinedConfigGenerator(apiKey, options)];
                     case 1:
-                        _q.joinedConfigGenerator = _v.sent();
+                        _r.joinedConfigGenerator = _w.sent();
                         return [4 /*yield*/, this.joinedConfigGenerator.generateJoinedConfig()];
                     case 2:
-                        _r = _v.sent(), joinedConfig = _r.joinedConfig, localConfig = _r.localConfig, remoteConfig = _r.remoteConfig;
+                        _s = _w.sent(), joinedConfig = _s.joinedConfig, localConfig = _s.localConfig, remoteConfig = _s.remoteConfig;
                         this.config = joinedConfig;
-                        this.setMetadata(options.sessionId, joinedConfig, localConfig, remoteConfig, (_c = options.version) === null || _c === void 0 ? void 0 : _c.version, VERSION, (_d = options.version) === null || _d === void 0 ? void 0 : _d.type);
+                        this.setMetadata(options.sessionId, joinedConfig, localConfig, remoteConfig, (_d = options.version) === null || _d === void 0 ? void 0 : _d.version, VERSION, (_e = options.version) === null || _e === void 0 ? void 0 : _e.type);
                         this.pageLeaveFns = [];
-                        if (options.sessionId && ((_e = this.config.interactionConfig) === null || _e === void 0 ? void 0 : _e.enabled)) {
+                        if (options.sessionId && ((_f = this.config.interactionConfig) === null || _f === void 0 ? void 0 : _f.enabled)) {
                             scrollWatcher = ScrollWatcher.default({
                                 sessionId: options.sessionId,
                                 type: 'interaction',
@@ -389,7 +397,7 @@ var SessionReplay = /** @class */ (function () {
                         }
                         managers = [];
                         storeType = this.config.storeType;
-                        if (storeType === 'idb' && !((_f = getGlobalScope()) === null || _f === void 0 ? void 0 : _f.indexedDB)) {
+                        if (storeType === 'idb' && !((_g = getGlobalScope()) === null || _g === void 0 ? void 0 : _g.indexedDB)) {
                             storeType = 'memory';
                             this.loggerProvider.warn('Could not use preferred indexedDB storage, reverting to in memory option.');
                         }
@@ -398,42 +406,42 @@ var SessionReplay = /** @class */ (function () {
                         if (!(this.config.useWebWorker && globalScope && globalScope.Worker)) return [3 /*break*/, 4];
                         return [4 /*yield*/, import('./worker')];
                     case 3:
-                        _s = _v.sent(), compressionScript = _s.compressionScript, trackDestinationScript = _s.trackDestinationScript;
+                        _t = _w.sent(), compressionScript = _t.compressionScript, trackDestinationScript = _t.trackDestinationScript;
                         compressionWorkerScript = compressionScript;
                         trackDestinationWorkerScript = trackDestinationScript;
-                        _v.label = 4;
+                        _w.label = 4;
                     case 4:
-                        _v.trys.push([4, 6, , 7]);
+                        _w.trys.push([4, 6, , 7]);
                         return [4 /*yield*/, createEventsManager({
                                 config: this.config,
                                 type: 'replay',
-                                minInterval: (_g = this.config.flushIntervalConfig) === null || _g === void 0 ? void 0 : _g.minIntervalMs,
-                                maxInterval: (_h = this.config.flushIntervalConfig) === null || _h === void 0 ? void 0 : _h.maxIntervalMs,
+                                minInterval: (_h = this.config.flushIntervalConfig) === null || _h === void 0 ? void 0 : _h.minIntervalMs,
+                                maxInterval: (_j = this.config.flushIntervalConfig) === null || _j === void 0 ? void 0 : _j.maxIntervalMs,
                                 maxPersistedEventsSize: this.config.maxPersistedEventsSizeBytes,
                                 storeType: storeType,
                                 trackDestinationWorkerScript: trackDestinationWorkerScript,
                                 shouldSend: function () { return !_this.isBelowMinSessionDuration(); },
                             })];
                     case 5:
-                        rrwebEventManager = _v.sent();
+                        rrwebEventManager = _w.sent();
                         this.rrwebEventManager = rrwebEventManager;
                         managers.push({ name: 'replay', manager: rrwebEventManager });
                         return [3 /*break*/, 7];
                     case 6:
-                        error_1 = _v.sent();
+                        error_1 = _w.sent();
                         typedError = error_1;
                         this.loggerProvider.warn("Error occurred while creating replay events manager: ".concat(typedError.toString()));
                         return [3 /*break*/, 7];
                     case 7:
-                        if (!((_j = this.config.interactionConfig) === null || _j === void 0 ? void 0 : _j.enabled)) return [3 /*break*/, 11];
+                        if (!((_k = this.config.interactionConfig) === null || _k === void 0 ? void 0 : _k.enabled)) return [3 /*break*/, 11];
                         payloadBatcher = this.config.interactionConfig.batch ? clickBatcher : clickNonBatcher;
-                        _v.label = 8;
+                        _w.label = 8;
                     case 8:
-                        _v.trys.push([8, 10, , 11]);
+                        _w.trys.push([8, 10, , 11]);
                         return [4 /*yield*/, createEventsManager({
                                 config: this.config,
                                 type: 'interaction',
-                                minInterval: (_k = this.config.interactionConfig.trackEveryNms) !== null && _k !== void 0 ? _k : INTERACTION_MIN_INTERVAL,
+                                minInterval: (_l = this.config.interactionConfig.trackEveryNms) !== null && _l !== void 0 ? _l : INTERACTION_MIN_INTERVAL,
                                 maxInterval: INTERACTION_MAX_INTERVAL,
                                 maxPersistedEventsSize: this.config.maxPersistedEventsSizeBytes,
                                 payloadBatcher: payloadBatcher,
@@ -441,11 +449,11 @@ var SessionReplay = /** @class */ (function () {
                                 trackDestinationWorkerScript: trackDestinationWorkerScript,
                             })];
                     case 9:
-                        interactionEventManager = _v.sent();
+                        interactionEventManager = _w.sent();
                         managers.push({ name: 'interaction', manager: interactionEventManager });
                         return [3 /*break*/, 11];
                     case 10:
-                        error_2 = _v.sent();
+                        error_2 = _w.sent();
                         typedError = error_2;
                         this.loggerProvider.warn("Error occurred while creating interaction events manager: ".concat(typedError.toString()));
                         return [3 /*break*/, 11];
@@ -463,14 +471,14 @@ var SessionReplay = /** @class */ (function () {
                             pending_2 = this.pendingEmitEvents.splice(0);
                             try {
                                 for (pending_1 = __values(pending_2), pending_1_1 = pending_1.next(); !pending_1_1.done; pending_1_1 = pending_1.next()) {
-                                    _t = pending_1_1.value, event_1 = _t.event, sessionId = _t.sessionId;
+                                    _u = pending_1_1.value, event_1 = _u.event, sessionId = _u.sessionId;
                                     this.eventCompressor.enqueueEvent(event_1, sessionId);
                                 }
                             }
                             catch (e_2_1) { e_2 = { error: e_2_1 }; }
                             finally {
                                 try {
-                                    if (pending_1_1 && !pending_1_1.done && (_u = pending_1.return)) _u.call(pending_1);
+                                    if (pending_1_1 && !pending_1_1.done && (_v = pending_1.return)) _v.call(pending_1);
                                 }
                                 finally { if (e_2) throw e_2.error; }
                             }
@@ -507,11 +515,11 @@ var SessionReplay = /** @class */ (function () {
                         ], false);
                         return [4 /*yield*/, this.initializeNetworkObservers()];
                     case 12:
-                        _v.sent();
+                        _w.sent();
                         // Enable background capture when this page is opened by the Amplitude app
                         // (window.opener exists). Uses the shared messenger singleton so that if
                         // autocapture is also loaded, both share a single messenger and script load.
-                        if ((_l = getGlobalScope()) === null || _l === void 0 ? void 0 : _l.opener) {
+                        if ((_m = getGlobalScope()) === null || _m === void 0 ? void 0 : _m.opener) {
                             messenger = getOrCreateWindowMessenger();
                             enableBackgroundCapture(messenger);
                             messenger.setup(__assign({ logger: this.loggerProvider }, (this.config.serverZone && { endpoint: AMPLITUDE_ORIGINS_MAP[this.config.serverZone] })));
@@ -520,8 +528,8 @@ var SessionReplay = /** @class */ (function () {
                         this.teardownEventListeners(false);
                         return [4 /*yield*/, this.evaluateTargetingAndCapture({ userProperties: options.userProperties, page: this.getCurrentPageForTargeting() }, true)];
                     case 13:
-                        _v.sent();
-                        needsUrlTracking = this.config.targetingConfig || ((_p = (_o = (_m = this.config.privacyConfig) === null || _m === void 0 ? void 0 : _m.urlMaskLevels) === null || _o === void 0 ? void 0 : _o.length) !== null && _p !== void 0 ? _p : 0) > 0;
+                        _w.sent();
+                        needsUrlTracking = this.config.targetingConfig || ((_q = (_p = (_o = this.config.privacyConfig) === null || _o === void 0 ? void 0 : _o.urlMaskLevels) === null || _p === void 0 ? void 0 : _p.length) !== null && _q !== void 0 ? _q : 0) > 0;
                         if (needsUrlTracking) {
                             this.setupUrlChangeListener();
                         }
@@ -534,11 +542,11 @@ var SessionReplay = /** @class */ (function () {
         return returnWrapper(this.asyncSetSessionId(sessionId, deviceId));
     };
     SessionReplay.prototype.asyncSetSessionId = function (sessionId, deviceId, options) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e, _f;
         return __awaiter(this, void 0, void 0, function () {
             var previousSessionId, currentDeviceId, isSessionChange, deviceIdForReplayId, joinedConfig;
-            return __generator(this, function (_e) {
-                switch (_e.label) {
+            return __generator(this, function (_g) {
+                switch (_g.label) {
                     case 0:
                         previousSessionId = (_a = this.identifiers) === null || _a === void 0 ? void 0 : _a.sessionId;
                         currentDeviceId = this.getDeviceId();
@@ -561,13 +569,16 @@ var SessionReplay = /** @class */ (function () {
                             this.sendEvents(previousSessionId);
                         }
                         isSessionChange = previousSessionId !== sessionId;
+                        if (isSessionChange && ((_c = (_b = this.config) === null || _b === void 0 ? void 0 : _b.semanticCapture) === null || _c === void 0 ? void 0 : _c.enabled) && this.semanticAdapter) {
+                            this.stopRecordingEvents('new_session');
+                        }
                         // Drop any beacon-buffered events from the previous session BEFORE installing the
                         // new identifiers / start time. Otherwise the page-leave beacon path could attribute
                         // old-session events to the new session id, and the gate (using the new start time)
                         // would compute the wrong elapsed duration. Skip on a redundant same-sessionId call —
                         // the buffer belongs to the *continuing* session and should ship via beacon as normal.
                         if (isSessionChange) {
-                            (_b = this.rrwebEventManager) === null || _b === void 0 ? void 0 : _b.dropPendingBeaconEvents();
+                            (_d = this.rrwebEventManager) === null || _d === void 0 ? void 0 : _d.dropPendingBeaconEvents();
                         }
                         deviceIdForReplayId = deviceId || this.getDeviceId();
                         this.identifiers = new SessionIdentifiers({
@@ -582,7 +593,7 @@ var SessionReplay = /** @class */ (function () {
                             this.sessionStartTime = Date.now();
                             this.suppressedSendCount = 0;
                             this.hasEmittedGateDecision = false;
-                            if ((_c = this.config) === null || _c === void 0 ? void 0 : _c.apiKey) {
+                            if ((_e = this.config) === null || _e === void 0 ? void 0 : _e.apiKey) {
                                 setReplayStartTime(this.config.apiKey, sessionId, this.sessionStartTime, this.loggerProvider);
                                 if (previousSessionId !== undefined) {
                                     removeReplayStartTime(this.config.apiKey, previousSessionId, this.loggerProvider);
@@ -592,19 +603,19 @@ var SessionReplay = /** @class */ (function () {
                         if (!(this.joinedConfigGenerator && previousSessionId)) return [3 /*break*/, 2];
                         return [4 /*yield*/, this.joinedConfigGenerator.generateJoinedConfig()];
                     case 1:
-                        joinedConfig = (_e.sent()).joinedConfig;
+                        joinedConfig = (_g.sent()).joinedConfig;
                         this.config = joinedConfig;
-                        _e.label = 2;
+                        _g.label = 2;
                     case 2:
-                        if (!((_d = this.config) === null || _d === void 0 ? void 0 : _d.targetingConfig)) return [3 /*break*/, 4];
+                        if (!((_f = this.config) === null || _f === void 0 ? void 0 : _f.targetingConfig)) return [3 /*break*/, 4];
                         return [4 /*yield*/, this.evaluateTargetingAndCapture({ userProperties: options === null || options === void 0 ? void 0 : options.userProperties, page: this.getCurrentPageForTargeting() }, false, true)];
                     case 3:
-                        _e.sent();
+                        _g.sent();
                         return [3 /*break*/, 6];
                     case 4: return [4 /*yield*/, this.recordEvents()];
                     case 5:
-                        _e.sent();
-                        _e.label = 6;
+                        _g.sent();
+                        _g.label = 6;
                     case 6: return [2 /*return*/];
                 }
             });
@@ -888,65 +899,71 @@ var SessionReplay = /** @class */ (function () {
         return !this.recordingEnabled || generation !== this.recordingGeneration;
     };
     SessionReplay.prototype._recordEvents = function (shouldLogMetadata) {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
         if (shouldLogMetadata === void 0) { shouldLogMetadata = true; }
         return __awaiter(this, void 0, void 0, function () {
-            var config, shouldRecord, sessionId, generation, recordFunction, networkLoggingConfig, trackUrl, ignoredUrls, interactionConfig, loggingConfig, hooks, ugcFilterRules, crossOriginIframesEnabled, coordinateChildren, childMode, plugins, error_5;
+            var config, shouldRecord, sessionId, generation, recordFunction, networkLoggingConfig, trackUrl, ignoredUrls, interactionConfig, loggingConfig, heatmapHook, sharedSemanticClicks, mouseInteraction, clickHandler, hooks, ugcFilterRules, crossOriginIframesEnabled, coordinateChildren, childMode, plugins, error_5;
             var _this = this;
-            return __generator(this, function (_j) {
-                switch (_j.label) {
+            return __generator(this, function (_p) {
+                switch (_p.label) {
                     case 0:
                         config = this.config;
                         shouldRecord = this.getShouldRecord();
                         sessionId = (_a = this.identifiers) === null || _a === void 0 ? void 0 : _a.sessionId;
                         if (!shouldRecord || !sessionId || !config) {
+                            if (((_b = config === null || config === void 0 ? void 0 : config.semanticCapture) === null || _b === void 0 ? void 0 : _b.enabled) && this.semanticAdapter && this.recordCancelCallback) {
+                                this.stopRecordingEvents(this.shouldOptOut() ? 'opt_out' : config.targetingConfig ? 'targeting' : 'sampled_out');
+                            }
                             return [2 /*return*/];
                         }
-                        this.stopRecordingEvents();
+                        this.stopRecordingEvents('focus', 'pause');
                         generation = this.recordingGeneration;
                         return [4 /*yield*/, this.getRecordFunction()];
                     case 1:
-                        recordFunction = _j.sent();
+                        recordFunction = _p.sent();
                         // May be undefined if cannot import rrweb-record
                         if (!recordFunction || this.shouldAbandonRecordStart(generation)) {
                             return [2 /*return*/];
                         }
                         return [4 /*yield*/, this.initializeNetworkObservers()];
                     case 2:
-                        _j.sent();
+                        _p.sent();
                         if (this.shouldAbandonRecordStart(generation)) {
                             return [2 /*return*/];
                         }
-                        networkLoggingConfig = (_b = config.loggingConfig) === null || _b === void 0 ? void 0 : _b.network;
+                        networkLoggingConfig = (_c = config.loggingConfig) === null || _c === void 0 ? void 0 : _c.network;
                         trackUrl = getServerUrl(config.serverZone, config.trackServerUrl);
                         ignoredUrls = [SESSION_REPLAY_SERVER_URL, SESSION_REPLAY_EU_URL, SESSION_REPLAY_STAGING_URL, trackUrl];
-                        (_c = this.networkObservers) === null || _c === void 0 ? void 0 : _c.start(function (event) {
+                        (_d = this.networkObservers) === null || _d === void 0 ? void 0 : _d.start(function (event) {
                             if (ignoredUrls.some(function (url) { return event.url.startsWith(url); }))
                                 return;
                             void _this.addCustomRRWebEvent(CustomRRwebEvent.FETCH_REQUEST, event);
                         }, networkLoggingConfig);
                         interactionConfig = config.interactionConfig, loggingConfig = config.loggingConfig;
-                        hooks = (interactionConfig === null || interactionConfig === void 0 ? void 0 : interactionConfig.enabled)
-                            ? {
-                                mouseInteraction: this.eventsManager &&
-                                    ((_d = this.clickHandler) === null || _d === void 0 ? void 0 : _d.createHook({
-                                        eventsManager: this.eventsManager,
-                                        sessionId: sessionId,
-                                        deviceIdFn: this.getDeviceId.bind(this),
-                                        mirror: recordFunction.mirror,
-                                        ugcFilterRules: (_e = interactionConfig.ugcFilterRules) !== null && _e !== void 0 ? _e : [],
-                                        performanceOptions: (_f = config.performanceConfig) === null || _f === void 0 ? void 0 : _f.interaction,
-                                    })),
-                                scroll: this.scrollHook,
-                            }
-                            : {};
+                        heatmapHook = (interactionConfig === null || interactionConfig === void 0 ? void 0 : interactionConfig.enabled) && this.eventsManager
+                            ? (_e = this.clickHandler) === null || _e === void 0 ? void 0 : _e.createHook({
+                                eventsManager: this.eventsManager,
+                                sessionId: sessionId,
+                                deviceIdFn: this.getDeviceId.bind(this),
+                                mirror: recordFunction.mirror,
+                                ugcFilterRules: (_f = interactionConfig.ugcFilterRules) !== null && _f !== void 0 ? _f : [],
+                                performanceOptions: (_g = config.performanceConfig) === null || _g === void 0 ? void 0 : _g.interaction,
+                            })
+                            : undefined;
+                        sharedSemanticClicks = ((_h = config.semanticCapture) === null || _h === void 0 ? void 0 : _h.enabled) && recordFunction.supportsNativeMouseInteraction;
+                        mouseInteraction = heatmapHook;
+                        if (sharedSemanticClicks) {
+                            clickHandler = (_j = this.clickHandler) !== null && _j !== void 0 ? _j : (this.clickHandler = new ClickHandler(this.loggerProvider));
+                            mouseInteraction = clickHandler.createSharedHook(heatmapHook, function (event) { var _a; return (_a = _this.semanticAdapter) === null || _a === void 0 ? void 0 : _a.click(event); });
+                        }
+                        hooks = __assign(__assign({}, (mouseInteraction ? { mouseInteraction: mouseInteraction } : {})), ((interactionConfig === null || interactionConfig === void 0 ? void 0 : interactionConfig.enabled) ? { scroll: this.scrollHook } : {}));
                         ugcFilterRules = (interactionConfig === null || interactionConfig === void 0 ? void 0 : interactionConfig.enabled) && interactionConfig.ugcFilterRules ? interactionConfig.ugcFilterRules : [];
                         this.loggerProvider.log("Session Replay capture beginning for ".concat(sessionId, "."));
-                        _j.label = 3;
+                        _p.label = 3;
                     case 3:
-                        _j.trys.push([3, 5, , 6]);
-                        crossOriginIframesEnabled = !!((_g = config.crossOriginIframes) === null || _g === void 0 ? void 0 : _g.enabled);
-                        coordinateChildren = ((_h = config.crossOriginIframes) === null || _h === void 0 ? void 0 : _h.coordinateChildren) !== false;
+                        _p.trys.push([3, 5, , 6]);
+                        crossOriginIframesEnabled = !!((_k = config.crossOriginIframes) === null || _k === void 0 ? void 0 : _k.enabled);
+                        coordinateChildren = ((_l = config.crossOriginIframes) === null || _l === void 0 ? void 0 : _l.coordinateChildren) !== false;
                         childMode = crossOriginIframesEnabled && isInIframe();
                         if (childMode && coordinateChildren) {
                             // Child mode: don't self-start; wait for a start signal from the parent.
@@ -983,16 +1000,24 @@ var SessionReplay = /** @class */ (function () {
                         this.startChildRecordingOnSetup = false;
                         return [4 /*yield*/, this.getRecordingPlugins(loggingConfig)];
                     case 4:
-                        plugins = _j.sent();
+                        plugins = _p.sent();
                         if (this.shouldAbandonRecordStart(generation)) {
                             return [2 /*return*/];
                         }
+                        this.prepareSemanticCapture(config, sessionId);
                         this.recordCancelCallback = recordFunction(__assign(__assign({}, this.buildRRWebRecordOptions(config, hooks, function (event) {
-                            if (_this.shouldOptOut() || !_this.recordingEnabled) {
+                            var _a, _b, _c, _d;
+                            // The terminal state contains no page or user data and must land before rrweb stops.
+                            var semanticStop = ((_b = (_a = _this.config) === null || _a === void 0 ? void 0 : _a.semanticCapture) === null || _b === void 0 ? void 0 : _b.enabled) &&
+                                _this.semanticAdapter &&
+                                event.type === RRWebEventType.Custom &&
+                                event.data.tag === 'amp-semantic/recording' &&
+                                ((_c = event.data.payload) === null || _c === void 0 ? void 0 : _c.state) === 'stop';
+                            if ((_this.shouldOptOut() || !_this.recordingEnabled) && !semanticStop) {
                                 _this.loggerProvider.log(_this.shouldOptOut()
                                     ? "Opting session ".concat(sessionId, " out of recording due to optOut config.")
                                     : "Session Replay capture stopping for ".concat(sessionId, "."));
-                                _this.stopRecordingEvents();
+                                _this.stopRecordingEvents(_this.shouldOptOut() ? 'opt_out' : 'customer_stop');
                                 _this.sendEvents();
                                 return;
                             }
@@ -1008,7 +1033,10 @@ var SessionReplay = /** @class */ (function () {
                                 // Buffer the event so it can be flushed once the compressor is initialized.
                                 _this.pendingEmitEvents.push({ event: event, sessionId: sessionId });
                             }
+                            (_d = _this.semanticAdapter) === null || _d === void 0 ? void 0 : _d.event(event);
                         }, 'Error while capturing replay: ')), { plugins: plugins, recordCrossOriginIframes: crossOriginIframesEnabled }));
+                        if (this.recordCancelCallback)
+                            (_m = this.semanticAdapter) === null || _m === void 0 ? void 0 : _m.recordingReady();
                         if (crossOriginIframesEnabled && !childMode && coordinateChildren) {
                             if (!this.crossOriginIframeCoordinator) {
                                 this.crossOriginIframeCoordinator = new CrossOriginIframeCoordinator();
@@ -1021,7 +1049,8 @@ var SessionReplay = /** @class */ (function () {
                         }
                         return [3 /*break*/, 6];
                     case 5:
-                        error_5 = _j.sent();
+                        error_5 = _p.sent();
+                        (_o = this.semanticAdapter) === null || _o === void 0 ? void 0 : _o.stop('error');
                         this.loggerProvider.warn('Failed to initialize session replay:', error_5);
                         return [3 /*break*/, 6];
                     case 6: return [2 /*return*/];
@@ -1029,6 +1058,52 @@ var SessionReplay = /** @class */ (function () {
             });
         });
     };
+    SessionReplay.prototype.prepareSemanticCapture = function (config, sessionId) {
+        var _this = this;
+        var _a, _b, _c, _d;
+        var scope = getGlobalScope();
+        if (!(scope === null || scope === void 0 ? void 0 : scope.document))
+            return;
+        if (!((_a = config.semanticCapture) === null || _a === void 0 ? void 0 : _a.enabled)) {
+            (_b = this.semanticAdapter) === null || _b === void 0 ? void 0 : _b.stop('targeting');
+            (_c = this.semanticAdapter) === null || _c === void 0 ? void 0 : _c.prepare({ enabled: false }, sessionId);
+            return;
+        }
+        if (!this.semanticAdapter) {
+            this.semanticAdapter = new ReplaySemanticAdapter({
+                document: scope.document,
+                window: scope,
+                sdk: "@amplitude/session-replay-browser@".concat(VERSION),
+                externalClicks: ((_d = this.recordFunction) === null || _d === void 0 ? void 0 : _d.supportsNativeMouseInteraction) === true,
+                // rrweb does not report auxiliary clicks through its mouseInteraction hook.
+                externalAuxClicks: false,
+                getNodeId: function (node) { var _a, _b, _c, _d; return (_d = (_c = (_a = _this.recordFunction) === null || _a === void 0 ? void 0 : (_b = _a.mirror).getId) === null || _c === void 0 ? void 0 : _c.call(_b, node)) !== null && _d !== void 0 ? _d : -1; },
+                getNode: function (id) { var _a, _b; return (_b = (_a = _this.recordFunction) === null || _a === void 0 ? void 0 : _a.mirror.getNode(id)) !== null && _b !== void 0 ? _b : null; },
+                getPrivacy: function () { var _a, _b; return (_b = (_a = _this.config) === null || _a === void 0 ? void 0 : _a.privacyConfig) !== null && _b !== void 0 ? _b : {}; },
+                getUrl: function () { return scope.location.href; },
+                getIdentity: function () { return getSemanticIdentity(scope); },
+                getAnalyticsContext: function () { var _a, _b; return (_b = (_a = _this.config) === null || _a === void 0 ? void 0 : _a.semanticAnalyticsContext) !== null && _b !== void 0 ? _b : { present: false, autocapture: [] }; },
+                inlineStylesheet: config.shouldInlineStylesheet,
+                getSelector: function (element) {
+                    var _a, _b;
+                    try {
+                        var options = __assign(__assign({}, (_b = (_a = _this.config) === null || _a === void 0 ? void 0 : _a.performanceConfig) === null || _b === void 0 ? void 0 : _b.interaction), { timeoutMs: 1 });
+                        return _this.clickHandler ? _this.clickHandler.getSelector(element, options) : finder(element, options);
+                    }
+                    catch (_c) {
+                        return null;
+                    }
+                },
+                emit: function (event) {
+                    if (_this.recordCancelCallback && _this.recordFunction) {
+                        _this.recordFunction.addCustomEvent("amp-semantic/".concat(event.name), event.payload);
+                    }
+                },
+                onError: function (error) { return _this.loggerProvider.debug('Semantic capture error:', error); },
+            });
+        }
+        this.semanticAdapter.prepare(config.semanticCapture, sessionId);
+    };
     SessionReplay.prototype.buildRRWebRecordOptions = function (config, hooks, emit, errorLogPrefix) {
         var _this = this;
         var privacyConfig = config.privacyConfig;
@@ -1113,7 +1188,7 @@ var SessionReplay = /** @class */ (function () {
         this.recordingEnabled = false;
         this.startChildRecordingOnSetup = false;
         this.recordingGeneration++;
-        this.stopRecordingEvents();
+        this.stopRecordingEvents('customer_stop');
         this.sendEvents();
     };
     SessionReplay.prototype.flush = function (useRetry) {
@@ -1139,7 +1214,7 @@ var SessionReplay = /** @class */ (function () {
         (_b = this.crossOriginParentSignalCleanup) === null || _b === void 0 ? void 0 : _b.call(this);
         this.crossOriginParentSignalCleanup = null;
         this.teardownEventListeners(true);
-        this.stopRecordingEvents();
+        this.stopRecordingEvents(this.semanticAdapter && this.shouldOptOut() ? 'opt_out' : 'customer_stop');
         this.sendEvents();
     };
     SessionReplay.prototype.mapSDKType = function (sdkType) {