@amplitude/session-replay-browser 1.47.0-sr-trc-debug-log.1 → 1.47.0-sr-trc-debug-log.2

package/lib/cjs/targeting/targeting-manager.js

@@ -8,39 +8,47 @@ var evaluateTargetingAndStore = function (_a) {
     var sessionId = _a.sessionId, targetingConfig = _a.targetingConfig, loggerProvider = _a.loggerProvider, apiKey = _a.apiKey, targetingParams = _a.targetingParams, _b = _a.urlChange, urlChange = _b === void 0 ? false : _b, diagnosticsClient = _a.diagnosticsClient, deviceId = _a.deviceId;
     return tslib_1.__awaiter(void 0, void 0, void 0, function () {
         var idbTargetingMatch, sessionTargetingMatch, evaluateTargetingPackage, params, targetingResult, err_1, knownError;
-        var _c, _d, _e, _f, _g, _h;
-        return tslib_1.__generator(this, function (_j) {
-            switch (_j.label) {
+        var _c, _d, _e, _f, _g, _h, _j;
+        return tslib_1.__generator(this, function (_k) {
+            switch (_k.label) {
                 case 0: return [4 /*yield*/, targeting_idb_store_1.targetingIDBStore.clearStoreOfOldSessions({
                         loggerProvider: loggerProvider,
                         apiKey: apiKey,
                         currentSessionId: sessionId,
                     })];
                 case 1:
-                    _j.sent();
+                    _k.sent();
                     return [4 /*yield*/, targeting_idb_store_1.targetingIDBStore.getTargetingMatchForSession({
                             loggerProvider: loggerProvider,
                             apiKey: apiKey,
                             sessionId: sessionId,
                         })];
                 case 2:
-                    idbTargetingMatch = _j.sent();
+                    idbTargetingMatch = _k.sent();
                     // Skip IDB cache when re-evaluating with a new page (e.g. URL change); otherwise we'd never
                     // re-evaluate and would keep returning true after navigating to a non-matching page.
                     if (idbTargetingMatch === true && !urlChange) {
                         return [2 /*return*/, true];
                     }
                     sessionTargetingMatch = true;
-                    _j.label = 3;
+                    _k.label = 3;
                 case 3:
-                    _j.trys.push([3, 6, , 7]);
+                    _k.trys.push([3, 6, , 7]);
                     return [4 /*yield*/, Promise.resolve().then(function () { return tslib_1.__importStar(require('@amplitude/targeting')); })];
                 case 4:
-                    evaluateTargetingPackage = (_j.sent()).evaluateTargeting;
+                    evaluateTargetingPackage = (_k.sent()).evaluateTargeting;
                     params = tslib_1.__assign(tslib_1.__assign({}, targetingParams), { flag: targetingConfig, sessionId: typeof sessionId === 'string' ? parseInt(sessionId, 10) : sessionId, apiKey: apiKey, loggerProvider: loggerProvider });
+                    diagnosticsClient === null || diagnosticsClient === void 0 ? void 0 : diagnosticsClient.recordEvent(diagnostics_1.SrDiagnostic.targetingTrigger, {
+                        sessionId: sessionId,
+                        deviceId: deviceId,
+                        srId: deviceId != null && sessionId != null ? "".concat(deviceId, "/").concat(sessionId) : undefined,
+                        pageUrl: (_c = targetingParams === null || targetingParams === void 0 ? void 0 : targetingParams.page) === null || _c === void 0 ? void 0 : _c.url,
+                        matched: sessionTargetingMatch,
+                        targetingConfig: targetingConfig,
+                    });
                     return [4 /*yield*/, evaluateTargetingPackage(params)];
                 case 5:
-                    targetingResult = _j.sent();
+                    targetingResult = _k.sent();
                     if (targetingResult && targetingResult.sr_targeting_config) {
                         sessionTargetingMatch = targetingResult.sr_targeting_config.key === 'on';
                     }
@@ -52,15 +60,16 @@ var evaluateTargetingAndStore = function (_a) {
                             sessionId: sessionId,
                             deviceId: deviceId,
                             srId: deviceId != null && sessionId != null ? "".concat(deviceId, "/").concat(sessionId) : undefined,
-                            pageUrl: (_c = targetingParams === null || targetingParams === void 0 ? void 0 : targetingParams.page) === null || _c === void 0 ? void 0 : _c.url,
-                            variantKey: (_e = (_d = targetingResult === null || targetingResult === void 0 ? void 0 : targetingResult.sr_targeting_config) === null || _d === void 0 ? void 0 : _d.key) !== null && _e !== void 0 ? _e : null,
+                            pageUrl: (_d = targetingParams === null || targetingParams === void 0 ? void 0 : targetingParams.page) === null || _d === void 0 ? void 0 : _d.url,
+                            variantKey: (_f = (_e = targetingResult === null || targetingResult === void 0 ? void 0 : targetingResult.sr_targeting_config) === null || _e === void 0 ? void 0 : _e.key) !== null && _f !== void 0 ? _f : null,
                             matched: sessionTargetingMatch,
+                            targetingConfig: targetingConfig,
                         });
                         // Flush now so the verdict ships immediately (vs the client's ~5-min timer). One capture
                         // POST per event — higher volume; revisit/gate before production.
-                        void ((_f = diagnosticsClient === null || diagnosticsClient === void 0 ? void 0 : diagnosticsClient._flush) === null || _f === void 0 ? void 0 : _f.call(diagnosticsClient));
+                        void ((_g = diagnosticsClient === null || diagnosticsClient === void 0 ? void 0 : diagnosticsClient._flush) === null || _g === void 0 ? void 0 : _g.call(diagnosticsClient));
                     }
-                    catch (_k) {
+                    catch (_l) {
                         // diagnostics is best-effort
                     }
                     void targeting_idb_store_1.targetingIDBStore.storeTargetingMatchForSession({
@@ -71,7 +80,7 @@ var evaluateTargetingAndStore = function (_a) {
                     });
                     return [3 /*break*/, 7];
                 case 6:
-                    err_1 = _j.sent();
+                    err_1 = _k.sent();
                     knownError = err_1;
                     // Q3 "is the TRC failing?": the targeting engine threw — record it so the team sees TRC
                     // errors in DataDog (this exception is otherwise swallowed). Best-effort, never re-throws.
@@ -81,12 +90,12 @@ var evaluateTargetingAndStore = function (_a) {
                             sessionId: sessionId,
                             deviceId: deviceId,
                             srId: deviceId != null && sessionId != null ? "".concat(deviceId, "/").concat(sessionId) : undefined,
-                            pageUrl: (_g = targetingParams === null || targetingParams === void 0 ? void 0 : targetingParams.page) === null || _g === void 0 ? void 0 : _g.url,
+                            pageUrl: (_h = targetingParams === null || targetingParams === void 0 ? void 0 : targetingParams.page) === null || _h === void 0 ? void 0 : _h.url,
                             message: knownError.message,
                         });
-                        void ((_h = diagnosticsClient === null || diagnosticsClient === void 0 ? void 0 : diagnosticsClient._flush) === null || _h === void 0 ? void 0 : _h.call(diagnosticsClient));
+                        void ((_j = diagnosticsClient === null || diagnosticsClient === void 0 ? void 0 : diagnosticsClient._flush) === null || _j === void 0 ? void 0 : _j.call(diagnosticsClient));
                     }
-                    catch (_l) {
+                    catch (_m) {
                         // diagnostics is best-effort
                     }
                     loggerProvider.warn(knownError.message);

package/lib/cjs/targeting/targeting-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"targeting-manager.js","sourceRoot":"","sources":["../../../src/targeting/targeting-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TargetingParameters } from '@amplitude/targeting';\nimport { TargetingConfig } from '../config/types';\nimport { Logger } from '@amplitude/analytics-types';\nimport { IDiagnosticsClient } from '@amplitude/analytics-core';\nimport { SessionReplayTargetingInput } from '../typings/session-replay';\nimport { targetingIDBStore } from './targeting-idb-store';\nimport { SrDiagnostic } from '../diagnostics';\n\nexport const evaluateTargetingAndStore = async ({\n  sessionId,\n  targetingConfig,\n  loggerProvider,\n  apiKey,\n  targetingParams,\n  urlChange = false,\n  diagnosticsClient,\n  deviceId,\n}: {\n  sessionId: string | number;\n  targetingConfig: TargetingConfig;\n  loggerProvider: Logger;\n  apiKey: string;\n  targetingParams?: SessionReplayTargetingInput;\n  urlChange?: boolean;\n  diagnosticsClient?: IDiagnosticsClient;\n  deviceId?: string;\n}) => {\n  await targetingIDBStore.clearStoreOfOldSessions({\n    loggerProvider: loggerProvider,\n    apiKey: apiKey,\n    currentSessionId: sessionId,\n  });\n\n  const idbTargetingMatch = await targetingIDBStore.getTargetingMatchForSession({\n    loggerProvider: loggerProvider,\n    apiKey: apiKey,\n    sessionId: sessionId,\n  });\n\n  // Skip IDB cache when re-evaluating with a new page (e.g. URL change); otherwise we'd never\n  // re-evaluate and would keep returning true after navigating to a non-matching page.\n  if (idbTargetingMatch === true && !urlChange) {\n    return true;\n  }\n\n  // If the targeting config is undefined or an empty object,\n  // assume the response was valid but no conditions were set,\n  // so all users match targeting\n  let sessionTargetingMatch = true;\n  try {\n    // Dynamic import of the targeting package\n    const { evaluateTargeting: evaluateTargetingPackage } = await import('@amplitude/targeting');\n\n    const params: TargetingParameters = {\n      ...targetingParams,\n      flag: targetingConfig,\n      sessionId: typeof sessionId === 'string' ? parseInt(sessionId, 10) : sessionId,\n      apiKey: apiKey,\n      loggerProvider: loggerProvider,\n    };\n    const targetingResult = await evaluateTargetingPackage(params);\n    if (targetingResult && targetingResult.sr_targeting_config) {\n      sessionTargetingMatch = targetingResult.sr_targeting_config.key === 'on';\n    }\n    // gap #2: the raw engine verdict. variantKey 'on' => matched; 'off'/undefined => not.\n    // Pair with the eval event's pageUrl to tell \"URL condition didn't match\" from \"URL matched\n    // but the segment bucket (capture %) didn't allocate this session\".\n    try {\n      diagnosticsClient?.recordEvent(SrDiagnostic.evalResult, {\n        sessionId,\n        deviceId,\n        srId: deviceId != null && sessionId != null ? `${deviceId}/${sessionId}` : undefined,\n        pageUrl: targetingParams?.page?.url,\n        variantKey: targetingResult?.sr_targeting_config?.key ?? null,\n        matched: sessionTargetingMatch,\n      });\n      // Flush now so the verdict ships immediately (vs the client's ~5-min timer). One capture\n      // POST per event — higher volume; revisit/gate before production.\n      void diagnosticsClient?._flush?.();\n    } catch {\n      // diagnostics is best-effort\n    }\n\n    void targetingIDBStore.storeTargetingMatchForSession({\n      loggerProvider: loggerProvider,\n      apiKey: apiKey,\n      sessionId: sessionId,\n      targetingMatch: sessionTargetingMatch,\n    });\n  } catch (err: unknown) {\n    const knownError = err as Error;\n    // Q3 \"is the TRC failing?\": the targeting engine threw — record it so the team sees TRC\n    // errors in DataDog (this exception is otherwise swallowed). Best-effort, never re-throws.\n    try {\n      diagnosticsClient?.increment(SrDiagnostic.evalError);\n      diagnosticsClient?.recordEvent(SrDiagnostic.evalError, {\n        sessionId,\n        deviceId,\n        srId: deviceId != null && sessionId != null ? `${deviceId}/${sessionId}` : undefined,\n        pageUrl: targetingParams?.page?.url,\n        message: knownError.message,\n      });\n      void diagnosticsClient?._flush?.();\n    } catch {\n      // diagnostics is best-effort\n    }\n    loggerProvider.warn(knownError.message);\n  }\n  return sessionTargetingMatch;\n};\n"]}
+{"version":3,"file":"targeting-manager.js","sourceRoot":"","sources":["../../../src/targeting/targeting-manager.ts"],"names":[],"mappings":";;;;AAKA,6DAA0D;AAC1D,8CAA8C;AAEvC,IAAM,yBAAyB,GAAG,UAAO,EAkB/C;QAjBC,SAAS,eAAA,EACT,eAAe,qBAAA,EACf,cAAc,oBAAA,EACd,MAAM,YAAA,EACN,eAAe,qBAAA,EACf,iBAAiB,EAAjB,SAAS,mBAAG,KAAK,KAAA,EACjB,iBAAiB,uBAAA,EACjB,QAAQ,cAAA;;;;;;wBAWR,qBAAM,uCAAiB,CAAC,uBAAuB,CAAC;wBAC9C,cAAc,EAAE,cAAc;wBAC9B,MAAM,EAAE,MAAM;wBACd,gBAAgB,EAAE,SAAS;qBAC5B,CAAC,EAAA;;oBAJF,SAIE,CAAC;oBAEuB,qBAAM,uCAAiB,CAAC,2BAA2B,CAAC;4BAC5E,cAAc,EAAE,cAAc;4BAC9B,MAAM,EAAE,MAAM;4BACd,SAAS,EAAE,SAAS;yBACrB,CAAC,EAAA;;oBAJI,iBAAiB,GAAG,SAIxB;oBAEF,4FAA4F;oBAC5F,qFAAqF;oBACrF,IAAI,iBAAiB,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE;wBAC5C,sBAAO,IAAI,EAAC;qBACb;oBAKG,qBAAqB,GAAG,IAAI,CAAC;;;;oBAGyB,8FAAa,sBAAsB,QAAC;;oBAAjE,wBAAwB,GAAK,CAAA,SAAoC,CAAA,kBAAzC;oBAE7C,MAAM,yCACP,eAAe,KAClB,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAC9E,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,GAC/B,CAAC;oBACF,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,WAAW,CAAC,0BAAY,CAAC,gBAAgB,EAAE;wBAC5D,SAAS,WAAA;wBACT,QAAQ,UAAA;wBACR,IAAI,EAAE,QAAQ,IAAI,IAAI,IAAI,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,UAAG,QAAQ,cAAI,SAAS,CAAE,CAAC,CAAC,CAAC,SAAS;wBACpF,OAAO,EAAE,MAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,IAAI,0CAAE,GAAG;wBACnC,OAAO,EAAE,qBAAqB;wBAC9B,eAAe,EAAE,eAAe;qBACjC,CAAC,CAAC;oBACqB,qBAAM,wBAAwB,CAAC,MAAM,CAAC,EAAA;;oBAAxD,eAAe,GAAG,SAAsC;oBAC9D,IAAI,eAAe,IAAI,eAAe,CAAC,mBAAmB,EAAE;wBAC1D,qBAAqB,GAAG,eAAe,CAAC,mBAAmB,CAAC,GAAG,KAAK,IAAI,CAAC;qBAC1E;oBACD,sFAAsF;oBACtF,4FAA4F;oBAC5F,oEAAoE;oBACpE,IAAI;wBACF,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,WAAW,CAAC,0BAAY,CAAC,UAAU,EAAE;4BACtD,SAAS,WAAA;4BACT,QAAQ,UAAA;4BACR,IAAI,EAAE,QAAQ,IAAI,IAAI,IAAI,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,UAAG,QAAQ,cAAI,SAAS,CAAE,CAAC,CAAC,CAAC,SAAS;4BACpF,OAAO,EAAE,MAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,IAAI,0CAAE,GAAG;4BACnC,UAAU,EAAE,MAAA,MAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,mBAAmB,0CAAE,GAAG,mCAAI,IAAI;4BAC7D,OAAO,EAAE,qBAAqB;4BAC9B,eAAe,EAAE,eAAe;yBACjC,CAAC,CAAC;wBACH,yFAAyF;wBACzF,kEAAkE;wBAClE,KAAK,CAAA,MAAA,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,MAAM,iEAAI,CAAA,CAAC;qBACpC;oBAAC,WAAM;wBACN,6BAA6B;qBAC9B;oBAED,KAAK,uCAAiB,CAAC,6BAA6B,CAAC;wBACnD,cAAc,EAAE,cAAc;wBAC9B,MAAM,EAAE,MAAM;wBACd,SAAS,EAAE,SAAS;wBACpB,cAAc,EAAE,qBAAqB;qBACtC,CAAC,CAAC;;;;oBAEG,UAAU,GAAG,KAAY,CAAC;oBAChC,wFAAwF;oBACxF,2FAA2F;oBAC3F,IAAI;wBACF,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,SAAS,CAAC,0BAAY,CAAC,SAAS,CAAC,CAAC;wBACrD,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,WAAW,CAAC,0BAAY,CAAC,SAAS,EAAE;4BACrD,SAAS,WAAA;4BACT,QAAQ,UAAA;4BACR,IAAI,EAAE,QAAQ,IAAI,IAAI,IAAI,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,UAAG,QAAQ,cAAI,SAAS,CAAE,CAAC,CAAC,CAAC,SAAS;4BACpF,OAAO,EAAE,MAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,IAAI,0CAAE,GAAG;4BACnC,OAAO,EAAE,UAAU,CAAC,OAAO;yBAC5B,CAAC,CAAC;wBACH,KAAK,CAAA,MAAA,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,MAAM,iEAAI,CAAA,CAAC;qBACpC;oBAAC,WAAM;wBACN,6BAA6B;qBAC9B;oBACD,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;;wBAE1C,sBAAO,qBAAqB,EAAC;;;;CAC9B,CAAC;AA9GW,QAAA,yBAAyB,6BA8GpC","sourcesContent":["import type { TargetingParameters } from '@amplitude/targeting';\nimport { TargetingConfig } from '../config/types';\nimport { Logger } from '@amplitude/analytics-types';\nimport { IDiagnosticsClient } from '@amplitude/analytics-core';\nimport { SessionReplayTargetingInput } from '../typings/session-replay';\nimport { targetingIDBStore } from './targeting-idb-store';\nimport { SrDiagnostic } from '../diagnostics';\n\nexport const evaluateTargetingAndStore = async ({\n  sessionId,\n  targetingConfig,\n  loggerProvider,\n  apiKey,\n  targetingParams,\n  urlChange = false,\n  diagnosticsClient,\n  deviceId,\n}: {\n  sessionId: string | number;\n  targetingConfig: TargetingConfig;\n  loggerProvider: Logger;\n  apiKey: string;\n  targetingParams?: SessionReplayTargetingInput;\n  urlChange?: boolean;\n  diagnosticsClient?: IDiagnosticsClient;\n  deviceId?: string;\n}) => {\n  await targetingIDBStore.clearStoreOfOldSessions({\n    loggerProvider: loggerProvider,\n    apiKey: apiKey,\n    currentSessionId: sessionId,\n  });\n\n  const idbTargetingMatch = await targetingIDBStore.getTargetingMatchForSession({\n    loggerProvider: loggerProvider,\n    apiKey: apiKey,\n    sessionId: sessionId,\n  });\n\n  // Skip IDB cache when re-evaluating with a new page (e.g. URL change); otherwise we'd never\n  // re-evaluate and would keep returning true after navigating to a non-matching page.\n  if (idbTargetingMatch === true && !urlChange) {\n    return true;\n  }\n\n  // If the targeting config is undefined or an empty object,\n  // assume the response was valid but no conditions were set,\n  // so all users match targeting\n  let sessionTargetingMatch = true;\n  try {\n    // Dynamic import of the targeting package\n    const { evaluateTargeting: evaluateTargetingPackage } = await import('@amplitude/targeting');\n\n    const params: TargetingParameters = {\n      ...targetingParams,\n      flag: targetingConfig,\n      sessionId: typeof sessionId === 'string' ? parseInt(sessionId, 10) : sessionId,\n      apiKey: apiKey,\n      loggerProvider: loggerProvider,\n    };\n    diagnosticsClient?.recordEvent(SrDiagnostic.targetingTrigger, {\n      sessionId,\n      deviceId,\n      srId: deviceId != null && sessionId != null ? `${deviceId}/${sessionId}` : undefined,\n      pageUrl: targetingParams?.page?.url,\n      matched: sessionTargetingMatch,\n      targetingConfig: targetingConfig,\n    });\n    const targetingResult = await evaluateTargetingPackage(params);\n    if (targetingResult && targetingResult.sr_targeting_config) {\n      sessionTargetingMatch = targetingResult.sr_targeting_config.key === 'on';\n    }\n    // gap #2: the raw engine verdict. variantKey 'on' => matched; 'off'/undefined => not.\n    // Pair with the eval event's pageUrl to tell \"URL condition didn't match\" from \"URL matched\n    // but the segment bucket (capture %) didn't allocate this session\".\n    try {\n      diagnosticsClient?.recordEvent(SrDiagnostic.evalResult, {\n        sessionId,\n        deviceId,\n        srId: deviceId != null && sessionId != null ? `${deviceId}/${sessionId}` : undefined,\n        pageUrl: targetingParams?.page?.url,\n        variantKey: targetingResult?.sr_targeting_config?.key ?? null,\n        matched: sessionTargetingMatch,\n        targetingConfig: targetingConfig,\n      });\n      // Flush now so the verdict ships immediately (vs the client's ~5-min timer). One capture\n      // POST per event — higher volume; revisit/gate before production.\n      void diagnosticsClient?._flush?.();\n    } catch {\n      // diagnostics is best-effort\n    }\n\n    void targetingIDBStore.storeTargetingMatchForSession({\n      loggerProvider: loggerProvider,\n      apiKey: apiKey,\n      sessionId: sessionId,\n      targetingMatch: sessionTargetingMatch,\n    });\n  } catch (err: unknown) {\n    const knownError = err as Error;\n    // Q3 \"is the TRC failing?\": the targeting engine threw — record it so the team sees TRC\n    // errors in DataDog (this exception is otherwise swallowed). Best-effort, never re-throws.\n    try {\n      diagnosticsClient?.increment(SrDiagnostic.evalError);\n      diagnosticsClient?.recordEvent(SrDiagnostic.evalError, {\n        sessionId,\n        deviceId,\n        srId: deviceId != null && sessionId != null ? `${deviceId}/${sessionId}` : undefined,\n        pageUrl: targetingParams?.page?.url,\n        message: knownError.message,\n      });\n      void diagnosticsClient?._flush?.();\n    } catch {\n      // diagnostics is best-effort\n    }\n    loggerProvider.warn(knownError.message);\n  }\n  return sessionTargetingMatch;\n};\n"]}

package/lib/cjs/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.47.0-sr-trc-debug-log.1";
+export declare const VERSION = "1.47.0-sr-trc-debug-log.2";
 //# sourceMappingURL=version.d.ts.map

package/lib/cjs/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 // Autogenerated by `pnpm version-file`. DO NOT EDIT
-exports.VERSION = '1.47.0-sr-trc-debug-log.1';
+exports.VERSION = '1.47.0-sr-trc-debug-log.2';
 //# sourceMappingURL=version.js.map

package/lib/cjs/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":";;;AAAA,oDAAoD;AACvC,QAAA,OAAO,GAAG,2BAA2B,CAAC","sourcesContent":["// Autogenerated by `pnpm version-file`. DO NOT EDIT\nexport const VERSION = '1.47.0-sr-trc-debug-log.1';\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":";;;AAAA,oDAAoD;AACvC,QAAA,OAAO,GAAG,2BAA2B,CAAC","sourcesContent":["// Autogenerated by `pnpm version-file`. DO NOT EDIT\nexport const VERSION = '1.47.0-sr-trc-debug-log.2';\n"]}

package/lib/esm/diagnostics.d.ts

@@ -10,11 +10,13 @@
 export declare const SR_DIAGNOSTIC_PREFIX = "sr.trc";
 export declare const SrDiagnostic: {
     readonly init: "sr.trc.init";
+    readonly sessionChanged: "sr.trc.session.changed";
     readonly configSource: (source: string) => string;
     readonly configHasTargeting: "sr.trc.config.has_targeting";
     readonly configNoTargeting: "sr.trc.config.no_targeting";
     readonly configFetchFailed: "sr.trc.config.fetch_failed";
     readonly configReceived: "sr.trc.config.received";
+    readonly targetingTrigger: "sr.trc.targeting.trigger";
     readonly evalTrigger: (trigger: string) => string;
     readonly evalNoConfig: "sr.trc.eval.no_config";
     readonly evalMissingPrereq: "sr.trc.eval.missing_prereq";
@@ -39,5 +41,8 @@ export declare const SrDiagnostic: {
     readonly decision: "sr.trc.decision";
     readonly urlChange: "sr.trc.url_change";
     readonly urlChangeEvent: "sr.trc.url_change";
+    readonly urlListenerSetup: "sr.trc.url_listener.setup";
+    readonly urlListenerAttached: "sr.trc.url_listener.attached";
+    readonly urlListenerSkipped: "sr.trc.url_listener.skipped";
 };
 //# sourceMappingURL=diagnostics.d.ts.map

package/lib/esm/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAI7C,eAAO,MAAM,YAAY;;oCAKA,MAAM;;;;;oCAQN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;CA8BrB,CAAC"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAI7C,eAAO,MAAM,YAAY;;;oCAUA,MAAM;;;;;;oCAUN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCrB,CAAC"}

package/lib/esm/diagnostics.js

@@ -12,12 +12,17 @@ var p = SR_DIAGNOSTIC_PREFIX;
 export var SrDiagnostic = {
     // ── Init (Q1: did init even happen?) ─────────────────────────────────────
     init: "".concat(p, ".init"),
+    // ── Session lifecycle ────────────────────────────────────────────────────
+    // SR session id changed (timeout / explicit setSessionId / custom session id). New tabs and
+    // page refreshes do NOT change the session id, so this is distinct from a fresh init.
+    sessionChanged: "".concat(p, ".session.changed"),
     // ── Remote config fetch (joined-config) ──────────────────────────────────
     configSource: function (source) { return "".concat(p, ".config.source.").concat(source); },
     configHasTargeting: "".concat(p, ".config.has_targeting"),
     configNoTargeting: "".concat(p, ".config.no_targeting"),
     configFetchFailed: "".concat(p, ".config.fetch_failed"),
     configReceived: "".concat(p, ".config.received"),
+    targetingTrigger: "".concat(p, ".targeting.trigger"),
     // ── Targeting evaluation (evaluateTargetingAndCapture) ────────────────────
     // Q2 (did eval run?), Q3 (working/failed?), Q4 (missing value?), Q5 (all params).
     evalTrigger: function (trigger) { return "".concat(p, ".eval.").concat(trigger); },
@@ -46,6 +51,11 @@ export var SrDiagnostic = {
     decision: "".concat(p, ".decision"),
     // ── SPA URL change (setupUrlChangeListener) ──────────────────────────────
     urlChange: "".concat(p, ".url_change"),
-    urlChangeEvent: "".concat(p, ".url_change"), // event (with props); same name, logs vs metric
+    urlChangeEvent: "".concat(p, ".url_change"),
+    // Was the URL-change listener even wired up? (covers "the SDK never saw any navigation"
+    // because the listener was never attached — e.g. no targeting config, or no global scope.)
+    urlListenerSetup: "".concat(p, ".url_listener.setup"),
+    urlListenerAttached: "".concat(p, ".url_listener.attached"),
+    urlListenerSkipped: "".concat(p, ".url_listener.skipped"), // counter + event: listener NOT attached (with reason)
 };
 //# sourceMappingURL=diagnostics.js.map

package/lib/esm/diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,IAAM,oBAAoB,GAAG,QAAQ,CAAC;AAE7C,IAAM,CAAC,GAAG,oBAAoB,CAAC;AAE/B,MAAM,CAAC,IAAM,YAAY,GAAG;IAC1B,4EAA4E;IAC5E,IAAI,EAAE,UAAG,CAAC,UAAO;IAEjB,4EAA4E;IAC5E,YAAY,EAAE,UAAC,MAAc,IAAK,OAAA,UAAG,CAAC,4BAAkB,MAAM,CAAE,EAA9B,CAA8B;IAChE,kBAAkB,EAAE,UAAG,CAAC,0BAAuB;IAC/C,iBAAiB,EAAE,UAAG,CAAC,yBAAsB;IAC7C,iBAAiB,EAAE,UAAG,CAAC,yBAAsB;IAC7C,cAAc,EAAE,UAAG,CAAC,qBAAkB;IAEtC,6EAA6E;IAC7E,kFAAkF;IAClF,WAAW,EAAE,UAAC,OAAe,IAAK,OAAA,UAAG,CAAC,mBAAS,OAAO,CAAE,EAAtB,CAAsB;IACxD,YAAY,EAAE,UAAG,CAAC,oBAAiB;IACnC,iBAAiB,EAAE,UAAG,CAAC,yBAAsB;IAC7C,SAAS,EAAE,UAAG,CAAC,gBAAa;IAC5B,WAAW,EAAE,UAAG,CAAC,mBAAgB;IACjC,SAAS,EAAE,UAAG,CAAC,gBAAa;IAC5B,kBAAkB,EAAE,UAAG,CAAC,0BAAuB;IAC/C,yBAAyB,EAAE,UAAG,CAAC,kCAA+B;IAC9D,cAAc,EAAE,UAAG,CAAC,sBAAmB;IACvC,SAAS,EAAE,UAAG,CAAC,UAAO;IACtB,UAAU,EAAE,UAAG,CAAC,iBAAc;IAE9B,mFAAmF;IACnF,aAAa,EAAE,UAAG,CAAC,oBAAiB;IACpC,gBAAgB,EAAE,UAAG,CAAC,yBAAsB;IAC5C,yBAAyB,EAAE,UAAG,CAAC,kCAA+B;IAE9D,4EAA4E;IAC5E,iBAAiB,EAAE,UAAG,CAAC,yBAAsB;IAC7C,mBAAmB,EAAE,UAAG,CAAC,2BAAwB;IACjD,UAAU,EAAE,UAAG,CAAC,iBAAc;IAC9B,YAAY,EAAE,UAAG,CAAC,oBAAiB;IACnC,cAAc,EAAE,UAAG,CAAC,uBAAoB;IACxC,YAAY,EAAE,UAAG,CAAC,oBAAiB;IACnC,aAAa,EAAE,UAAG,CAAC,qBAAkB;IACrC,QAAQ,EAAE,UAAG,CAAC,cAAW;IAEzB,4EAA4E;IAC5E,SAAS,EAAE,UAAG,CAAC,gBAAa;IAC5B,cAAc,EAAE,UAAG,CAAC,gBAAa,EAAE,gDAAgD;CAC3E,CAAC","sourcesContent":["/**\n * Centralized names for Session Replay diagnostics shipped via the analytics DiagnosticsClient.\n *\n * Every name shares SR_DIAGNOSTIC_PREFIX so they group together in DataDog as\n * `sdk.diagnostics.sr.trc.*`. The diagnostics pipeline prepends `sdk.diagnostics.` and appends\n * `.count` to counters / `.{min,max,avg,count}` to histograms; events are forwarded to DataDog\n * Logs keyed by `event_name`. Keep ALL SR diagnostic names here so the prefix stays unified —\n * changing the namespace is then a one-line edit.\n */\nexport const SR_DIAGNOSTIC_PREFIX = 'sr.trc';\n\nconst p = SR_DIAGNOSTIC_PREFIX;\n\nexport const SrDiagnostic = {\n  // ── Init (Q1: did init even happen?) ─────────────────────────────────────\n  init: `${p}.init`, // counter + event(with props): fires once per init()\n\n  // ── Remote config fetch (joined-config) ──────────────────────────────────\n  configSource: (source: string) => `${p}.config.source.${source}`,\n  configHasTargeting: `${p}.config.has_targeting`,\n  configNoTargeting: `${p}.config.no_targeting`,\n  configFetchFailed: `${p}.config.fetch_failed`,\n  configReceived: `${p}.config.received`, // event (with props)\n\n  // ── Targeting evaluation (evaluateTargetingAndCapture) ────────────────────\n  // Q2 (did eval run?), Q3 (working/failed?), Q4 (missing value?), Q5 (all params).\n  evalTrigger: (trigger: string) => `${p}.eval.${trigger}`, // init | urlchange | event\n  evalNoConfig: `${p}.eval.no_config`,\n  evalMissingPrereq: `${p}.eval.missing_prereq`, // Q4: sessionId/config/deviceId missing\n  evalMatch: `${p}.eval.match`,\n  evalNoMatch: `${p}.eval.no_match`,\n  evalError: `${p}.eval.error`, // Q3: targeting engine threw\n  evalStaleDiscarded: `${p}.eval.stale_discarded`,\n  evalSkippedAlreadyMatched: `${p}.eval.skipped_already_matched`,\n  evalDurationMs: `${p}.eval.duration_ms`, // histogram\n  evalEvent: `${p}.eval`, // event (with ALL eval params — Q5)\n  evalResult: `${p}.eval.result`, // event: raw engine verdict (variantKey) — why match/no-match\n\n  // ── Recording execution (getShouldRecord said yes — did rrweb actually start?) ──\n  recordStarted: `${p}.record.started`, // event: capture began (carries the srId the replay uploads under)\n  recordNoRecordFn: `${p}.record.no_record_fn`, // counter + event: rrweb import returned nothing\n  sendSuppressedMinDuration: `${p}.send.suppressed_min_duration`, // counter: events held back by min_session_duration\n\n  // ── Record / no-record gate (getShouldRecord) ────────────────────────────\n  gateNoIdentifiers: `${p}.gate.no_identifiers`, // Q4: no config/sessionId at gate time\n  gateCaptureDisabled: `${p}.gate.capture_disabled`,\n  gateOptOut: `${p}.gate.optout`,\n  gateTrcMatch: `${p}.gate.trc_match`,\n  gateTrcNoMatch: `${p}.gate.trc_no_match`,\n  gateSampleIn: `${p}.gate.sample_in`,\n  gateSampleOut: `${p}.gate.sample_out`,\n  decision: `${p}.decision`, // event (with props)\n\n  // ── SPA URL change (setupUrlChangeListener) ──────────────────────────────\n  urlChange: `${p}.url_change`,\n  urlChangeEvent: `${p}.url_change`, // event (with props); same name, logs vs metric\n} as const;\n"]}
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,IAAM,oBAAoB,GAAG,QAAQ,CAAC;AAE7C,IAAM,CAAC,GAAG,oBAAoB,CAAC;AAE/B,MAAM,CAAC,IAAM,YAAY,GAAG;IAC1B,4EAA4E;IAC5E,IAAI,EAAE,UAAG,CAAC,UAAO;IAEjB,4EAA4E;IAC5E,4FAA4F;IAC5F,sFAAsF;IACtF,cAAc,EAAE,UAAG,CAAC,qBAAkB;IAEtC,4EAA4E;IAC5E,YAAY,EAAE,UAAC,MAAc,IAAK,OAAA,UAAG,CAAC,4BAAkB,MAAM,CAAE,EAA9B,CAA8B;IAChE,kBAAkB,EAAE,UAAG,CAAC,0BAAuB;IAC/C,iBAAiB,EAAE,UAAG,CAAC,yBAAsB;IAC7C,iBAAiB,EAAE,UAAG,CAAC,yBAAsB;IAC7C,cAAc,EAAE,UAAG,CAAC,qBAAkB;IAEtC,gBAAgB,EAAE,UAAG,CAAC,uBAAoB;IAE1C,6EAA6E;IAC7E,kFAAkF;IAClF,WAAW,EAAE,UAAC,OAAe,IAAK,OAAA,UAAG,CAAC,mBAAS,OAAO,CAAE,EAAtB,CAAsB;IACxD,YAAY,EAAE,UAAG,CAAC,oBAAiB;IACnC,iBAAiB,EAAE,UAAG,CAAC,yBAAsB;IAC7C,SAAS,EAAE,UAAG,CAAC,gBAAa;IAC5B,WAAW,EAAE,UAAG,CAAC,mBAAgB;IACjC,SAAS,EAAE,UAAG,CAAC,gBAAa;IAC5B,kBAAkB,EAAE,UAAG,CAAC,0BAAuB;IAC/C,yBAAyB,EAAE,UAAG,CAAC,kCAA+B;IAC9D,cAAc,EAAE,UAAG,CAAC,sBAAmB;IACvC,SAAS,EAAE,UAAG,CAAC,UAAO;IACtB,UAAU,EAAE,UAAG,CAAC,iBAAc;IAE9B,mFAAmF;IACnF,aAAa,EAAE,UAAG,CAAC,oBAAiB;IACpC,gBAAgB,EAAE,UAAG,CAAC,yBAAsB;IAC5C,yBAAyB,EAAE,UAAG,CAAC,kCAA+B;IAE9D,4EAA4E;IAC5E,iBAAiB,EAAE,UAAG,CAAC,yBAAsB;IAC7C,mBAAmB,EAAE,UAAG,CAAC,2BAAwB;IACjD,UAAU,EAAE,UAAG,CAAC,iBAAc;IAC9B,YAAY,EAAE,UAAG,CAAC,oBAAiB;IACnC,cAAc,EAAE,UAAG,CAAC,uBAAoB;IACxC,YAAY,EAAE,UAAG,CAAC,oBAAiB;IACnC,aAAa,EAAE,UAAG,CAAC,qBAAkB;IACrC,QAAQ,EAAE,UAAG,CAAC,cAAW;IAEzB,4EAA4E;IAC5E,SAAS,EAAE,UAAG,CAAC,gBAAa;IAC5B,cAAc,EAAE,UAAG,CAAC,gBAAa;IACjC,wFAAwF;IACxF,2FAA2F;IAC3F,gBAAgB,EAAE,UAAG,CAAC,wBAAqB;IAC3C,mBAAmB,EAAE,UAAG,CAAC,2BAAwB;IACjD,kBAAkB,EAAE,UAAG,CAAC,0BAAuB,EAAE,uDAAuD;CAChG,CAAC","sourcesContent":["/**\n * Centralized names for Session Replay diagnostics shipped via the analytics DiagnosticsClient.\n *\n * Every name shares SR_DIAGNOSTIC_PREFIX so they group together in DataDog as\n * `sdk.diagnostics.sr.trc.*`. The diagnostics pipeline prepends `sdk.diagnostics.` and appends\n * `.count` to counters / `.{min,max,avg,count}` to histograms; events are forwarded to DataDog\n * Logs keyed by `event_name`. Keep ALL SR diagnostic names here so the prefix stays unified —\n * changing the namespace is then a one-line edit.\n */\nexport const SR_DIAGNOSTIC_PREFIX = 'sr.trc';\n\nconst p = SR_DIAGNOSTIC_PREFIX;\n\nexport const SrDiagnostic = {\n  // ── Init (Q1: did init even happen?) ─────────────────────────────────────\n  init: `${p}.init`, // counter + event(with props): fires once per init()\n\n  // ── Session lifecycle ────────────────────────────────────────────────────\n  // SR session id changed (timeout / explicit setSessionId / custom session id). New tabs and\n  // page refreshes do NOT change the session id, so this is distinct from a fresh init.\n  sessionChanged: `${p}.session.changed`, // event (with from/to)\n\n  // ── Remote config fetch (joined-config) ──────────────────────────────────\n  configSource: (source: string) => `${p}.config.source.${source}`,\n  configHasTargeting: `${p}.config.has_targeting`,\n  configNoTargeting: `${p}.config.no_targeting`,\n  configFetchFailed: `${p}.config.fetch_failed`,\n  configReceived: `${p}.config.received`, // event (with props)\n\n  targetingTrigger: `${p}.targeting.trigger`, // event: targeting evaluation triggered\n\n  // ── Targeting evaluation (evaluateTargetingAndCapture) ────────────────────\n  // Q2 (did eval run?), Q3 (working/failed?), Q4 (missing value?), Q5 (all params).\n  evalTrigger: (trigger: string) => `${p}.eval.${trigger}`, // init | urlchange | event\n  evalNoConfig: `${p}.eval.no_config`,\n  evalMissingPrereq: `${p}.eval.missing_prereq`, // Q4: sessionId/config/deviceId missing\n  evalMatch: `${p}.eval.match`,\n  evalNoMatch: `${p}.eval.no_match`,\n  evalError: `${p}.eval.error`, // Q3: targeting engine threw\n  evalStaleDiscarded: `${p}.eval.stale_discarded`,\n  evalSkippedAlreadyMatched: `${p}.eval.skipped_already_matched`,\n  evalDurationMs: `${p}.eval.duration_ms`, // histogram\n  evalEvent: `${p}.eval`, // event (with ALL eval params — Q5)\n  evalResult: `${p}.eval.result`, // event: raw engine verdict (variantKey) — why match/no-match\n\n  // ── Recording execution (getShouldRecord said yes — did rrweb actually start?) ──\n  recordStarted: `${p}.record.started`, // event: capture began (carries the srId the replay uploads under)\n  recordNoRecordFn: `${p}.record.no_record_fn`, // counter + event: rrweb import returned nothing\n  sendSuppressedMinDuration: `${p}.send.suppressed_min_duration`, // counter: events held back by min_session_duration\n\n  // ── Record / no-record gate (getShouldRecord) ────────────────────────────\n  gateNoIdentifiers: `${p}.gate.no_identifiers`, // Q4: no config/sessionId at gate time\n  gateCaptureDisabled: `${p}.gate.capture_disabled`,\n  gateOptOut: `${p}.gate.optout`,\n  gateTrcMatch: `${p}.gate.trc_match`,\n  gateTrcNoMatch: `${p}.gate.trc_no_match`,\n  gateSampleIn: `${p}.gate.sample_in`,\n  gateSampleOut: `${p}.gate.sample_out`,\n  decision: `${p}.decision`, // event (with props)\n\n  // ── SPA URL change (setupUrlChangeListener) ──────────────────────────────\n  urlChange: `${p}.url_change`,\n  urlChangeEvent: `${p}.url_change`, // event (with props); same name, logs vs metric\n  // Was the URL-change listener even wired up? (covers \"the SDK never saw any navigation\"\n  // because the listener was never attached — e.g. no targeting config, or no global scope.)\n  urlListenerSetup: `${p}.url_listener.setup`, // event: the needsUrlTracking decision + its inputs\n  urlListenerAttached: `${p}.url_listener.attached`, // event: subscribeToUrlChanges succeeded (with polling opts)\n  urlListenerSkipped: `${p}.url_listener.skipped`, // counter + event: listener NOT attached (with reason)\n} as const;\n"]}

package/lib/esm/plugins/url-tracking-plugin.d.ts

@@ -35,6 +35,12 @@ export interface SubscribeToUrlChangesOptions {
     enablePolling?: boolean;
     /** Polling interval in ms when enablePolling is true (default: 1000) */
     pollingInterval?: number;
+    /**
+     * Optional debug logger, called once per poll tick (only on the polling path). Lets the SDK
+     * confirm in the browser console that the interval is actually firing — useful when verifying
+     * that enableUrlChangePolling took effect for an SPA that bypasses the History API.
+     */
+    log?: (message: string) => void;
 }
 /**
  * Single helper for URL change detection. Supports:

package/lib/esm/plugins/url-tracking-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-tracking-plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/url-tracking-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,6EAA6E;IAC7E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,oEAAoE;AACpE,MAAM,WAAW,4BAA4B;IAC3C,2FAA2F;IAC3F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EACnC,OAAO,GAAE,4BAAiC,GACzC,MAAM,IAAI,CAqGZ;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAA6B,GACrC,YAAY,CAAC,wBAAwB,CAAC,CAqFxC;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,wCAA4B,CAAC"}
+{"version":3,"file":"url-tracking-plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/url-tracking-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,6EAA6E;IAC7E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,oEAAoE;AACpE,MAAM,WAAW,4BAA4B;IAC3C,2FAA2F;IAC3F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EACnC,OAAO,GAAE,4BAAiC,GACzC,MAAM,IAAI,CAuGZ;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAA6B,GACrC,YAAY,CAAC,wBAAwB,CAAC,CAqFxC;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,wCAA4B,CAAC"}

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

@@ -25,12 +25,14 @@ export function subscribeToUrlChanges(globalScope, onUrlChange, options) {
             return;
         };
     }
-    var _a = options.enablePolling, enablePolling = _a === void 0 ? false : _a, _b = options.pollingInterval, pollingInterval = _b === void 0 ? DEFAULT_URL_CHANGE_POLLING_INTERVAL : _b;
+    var _a = options.enablePolling, enablePolling = _a === void 0 ? false : _a, _b = options.pollingInterval, pollingInterval = _b === void 0 ? DEFAULT_URL_CHANGE_POLLING_INTERVAL : _b, log = options.log;
     if (enablePolling) {
         var getHref_1 = function () { var _a; return (_a = globalScope.location.href) !== null && _a !== void 0 ? _a : ''; };
         var lastHref_1 = getHref_1();
         var id_1 = globalScope.setInterval(function () {
             var href = getHref_1();
+            // Logged every tick (not just on change) so we can confirm the polling loop is alive.
+            log === null || log === void 0 ? void 0 : log("URL polling tick (href=".concat(href, ", changed=").concat(String(href !== lastHref_1), ")."));
             if (href === lastHref_1) {
                 return;
             }

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

@@ -1 +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/** Options for subscribeToUrlChanges (polling vs history + hash) */\nexport interface SubscribeToUrlChangesOptions {\n  /** Use polling instead of history/popstate/hashchange (e.g. when history is unreliable) */\n  enablePolling?: boolean;\n  /** Polling interval in ms when enablePolling is true (default: 1000) */\n  pollingInterval?: number;\n}\n\n/** Patch detection marker to prevent double-patching */\nconst PATCH_MARKER = '__amplitude_url_tracking_patched__';\n\ntype PatchableHistoryMethod<T extends (...args: any[]) => any> = T & { [PATCH_MARKER]?: boolean };\n\ninterface UrlChangeSubscriptionState {\n  callbacks: Set<(href: string) => void>;\n  onPopStateOrHashChange: () => void;\n  notify: () => void;\n  listenersAttached: boolean;\n}\n\n/** Per-globalScope subscription state; persists to avoid wrapper stacking across re-subscribe cycles */\nconst urlChangeSubscriptionsByScope = new WeakMap<Window, UrlChangeSubscriptionState>();\n\n/**\n * Single helper for URL change detection. Supports:\n * - History API (pushState/replaceState) + popstate + hashchange (shared patch per scope)\n * - Optional polling (setInterval on location.href)\n *\n * Used by session-replay targeting (re-evaluate on URL change) and the URL tracking plugin\n * (emit rrweb events). Call the returned function to unsubscribe.\n *\n * @param globalScope - window (or equivalent); no-op if undefined\n * @param onUrlChange - called when the URL changes, with the new href\n * @param options - optional polling (default: event-based only)\n * @returns cleanup function to remove this subscription\n */\nexport function subscribeToUrlChanges(\n  globalScope: Window | undefined,\n  onUrlChange: (href: string) => void,\n  options: SubscribeToUrlChangesOptions = {},\n): () => void {\n  if (!globalScope?.location) {\n    return (): void => {\n      return;\n    };\n  }\n\n  const { enablePolling = false, pollingInterval = DEFAULT_URL_CHANGE_POLLING_INTERVAL } = options;\n\n  if (enablePolling) {\n    const getHref = (): string => globalScope.location.href ?? '';\n    let lastHref = getHref();\n    const id = globalScope.setInterval(() => {\n      const href = getHref();\n      if (href === lastHref) {\n        return;\n      }\n      lastHref = href;\n      onUrlChange(href);\n    }, pollingInterval);\n    return (): void => {\n      if (id != null) {\n        globalScope.clearInterval(id);\n      }\n    };\n  }\n\n  let subscriptionState = urlChangeSubscriptionsByScope.get(globalScope);\n  if (!subscriptionState) {\n    let lastHref: string | undefined = undefined;\n    const callbacks = new Set<(href: string) => void>();\n\n    const getHref = (): string => globalScope.location.href ?? '';\n\n    const notify = (): void => {\n      const href = getHref();\n      if (lastHref !== undefined && href === lastHref) return;\n      lastHref = href;\n      callbacks.forEach((c) => c(href));\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     */\n    const createHistoryMethodPatch = <T extends typeof history.pushState | typeof history.replaceState>(\n      originalMethod: T,\n    ) => {\n      const patchedMethod = function (this: History, ...args: Parameters<T>) {\n        const result = originalMethod.apply(this, args);\n        // Read from location.href after history call so we always notify with resolved absolute URL.\n        notify();\n        return result;\n      } as PatchableHistoryMethod<T>;\n\n      patchedMethod[PATCH_MARKER] = true;\n      return patchedMethod;\n    };\n\n    const history = globalScope.history;\n    if (history?.pushState) {\n      const pushState = Reflect.get(history, 'pushState') as PatchableHistoryMethod<History['pushState']>;\n      if (!pushState[PATCH_MARKER]) {\n        history.pushState = createHistoryMethodPatch(pushState);\n      }\n    }\n    if (history?.replaceState) {\n      const replaceState = Reflect.get(history, 'replaceState') as PatchableHistoryMethod<History['replaceState']>;\n      if (!replaceState[PATCH_MARKER]) {\n        history.replaceState = createHistoryMethodPatch(replaceState);\n      }\n    }\n\n    subscriptionState = {\n      callbacks,\n      notify,\n      onPopStateOrHashChange: () => notify(),\n      listenersAttached: false,\n    };\n    urlChangeSubscriptionsByScope.set(globalScope, subscriptionState);\n  }\n\n  const state = subscriptionState;\n  if (!state.listenersAttached) {\n    globalScope.addEventListener('popstate', state.onPopStateOrHashChange);\n    globalScope.addEventListener('hashchange', state.onPopStateOrHashChange);\n    state.listenersAttached = true;\n  }\n\n  state.callbacks.add(onUrlChange);\n  return (): void => {\n    state.callbacks.delete(onUrlChange);\n    if (state.callbacks.size === 0) {\n      // Do not restore history methods: we are not aware of patches applied by other scripts.\n      if (state.listenersAttached) {\n        globalScope.removeEventListener('popstate', state.onPopStateOrHashChange);\n        globalScope.removeEventListener('hashchange', state.onPopStateOrHashChange);\n        state.listenersAttached = false;\n      }\n    }\n  };\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       */\n      const emitUrlChange = (): void => {\n        const currentUrl = getCurrentUrl();\n        if (lastTrackedUrl === undefined || currentUrl !== lastTrackedUrl) {\n          lastTrackedUrl = currentUrl;\n          const event = createUrlChangeEvent();\n          cb(event);\n        }\n      };\n\n      // Single helper: history + popstate + hashchange, or polling when enabled\n      const unsubscribe = subscribeToUrlChanges(\n        globalScope as Window,\n        () => emitUrlChange(),\n        enablePolling ? { enablePolling: true, pollingInterval } : {},\n      );\n      emitUrlChange();\n\n      return (): void => unsubscribe();\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"]}
+{"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/** Options for subscribeToUrlChanges (polling vs history + hash) */\nexport interface SubscribeToUrlChangesOptions {\n  /** Use polling instead of history/popstate/hashchange (e.g. when history is unreliable) */\n  enablePolling?: boolean;\n  /** Polling interval in ms when enablePolling is true (default: 1000) */\n  pollingInterval?: number;\n  /**\n   * Optional debug logger, called once per poll tick (only on the polling path). Lets the SDK\n   * confirm in the browser console that the interval is actually firing — useful when verifying\n   * that enableUrlChangePolling took effect for an SPA that bypasses the History API.\n   */\n  log?: (message: string) => void;\n}\n\n/** Patch detection marker to prevent double-patching */\nconst PATCH_MARKER = '__amplitude_url_tracking_patched__';\n\ntype PatchableHistoryMethod<T extends (...args: any[]) => any> = T & { [PATCH_MARKER]?: boolean };\n\ninterface UrlChangeSubscriptionState {\n  callbacks: Set<(href: string) => void>;\n  onPopStateOrHashChange: () => void;\n  notify: () => void;\n  listenersAttached: boolean;\n}\n\n/** Per-globalScope subscription state; persists to avoid wrapper stacking across re-subscribe cycles */\nconst urlChangeSubscriptionsByScope = new WeakMap<Window, UrlChangeSubscriptionState>();\n\n/**\n * Single helper for URL change detection. Supports:\n * - History API (pushState/replaceState) + popstate + hashchange (shared patch per scope)\n * - Optional polling (setInterval on location.href)\n *\n * Used by session-replay targeting (re-evaluate on URL change) and the URL tracking plugin\n * (emit rrweb events). Call the returned function to unsubscribe.\n *\n * @param globalScope - window (or equivalent); no-op if undefined\n * @param onUrlChange - called when the URL changes, with the new href\n * @param options - optional polling (default: event-based only)\n * @returns cleanup function to remove this subscription\n */\nexport function subscribeToUrlChanges(\n  globalScope: Window | undefined,\n  onUrlChange: (href: string) => void,\n  options: SubscribeToUrlChangesOptions = {},\n): () => void {\n  if (!globalScope?.location) {\n    return (): void => {\n      return;\n    };\n  }\n\n  const { enablePolling = false, pollingInterval = DEFAULT_URL_CHANGE_POLLING_INTERVAL, log } = options;\n\n  if (enablePolling) {\n    const getHref = (): string => globalScope.location.href ?? '';\n    let lastHref = getHref();\n    const id = globalScope.setInterval(() => {\n      const href = getHref();\n      // Logged every tick (not just on change) so we can confirm the polling loop is alive.\n      log?.(`URL polling tick (href=${href}, changed=${String(href !== lastHref)}).`);\n      if (href === lastHref) {\n        return;\n      }\n      lastHref = href;\n      onUrlChange(href);\n    }, pollingInterval);\n    return (): void => {\n      if (id != null) {\n        globalScope.clearInterval(id);\n      }\n    };\n  }\n\n  let subscriptionState = urlChangeSubscriptionsByScope.get(globalScope);\n  if (!subscriptionState) {\n    let lastHref: string | undefined = undefined;\n    const callbacks = new Set<(href: string) => void>();\n\n    const getHref = (): string => globalScope.location.href ?? '';\n\n    const notify = (): void => {\n      const href = getHref();\n      if (lastHref !== undefined && href === lastHref) return;\n      lastHref = href;\n      callbacks.forEach((c) => c(href));\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     */\n    const createHistoryMethodPatch = <T extends typeof history.pushState | typeof history.replaceState>(\n      originalMethod: T,\n    ) => {\n      const patchedMethod = function (this: History, ...args: Parameters<T>) {\n        const result = originalMethod.apply(this, args);\n        // Read from location.href after history call so we always notify with resolved absolute URL.\n        notify();\n        return result;\n      } as PatchableHistoryMethod<T>;\n\n      patchedMethod[PATCH_MARKER] = true;\n      return patchedMethod;\n    };\n\n    const history = globalScope.history;\n    if (history?.pushState) {\n      const pushState = Reflect.get(history, 'pushState') as PatchableHistoryMethod<History['pushState']>;\n      if (!pushState[PATCH_MARKER]) {\n        history.pushState = createHistoryMethodPatch(pushState);\n      }\n    }\n    if (history?.replaceState) {\n      const replaceState = Reflect.get(history, 'replaceState') as PatchableHistoryMethod<History['replaceState']>;\n      if (!replaceState[PATCH_MARKER]) {\n        history.replaceState = createHistoryMethodPatch(replaceState);\n      }\n    }\n\n    subscriptionState = {\n      callbacks,\n      notify,\n      onPopStateOrHashChange: () => notify(),\n      listenersAttached: false,\n    };\n    urlChangeSubscriptionsByScope.set(globalScope, subscriptionState);\n  }\n\n  const state = subscriptionState;\n  if (!state.listenersAttached) {\n    globalScope.addEventListener('popstate', state.onPopStateOrHashChange);\n    globalScope.addEventListener('hashchange', state.onPopStateOrHashChange);\n    state.listenersAttached = true;\n  }\n\n  state.callbacks.add(onUrlChange);\n  return (): void => {\n    state.callbacks.delete(onUrlChange);\n    if (state.callbacks.size === 0) {\n      // Do not restore history methods: we are not aware of patches applied by other scripts.\n      if (state.listenersAttached) {\n        globalScope.removeEventListener('popstate', state.onPopStateOrHashChange);\n        globalScope.removeEventListener('hashchange', state.onPopStateOrHashChange);\n        state.listenersAttached = false;\n      }\n    }\n  };\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       */\n      const emitUrlChange = (): void => {\n        const currentUrl = getCurrentUrl();\n        if (lastTrackedUrl === undefined || currentUrl !== lastTrackedUrl) {\n          lastTrackedUrl = currentUrl;\n          const event = createUrlChangeEvent();\n          cb(event);\n        }\n      };\n\n      // Single helper: history + popstate + hashchange, or polling when enabled\n      const unsubscribe = subscribeToUrlChanges(\n        globalScope as Window,\n        () => emitUrlChange(),\n        enablePolling ? { enablePolling: true, pollingInterval } : {},\n      );\n      emitUrlChange();\n\n      return (): void => unsubscribe();\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/esm/session-replay.d.ts

@@ -67,6 +67,13 @@ export declare class SessionReplay implements AmplitudeSessionReplay {
      */
     private isBelowMinSessionDuration;
     private getCurrentPageForTargeting;
+    /**
+     * Best-effort navigation type from the Navigation Timing API: 'reload' | 'navigate' |
+     * 'back_forward' | 'prerender'. Surfaced in the init diagnostic so a page refresh ('reload')
+     * is distinguishable from a fresh load ('navigate') — neither changes the session id, so this
+     * is the only way to tell them apart. Returns undefined when the API is unavailable.
+     */
+    private getNavigationType;
     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, options?: {

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

@@ -1 +1 @@
-{"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/session-replay.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/session-replay.ts"],"names":[],"mappings":"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"}