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

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

@@ -1,74 +1,44 @@
 import { __assign, __awaiter, __generator } from "tslib";
 import { targetingIDBStore } from './targeting-idb-store';
-import { SrDiagnostic } from '../diagnostics';
 export 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;
+    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;
     return __awaiter(void 0, void 0, void 0, function () {
         var idbTargetingMatch, sessionTargetingMatch, evaluateTargetingPackage, params, targetingResult, err_1, knownError;
-        var _c, _d, _e, _f, _g, _h, _j;
-        return __generator(this, function (_k) {
-            switch (_k.label) {
+        return __generator(this, function (_c) {
+            switch (_c.label) {
                 case 0: return [4 /*yield*/, targetingIDBStore.clearStoreOfOldSessions({
                         loggerProvider: loggerProvider,
                         apiKey: apiKey,
                         currentSessionId: sessionId,
                     })];
                 case 1:
-                    _k.sent();
+                    _c.sent();
                     return [4 /*yield*/, targetingIDBStore.getTargetingMatchForSession({
                             loggerProvider: loggerProvider,
                             apiKey: apiKey,
                             sessionId: sessionId,
                         })];
                 case 2:
-                    idbTargetingMatch = _k.sent();
+                    idbTargetingMatch = _c.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;
-                    _k.label = 3;
+                    _c.label = 3;
                 case 3:
-                    _k.trys.push([3, 6, , 7]);
+                    _c.trys.push([3, 6, , 7]);
                     return [4 /*yield*/, import('@amplitude/targeting')];
                 case 4:
-                    evaluateTargetingPackage = (_k.sent()).evaluateTargeting;
+                    evaluateTargetingPackage = (_c.sent()).evaluateTargeting;
                     params = __assign(__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(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 = _k.sent();
+                    targetingResult = _c.sent();
                     if (targetingResult && targetingResult.sr_targeting_config) {
                         sessionTargetingMatch = targetingResult.sr_targeting_config.key === 'on';
                     }
-                    // gap #2: the raw engine verdict. variantKey 'on' => matched; 'off'/undefined => not.
-                    // Pair with the eval event's pageUrl to tell "URL condition didn't match" from "URL matched
-                    // but the segment bucket (capture %) didn't allocate this session".
-                    try {
-                        diagnosticsClient === null || diagnosticsClient === void 0 ? void 0 : diagnosticsClient.recordEvent(SrDiagnostic.evalResult, {
-                            sessionId: sessionId,
-                            deviceId: deviceId,
-                            srId: deviceId != null && sessionId != null ? "".concat(deviceId, "/").concat(sessionId) : undefined,
-                            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 ((_g = diagnosticsClient === null || diagnosticsClient === void 0 ? void 0 : diagnosticsClient._flush) === null || _g === void 0 ? void 0 : _g.call(diagnosticsClient));
-                    }
-                    catch (_l) {
-                        // diagnostics is best-effort
-                    }
                     void targetingIDBStore.storeTargetingMatchForSession({
                         loggerProvider: loggerProvider,
                         apiKey: apiKey,
@@ -77,24 +47,8 @@ export var evaluateTargetingAndStore = function (_a) {
                     });
                     return [3 /*break*/, 7];
                 case 6:
-                    err_1 = _k.sent();
+                    err_1 = _c.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.
-                    try {
-                        diagnosticsClient === null || diagnosticsClient === void 0 ? void 0 : diagnosticsClient.increment(SrDiagnostic.evalError);
-                        diagnosticsClient === null || diagnosticsClient === void 0 ? void 0 : diagnosticsClient.recordEvent(SrDiagnostic.evalError, {
-                            sessionId: sessionId,
-                            deviceId: deviceId,
-                            srId: deviceId != null && sessionId != null ? "".concat(deviceId, "/").concat(sessionId) : undefined,
-                            pageUrl: (_h = targetingParams === null || targetingParams === void 0 ? void 0 : targetingParams.page) === null || _h === void 0 ? void 0 : _h.url,
-                            message: knownError.message,
-                        });
-                        void ((_j = diagnosticsClient === null || diagnosticsClient === void 0 ? void 0 : diagnosticsClient._flush) === null || _j === void 0 ? void 0 : _j.call(diagnosticsClient));
-                    }
-                    catch (_m) {
-                        // diagnostics is best-effort
-                    }
                     loggerProvider.warn(knownError.message);
                     return [3 /*break*/, 7];
                 case 7: return [2 /*return*/, sessionTargetingMatch];

package/lib/esm/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    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"]}
+{"version":3,"file":"targeting-manager.js","sourceRoot":"","sources":["../../../src/targeting/targeting-manager.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,CAAC,IAAM,yBAAyB,GAAG,UAAO,EAc/C;QAbC,SAAS,eAAA,EACT,eAAe,qBAAA,EACf,cAAc,oBAAA,EACd,MAAM,YAAA,EACN,eAAe,qBAAA,EACf,iBAAiB,EAAjB,SAAS,mBAAG,KAAK,KAAA;;;;;wBASjB,qBAAM,iBAAiB,CAAC,uBAAuB,CAAC;wBAC9C,cAAc,EAAE,cAAc;wBAC9B,MAAM,EAAE,MAAM;wBACd,gBAAgB,EAAE,SAAS;qBAC5B,CAAC,EAAA;;oBAJF,SAIE,CAAC;oBAEuB,qBAAM,iBAAiB,CAAC,2BAA2B,CAAC;4BAC5E,cAAc,EAAE,cAAc;4BAC9B,MAAM,EAAE,MAAM;4BACd,SAAS,EAAE,SAAS;yBACrB,CAAC,EAAA;;oBAJI,iBAAiB,GAAG,SAIxB;oBACF,4FAA4F;oBAC5F,qFAAqF;oBACrF,IAAI,iBAAiB,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE;wBAC5C,sBAAO,IAAI,EAAC;qBACb;oBAKG,qBAAqB,GAAG,IAAI,CAAC;;;;oBAGyB,qBAAM,MAAM,CAAC,sBAAsB,CAAC,EAAA;;oBAAjE,wBAAwB,GAAK,CAAA,SAAoC,CAAA,kBAAzC;oBAE7C,MAAM,yBACP,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;oBACsB,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;oBAED,KAAK,iBAAiB,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,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;;wBAE1C,sBAAO,qBAAqB,EAAC;;;;CAC9B,CAAC","sourcesContent":["import type { TargetingParameters } from '@amplitude/targeting';\nimport { TargetingConfig } from '../config/types';\nimport { Logger } from '@amplitude/analytics-types';\nimport { SessionReplayTargetingInput } from '../typings/session-replay';\nimport { targetingIDBStore } from './targeting-idb-store';\n\nexport const evaluateTargetingAndStore = async ({\n  sessionId,\n  targetingConfig,\n  loggerProvider,\n  apiKey,\n  targetingParams,\n  urlChange = false,\n}: {\n  sessionId: string | number;\n  targetingConfig: TargetingConfig;\n  loggerProvider: Logger;\n  apiKey: string;\n  targetingParams?: SessionReplayTargetingInput;\n  urlChange?: boolean;\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  // 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\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    loggerProvider.warn(knownError.message);\n  }\n  return sessionTargetingMatch;\n};\n"]}

package/lib/esm/track-destination.d.ts

@@ -1,5 +1,6 @@
 import { ILogger, ServerZone } from '@amplitude/analytics-core';
 import { SessionReplayTrackDestination as AmplitudeSessionReplayTrackDestination, SessionReplayDestination, SessionReplayDestinationContext } from './typings/session-replay';
+import { SessionReplaySendEventsHandler } from './config/types';
 export type PayloadBatcher = ({ version, events }: {
     version: number;
     events: string[];
@@ -26,13 +27,15 @@ export declare class SessionReplayTrackDestination implements AmplitudeSessionRe
     private coalesceNextFlush;
     private mergeLogFiredThisPause;
     private killedSessions;
-    constructor({ trackServerUrl, loggerProvider, payloadBatcher, workerScript, enableTransportCompression, sendTimeoutMs, }: {
+    private handleSendEvents?;
+    constructor({ trackServerUrl, loggerProvider, payloadBatcher, workerScript, enableTransportCompression, sendTimeoutMs, handleSendEvents, }: {
         trackServerUrl?: string;
         loggerProvider: ILogger;
         payloadBatcher?: PayloadBatcher;
         workerScript?: string;
         enableTransportCompression?: boolean;
         sendTimeoutMs?: number;
+        handleSendEvents?: SessionReplaySendEventsHandler;
     });
     sendEventsList(destinationData: SessionReplayDestination): void;
     /**
@@ -99,6 +102,7 @@ export declare class SessionReplayTrackDestination implements AmplitudeSessionRe
     send(context: SessionReplayDestinationContext, useRetry?: boolean): Promise<void>;
     private sendViaWorker;
     private rememberTimedOutRequest;
+    private handleDelegatedFetch;
     private sendOnMainThread;
     handleReponse(status: number, context: SessionReplayDestinationContext, responseBody?: string): Promise<void>;
     handlePayloadTooLargeResponse(context: SessionReplayDestinationContext, isWaf: boolean): void;

package/lib/esm/track-destination.d.ts.map

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

package/lib/esm/track-destination.js

@@ -12,9 +12,33 @@ var MAX_KILLED_SESSIONS = 256;
 // In normal operation each entry is removed when the worker's late message arrives; this
 // cap only guards the pathological case of a wedged worker that never replies at all.
 var MAX_TIMED_OUT_WORKER_REQUESTS = 256;
+// Settles with `promise`, but rejects early with an AbortError when `signal` fires. Used to apply
+// the send timeout to a custom transport whose own promise can't be cancelled: a hung transport
+// then surfaces as a retryable timeout (matching the built-in fetch and worker delegation paths)
+// instead of blocking the serial flush loop. The transport's promise keeps running; we just stop
+// awaiting it. `signal` is always supplied with the send-timeout controller's signal.
+function abortable(promise, signal) {
+    return new Promise(function (resolve, reject) {
+        var onAbort = function () {
+            // Match how browsers reject an aborted fetch (DOMException 'AbortError'); sendOnMainThread's
+            // catch keys off the name to route it through the retry budget rather than failing fatally.
+            var err = new Error('Custom session replay transport aborted by send timeout');
+            err.name = 'AbortError';
+            reject(err);
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        promise.then(function (value) {
+            signal.removeEventListener('abort', onAbort);
+            resolve(value);
+        }, function (err) {
+            signal.removeEventListener('abort', onAbort);
+            reject(err);
+        });
+    });
+}
 var SessionReplayTrackDestination = /** @class */ (function () {
     function SessionReplayTrackDestination(_a) {
-        var trackServerUrl = _a.trackServerUrl, loggerProvider = _a.loggerProvider, payloadBatcher = _a.payloadBatcher, workerScript = _a.workerScript, enableTransportCompression = _a.enableTransportCompression, sendTimeoutMs = _a.sendTimeoutMs;
+        var trackServerUrl = _a.trackServerUrl, loggerProvider = _a.loggerProvider, payloadBatcher = _a.payloadBatcher, workerScript = _a.workerScript, enableTransportCompression = _a.enableTransportCompression, sendTimeoutMs = _a.sendTimeoutMs, handleSendEvents = _a.handleSendEvents;
         var _this = this;
         this.storageKey = '';
         this.retryTimeout = 1000;
@@ -50,6 +74,7 @@ var SessionReplayTrackDestination = /** @class */ (function () {
         this.trackServerUrl = trackServerUrl;
         this.enableTransportCompression = enableTransportCompression !== null && enableTransportCompression !== void 0 ? enableTransportCompression : true;
         this.sendTimeoutMs = sendTimeoutMs !== null && sendTimeoutMs !== void 0 ? sendTimeoutMs : SEND_TIMEOUT_MS;
+        this.handleSendEvents = handleSendEvents;
         if (workerScript) {
             try {
                 var blob = new Blob([workerScript], { type: 'application/javascript' });
@@ -141,6 +166,16 @@ var SessionReplayTrackDestination = /** @class */ (function () {
                             }
                         }
                     }
+                    else if (msg.type === 'fetch-request') {
+                        // Worker is delegating one network attempt to the custom transport (which lives on
+                        // the main thread). Run it and post the result back into the worker's retry loop.
+                        // Guard the fire-and-forget call: if posting the result back fails (e.g. the worker
+                        // was terminated mid-flight), surface it to the logger instead of leaving an
+                        // unhandled rejection.
+                        void _this.handleDelegatedFetch(worker_1, msg).catch(function (e) {
+                            loggerProvider.warn('Failed to handle delegated session replay fetch:', e);
+                        });
+                    }
                 };
                 this.worker = worker_1;
             }
@@ -178,6 +213,7 @@ var SessionReplayTrackDestination = /** @class */ (function () {
      * to cover the remaining incremental events since the last fetch flush.
      */
     SessionReplayTrackDestination.prototype.sendBeacon = function (_a) {
+        var _this = this;
         var _b, _c;
         var events = _a.events, sessionId = _a.sessionId, deviceId = _a.deviceId, apiKey = _a.apiKey, serverZone = _a.serverZone;
         var MAX_BEACON_BYTES = 64 * 1024;
@@ -205,6 +241,37 @@ var SessionReplayTrackDestination = /** @class */ (function () {
         if (trimmedEvents.length === 0) {
             return;
         }
+        // Custom-transport page-exit path: navigator.sendBeacon cannot carry custom headers, so a
+        // JWT customer's exit batch would go out unauthenticated and be rejected by their proxy.
+        // Instead, route it through the callback with keepalive (which survives unload AND carries
+        // headers). Mirrors the main-send request shape: Authorization header + device_id/session_id/
+        // type params (api_key is NOT placed in the URL, unlike the legacy beacon path below).
+        if (this.handleSendEvents) {
+            var exitParams = new URLSearchParams({
+                device_id: deviceId,
+                session_id: String(sessionId),
+                type: 'replay',
+            });
+            var exitUrl = "".concat(getServerUrl(serverZone, this.trackServerUrl), "?").concat(exitParams.toString());
+            var headers = {
+                'Content-Type': 'application/json',
+                Accept: '*/*',
+                Authorization: "Bearer ".concat(apiKey),
+            };
+            this.loggerProvider.debug("Routing session replay exit batch (".concat(trimmedEvents.length, " events) through custom transport for session id ").concat(sessionId, "."));
+            try {
+                // Fire-and-forget: we cannot await during unload. The request is well under 64 KB
+                // (trimmed above) and keepalive: true is requested so it survives page teardown.
+                void this.handleSendEvents({ url: exitUrl, method: 'POST', headers: headers, body: payload, keepalive: true }).catch(function (e) {
+                    // best effort on exit, but still surface the failure so it's diagnosable in logs.
+                    _this.loggerProvider.warn('Custom transport failed to send session replay exit batch:', e);
+                });
+            }
+            catch (e) {
+                this.loggerProvider.warn('Custom transport threw while sending session replay exit batch:', e);
+            }
+            return;
+        }
         var urlParams = new URLSearchParams({
             device_id: deviceId,
             session_id: String(sessionId),
@@ -573,6 +640,10 @@ var SessionReplayTrackDestination = /** @class */ (function () {
                             id: id,
                             payload: payload,
                             useRetry: useRetry,
+                            // Tell the worker to delegate each network attempt back to the main thread, where the
+                            // custom transport callback lives (functions can't cross postMessage). Absent/false
+                            // keeps the worker's own internal fetch — the unchanged path for existing integrations.
+                            useCustomTransport: !!_this.handleSendEvents,
                             context: {
                                 apiKey: context.apiKey,
                                 deviceId: context.deviceId,
@@ -616,12 +687,82 @@ var SessionReplayTrackDestination = /** @class */ (function () {
             }
         }
     };
+    // Runs the custom transport on the main thread for a single attempt the worker delegated,
+    // then posts the result back into the worker's retry loop as a 'fetch-response'. We read only
+    // what the worker's status handling needs: the skip header on a 2xx and the body text on a
+    // 413 (for WAF detection). A thrown/rejected transport is reported as an error so the worker
+    // surfaces it the same way a thrown fetch would (no retry) — matching the main-thread path.
+    SessionReplayTrackDestination.prototype.handleDelegatedFetch = function (worker, msg) {
+        var _a, _b, _c;
+        return __awaiter(this, void 0, void 0, function () {
+            var requestId, url, method, headers, body, keepalive, res, status_1, skipHeader, responseBody, _d, e_7;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
+                    case 0:
+                        requestId = msg.requestId, url = msg.url, method = msg.method, headers = msg.headers, body = msg.body, keepalive = msg.keepalive;
+                        _e.label = 1;
+                    case 1:
+                        _e.trys.push([1, 10, , 11]);
+                        res = void 0;
+                        if (!this.handleSendEvents) return [3 /*break*/, 3];
+                        return [4 /*yield*/, this.handleSendEvents({ url: url, method: method, headers: headers, body: body, keepalive: keepalive })];
+                    case 2:
+                        res = _e.sent();
+                        return [3 /*break*/, 5];
+                    case 3:
+                        // Defensive only: the worker emits 'fetch-request' solely when useCustomTransport is set,
+                        // so this branch shouldn't be reachable. Warn so a regression that delegates without a
+                        // transport is diagnosable rather than silently routing to the built-in fetch.
+                        this.loggerProvider.warn('Delegated session replay fetch received without a custom transport configured; falling back to built-in fetch.');
+                        return [4 /*yield*/, fetch(url, { method: method, headers: headers, body: body, keepalive: keepalive })];
+                    case 4:
+                        res = _e.sent();
+                        _e.label = 5;
+                    case 5:
+                        status_1 = res.status;
+                        skipHeader = null;
+                        responseBody = '';
+                        if (status_1 >= 200 && status_1 < 300) {
+                            skipHeader = (_c = (_b = (_a = res.headers) === null || _a === void 0 ? void 0 : _a.get) === null || _b === void 0 ? void 0 : _b.call(_a, EVENT_SKIPPED_HEADER)) !== null && _c !== void 0 ? _c : null;
+                        }
+                        if (!(status_1 === 413)) return [3 /*break*/, 9];
+                        _e.label = 6;
+                    case 6:
+                        _e.trys.push([6, 8, , 9]);
+                        return [4 /*yield*/, res.text()];
+                    case 7:
+                        responseBody = _e.sent();
+                        return [3 /*break*/, 9];
+                    case 8:
+                        _d = _e.sent();
+                        return [3 /*break*/, 9];
+                    case 9:
+                        this.loggerProvider.debug("Delegated session replay fetch (request ".concat(requestId, ") returned status ").concat(status_1, "."));
+                        worker.postMessage({ type: 'fetch-response', requestId: requestId, status: status_1, skipHeader: skipHeader, body: responseBody });
+                        return [3 /*break*/, 11];
+                    case 10:
+                        e_7 = _e.sent();
+                        this.loggerProvider.debug("Delegated session replay fetch (request ".concat(requestId, ") failed:"), e_7);
+                        worker.postMessage({
+                            type: 'fetch-response',
+                            requestId: requestId,
+                            status: 0,
+                            skipHeader: null,
+                            body: String(e_7),
+                            error: true,
+                        });
+                        return [3 /*break*/, 11];
+                    case 11: return [2 /*return*/];
+                }
+            });
+        });
+    };
     SessionReplayTrackDestination.prototype.sendOnMainThread = function (apiKey, deviceId, context, payload, useRetry) {
         var _a, _b, _c, _d, _e, _f, _g;
         return __awaiter(this, void 0, void 0, function () {
-            var url, version, sampleRate, urlParams, sessionReplayLibrary, payloadJson, globalScope, gzipped, _h, payloadSize, controller_1, options, serverUrl, sendTimeout, res, skipCode, responseBody, responseBody, _j, e_7, isAbort;
-            return __generator(this, function (_k) {
-                switch (_k.label) {
+            var url, version, sampleRate, urlParams, sessionReplayLibrary, payloadJson, globalScope, gzipped, _h, payloadSize, controller_1, headers, body, keepalive, options, serverUrl, sendTimeout, res, _j, skipCode, responseBody, responseBody, _k, e_8, isAbort;
+            return __generator(this, function (_l) {
+                switch (_l.label) {
                     case 0:
                         url = getCurrentUrl();
                         version = VERSION;
@@ -632,30 +773,31 @@ var SessionReplayTrackDestination = /** @class */ (function () {
                             type: "".concat(context.type),
                         });
                         sessionReplayLibrary = "".concat((_b = (_a = context.version) === null || _a === void 0 ? void 0 : _a.type) !== null && _b !== void 0 ? _b : 'standalone', "/").concat((_d = (_c = context.version) === null || _c === void 0 ? void 0 : _c.version) !== null && _d !== void 0 ? _d : version);
-                        _k.label = 1;
+                        _l.label = 1;
                     case 1:
-                        _k.trys.push([1, 16, , 20]);
+                        _l.trys.push([1, 19, , 23]);
                         payloadJson = JSON.stringify(payload);
                         globalScope = getGlobalScope();
                         if (!(this.enableTransportCompression && globalScope && 'CompressionStream' in globalScope)) return [3 /*break*/, 3];
                         return [4 /*yield*/, gzipJson(payloadJson, globalScope)];
                     case 2:
-                        _h = _k.sent();
+                        _h = _l.sent();
                         return [3 /*break*/, 4];
                     case 3:
                         _h = null;
-                        _k.label = 4;
+                        _l.label = 4;
                     case 4:
                         gzipped = _h;
                         payloadSize = gzipped ? gzipped.byteLength : new Blob([payloadJson]).size;
                         controller_1 = new AbortController();
+                        headers = __assign({ 'Content-Type': 'application/json', Accept: '*/*', Authorization: "Bearer ".concat(apiKey), 'X-Client-Version': version, 'X-Client-Library': sessionReplayLibrary, 'X-Client-Url': url.substring(0, MAX_URL_LENGTH), 'X-Client-Sample-Rate': "".concat(sampleRate), 'X-Sampling-Hash-Alg': 'xxhash32' }, (gzipped ? { 'Content-Encoding': 'gzip' } : {}));
+                        body = gzipped !== null && gzipped !== void 0 ? gzipped : payloadJson;
+                        keepalive = payloadSize <= MAX_KEEPALIVE_BYTES;
                         options = {
-                            headers: __assign({ 'Content-Type': 'application/json', Accept: '*/*', Authorization: "Bearer ".concat(apiKey), 'X-Client-Version': version, 'X-Client-Library': sessionReplayLibrary, 'X-Client-Url': url.substring(0, MAX_URL_LENGTH), 'X-Client-Sample-Rate': "".concat(sampleRate), 'X-Sampling-Hash-Alg': 'xxhash32' }, (gzipped ? { 'Content-Encoding': 'gzip' } : {})),
-                            body: (gzipped !== null && gzipped !== void 0 ? gzipped : payloadJson),
+                            headers: headers,
+                            body: body,
                             method: 'POST',
-                            // keepalive lets the request survive page navigation, preventing 499 (client-closed) errors.
-                            // Must stay under the browser's 64 KB keepalive budget; large payloads skip it.
-                            keepalive: payloadSize <= MAX_KEEPALIVE_BYTES,
+                            keepalive: keepalive,
                             signal: controller_1.signal,
                         };
                         serverUrl = "".concat(getServerUrl(context.serverZone, this.trackServerUrl), "?").concat(urlParams.toString());
@@ -674,20 +816,35 @@ var SessionReplayTrackDestination = /** @class */ (function () {
                             }, this.sendTimeoutMs)
                             : undefined;
                         res = void 0;
-                        _k.label = 5;
+                        _l.label = 5;
                     case 5:
-                        _k.trys.push([5, , 7, 8]);
-                        return [4 /*yield*/, fetch(serverUrl, options)];
+                        _l.trys.push([5, , 10, 11]);
+                        if (!this.handleSendEvents) return [3 /*break*/, 7];
+                        return [4 /*yield*/, abortable(this.handleSendEvents({ url: serverUrl, method: 'POST', headers: headers, body: body, keepalive: keepalive }), controller_1.signal)];
                     case 6:
-                        res = _k.sent();
-                        return [3 /*break*/, 8];
-                    case 7:
+                        _j = _l.sent();
+                        return [3 /*break*/, 9];
+                    case 7: return [4 /*yield*/, fetch(serverUrl, options)];
+                    case 8:
+                        _j = _l.sent();
+                        _l.label = 9;
+                    case 9:
+                        // When a custom transport is configured, hand it the fully-formed request and let it own
+                        // the network call (e.g. to attach a JWT and route through a proxy). Otherwise use the
+                        // built-in fetch. Retry/response handling below is identical for both paths. The built-in
+                        // fetch cancels directly on controller.signal; the custom callback can't be cancelled, so
+                        // we race it against the abort — a hung/never-settling transport then rejects with an
+                        // AbortError (retryable, like the worker delegation path) instead of blocking the serial
+                        // flush loop forever. The callback's own promise keeps running; we just stop awaiting it.
+                        res = _j;
+                        return [3 /*break*/, 11];
+                    case 10:
                         // Clear on success and on error alike so a settled request never leaves an armed
                         // timer that would abort a later reused controller or fire a stray callback.
                         if (sendTimeout)
                             clearTimeout(sendTimeout);
                         return [7 /*endfinally*/];
-                    case 8:
+                    case 11:
                         if (res === null) {
                             this.completeRequest({ context: context, err: UNEXPECTED_ERROR_MESSAGE });
                             return [2 /*return*/];
@@ -696,47 +853,47 @@ var SessionReplayTrackDestination = /** @class */ (function () {
                             skipCode = (_g = (_f = (_e = res.headers) === null || _e === void 0 ? void 0 : _e.get) === null || _f === void 0 ? void 0 : _f.call(_e, EVENT_SKIPPED_HEADER)) !== null && _g !== void 0 ? _g : null;
                             this.applyServerDirective(context.sessionId, skipCode);
                         }
-                        if (!!useRetry) return [3 /*break*/, 9];
+                        if (!!useRetry) return [3 /*break*/, 12];
                         responseBody = '';
                         try {
                             responseBody = JSON.stringify(res.body, null, 2);
                         }
-                        catch (_l) {
+                        catch (_m) {
                             // to avoid crash, but don't care about the error, add comment to avoid empty block lint error
                         }
                         this.completeRequest({ context: context, success: "".concat(res.status, ": ").concat(responseBody) });
-                        return [3 /*break*/, 15];
-                    case 9:
+                        return [3 /*break*/, 18];
+                    case 12:
                         responseBody = '';
-                        if (!(res.status === 413)) return [3 /*break*/, 13];
-                        _k.label = 10;
-                    case 10:
-                        _k.trys.push([10, 12, , 13]);
+                        if (!(res.status === 413)) return [3 /*break*/, 16];
+                        _l.label = 13;
+                    case 13:
+                        _l.trys.push([13, 15, , 16]);
                         return [4 /*yield*/, res.text()];
-                    case 11:
-                        responseBody = _k.sent();
-                        return [3 /*break*/, 13];
-                    case 12:
-                        _j = _k.sent();
-                        return [3 /*break*/, 13];
-                    case 13: return [4 /*yield*/, this.handleReponse(res.status, context, responseBody)];
                     case 14:
-                        _k.sent();
-                        _k.label = 15;
-                    case 15: return [3 /*break*/, 20];
-                    case 16:
-                        e_7 = _k.sent();
-                        isAbort = !!e_7 && typeof e_7 === 'object' && e_7.name === 'AbortError';
-                        if (!(isAbort && useRetry)) return [3 /*break*/, 18];
-                        return [4 /*yield*/, this.handleOtherResponse(context)];
+                        responseBody = _l.sent();
+                        return [3 /*break*/, 16];
+                    case 15:
+                        _k = _l.sent();
+                        return [3 /*break*/, 16];
+                    case 16: return [4 /*yield*/, this.handleReponse(res.status, context, responseBody)];
                     case 17:
-                        _k.sent();
-                        return [3 /*break*/, 19];
-                    case 18:
-                        this.completeRequest({ context: context, err: e_7 });
-                        _k.label = 19;
-                    case 19: return [3 /*break*/, 20];
-                    case 20: return [2 /*return*/];
+                        _l.sent();
+                        _l.label = 18;
+                    case 18: return [3 /*break*/, 23];
+                    case 19:
+                        e_8 = _l.sent();
+                        isAbort = !!e_8 && typeof e_8 === 'object' && e_8.name === 'AbortError';
+                        if (!(isAbort && useRetry)) return [3 /*break*/, 21];
+                        return [4 /*yield*/, this.handleOtherResponse(context)];
+                    case 20:
+                        _l.sent();
+                        return [3 /*break*/, 22];
+                    case 21:
+                        this.completeRequest({ context: context, err: e_8 });
+                        _l.label = 22;
+                    case 22: return [3 /*break*/, 23];
+                    case 23: return [2 /*return*/];
                 }
             });
         });
@@ -890,7 +1047,7 @@ var SessionReplayTrackDestination = /** @class */ (function () {
         // session for a code we don't recognize.
     };
     SessionReplayTrackDestination.prototype.killSession = function (sessionId, skipCode) {
-        var e_8, _a, e_9, _b;
+        var e_9, _a, e_10, _b;
         if (this.killedSessions.has(sessionId))
             return;
         this.killedSessions.add(sessionId);
@@ -903,12 +1060,12 @@ var SessionReplayTrackDestination = /** @class */ (function () {
                     break;
                 }
             }
-            catch (e_8_1) { e_8 = { error: e_8_1 }; }
+            catch (e_9_1) { e_9 = { error: e_9_1 }; }
             finally {
                 try {
                     if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
                 }
-                finally { if (e_8) throw e_8.error; }
+                finally { if (e_9) throw e_9.error; }
             }
         }
         this.loggerProvider.log("Session replay capture stopped for session ".concat(sessionId, " by server directive ").concat(skipCode, "; remaining events will be dropped"));
@@ -926,12 +1083,12 @@ var SessionReplayTrackDestination = /** @class */ (function () {
                 }
             }
         }
-        catch (e_9_1) { e_9 = { error: e_9_1 }; }
+        catch (e_10_1) { e_10 = { error: e_10_1 }; }
         finally {
             try {
                 if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
             }
-            finally { if (e_9) throw e_9.error; }
+            finally { if (e_10) throw e_10.error; }
         }
         this.queue = remaining;
     };