@tracelog/lib 2.9.0-rc.107.4 → 2.9.0-rc.108.13

package/dist/browser/tracelog.esm.js

@@ -1,6 +1,6 @@
-const fr = 9e5;
-const mr = 120, gr = 49152, pr = 100, Er = 500, Sr = 200;
-const Tr = 1e3, Ir = 500, _r = 1e3;
+const gr = 9e5;
+const pr = 120, Er = 49152, Sr = 100, Tr = 500, vr = 200;
+const Ir = 1e3, _r = 500, yr = 1e3;
 const b = "data-tlog", bt = [
   "button",
   "a",
@@ -79,7 +79,7 @@ const S = {
   /<iframe\b[^<]*(?:(?!<\/iframe>)<[^<]*)*<\/iframe>/gi,
   /<embed\b[^>]*>/gi,
   /<object\b[^<]*(?:(?!<\/object>)<[^<]*)*<\/object>/gi
-], I = "tlog", G = `${I}:qa_mode`, Ie = `${I}:uid`, rt = "tlog_mode", Ue = "qa", Fe = "qa_off", Ct = (r) => r ? `${I}:${r}:queue` : `${I}:queue`, Rt = (r) => r ? `${I}:${r}:rate_limit` : `${I}:rate_limit`, Nt = (r) => r ? `${I}:${r}:session` : `${I}:session`, Ot = (r) => r ? `${I}:${r}:broadcast` : `${I}:broadcast`, He = (r, e) => `${I}:${r}:session_counts:${e}`, xe = 10080 * 60 * 1e3, $e = `${I}:session_counts_last_cleanup`, Be = 3600 * 1e3, me = (r) => r ? `${I}:${r}:identity` : `${I}:identity`, F = `${I}:pending_identity`;
+], I = "tlog", G = `${I}:qa_mode`, ve = `${I}:uid`, rt = "tlog_mode", Ue = "qa", He = "qa_off", Ct = (r) => r ? `${I}:${r}:queue` : `${I}:queue`, Rt = (r) => r ? `${I}:${r}:rate_limit` : `${I}:rate_limit`, Nt = (r) => r ? `${I}:${r}:session` : `${I}:session`, Ot = (r) => r ? `${I}:${r}:broadcast` : `${I}:broadcast`, Fe = (r, e) => `${I}:${r}:session_counts:${e}`, xe = 10080 * 60 * 1e3, $e = `${I}:session_counts_last_cleanup`, Be = 3600 * 1e3, me = (r) => r ? `${I}:${r}:identity` : `${I}:identity`, H = `${I}:pending_identity`;
 var $ = /* @__PURE__ */ ((r) => (r.Localhost = "localhost:8080", r.Fail = "localhost:9999", r))($ || {}), A = /* @__PURE__ */ ((r) => (r.Mobile = "mobile", r.Tablet = "tablet", r.Desktop = "desktop", r.Unknown = "unknown", r))(A || {}), se = /* @__PURE__ */ ((r) => (r.EVENT = "event", r.QUEUE = "queue", r))(se || {});
 class O extends Error {
   constructor(e, t, s) {
@@ -99,7 +99,7 @@ class ne extends Error {
   }
 }
 var u = /* @__PURE__ */ ((r) => (r.PAGE_VIEW = "page_view", r.CLICK = "click", r.SCROLL = "scroll", r.SESSION_START = "session_start", r.CUSTOM = "custom", r.WEB_VITALS = "web_vitals", r.ERROR = "error", r.VIEWPORT_VISIBLE = "viewport_visible", r))(u || {}), Z = /* @__PURE__ */ ((r) => (r.UP = "up", r.DOWN = "down", r))(Z || {}), B = /* @__PURE__ */ ((r) => (r.JS_ERROR = "js_error", r.PROMISE_REJECTION = "promise_rejection", r))(B || {}), ie = /* @__PURE__ */ ((r) => (r.QA = "qa", r))(ie || {});
-const vr = (r) => r.type === u.SCROLL && "scroll_data" in r && r.scroll_data.is_primary === !0, yr = (r) => r.type === u.SCROLL && "scroll_data" in r && r.scroll_data.is_primary === !1;
+const wr = (r) => r.type === u.SCROLL && "scroll_data" in r && r.scroll_data.is_primary === !0, br = (r) => r.type === u.SCROLL && "scroll_data" in r && r.scroll_data.is_primary === !1;
 class j extends Error {
   constructor(e, t, s) {
     super(e), this.errorCode = t, this.layer = s, this.name = this.constructor.name, Error.captureStackTrace && Error.captureStackTrace(this, this.constructor);
@@ -127,7 +127,7 @@ class N extends j {
     super(e, "INTEGRATION_INVALID", t);
   }
 }
-class wr extends j {
+class Lr extends j {
   constructor(e, t, s = "runtime") {
     super(e, "INITIALIZATION_TIMEOUT", s), this.timeoutMs = t;
   }
@@ -164,12 +164,12 @@ const nt = "background: #ff9800; color: white; font-weight: bold; padding: 2px 8
   const { error: s, data: n, showToClient: i = !1, style: o, visibility: l } = t ?? {}, d = s ? kt(e, s) : `[TraceLog] ${e}`, c = r === "error" ? "error" : r === "warn" ? "warn" : "log";
   if (!Ut(l, i))
     return;
-  const g = Ft(l, o), m = n !== void 0 ? _e(n) : void 0;
-  Ht(c, d, g, m);
-}, Ut = (r, e) => r === "critical" ? !0 : r === "qa" || e ? Vt() : !1, Ft = (r, e) => e !== void 0 && e !== "" ? e : r === "critical" ? Dt : "", Ht = (r, e, t, s) => {
+  const m = Ht(l, o), g = n !== void 0 ? Ie(n) : void 0;
+  Ft(c, d, m, g);
+}, Ut = (r, e) => r === "critical" ? !0 : r === "qa" || e ? Vt() : !1, Ht = (r, e) => e !== void 0 && e !== "" ? e : r === "critical" ? Dt : "", Ft = (r, e, t, s) => {
   const n = t !== void 0 && t !== "", i = n ? `%c${e}` : e;
   s !== void 0 ? n ? console[r](i, t, s) : console[r](i, s) : n ? console[r](i, t) : console[r](i);
-}, _e = (r) => {
+}, Ie = (r) => {
   const e = {}, t = ["token", "password", "secret", "key", "apikey", "api_key", "sessionid", "session_id"];
   for (const [s, n] of Object.entries(r)) {
     const i = s.toLowerCase();
@@ -177,15 +177,15 @@ const nt = "background: #ff9800; color: white; font-weight: bold; padding: 2px 8
       e[s] = "[REDACTED]";
       continue;
     }
-    n !== null && typeof n == "object" && !Array.isArray(n) ? e[s] = _e(n) : Array.isArray(n) ? e[s] = n.map(
-      (o) => o !== null && typeof o == "object" && !Array.isArray(o) ? _e(o) : o
+    n !== null && typeof n == "object" && !Array.isArray(n) ? e[s] = Ie(n) : Array.isArray(n) ? e[s] = n.map(
+      (o) => o !== null && typeof o == "object" && !Array.isArray(o) ? Ie(o) : o
     ) : e[s] = n;
   }
   return e;
 };
-let ve, ot;
+let _e, ot;
 const xt = () => {
-  typeof window < "u" && !ve && (ve = window.matchMedia("(pointer: coarse)"), ot = window.matchMedia("(hover: none)"));
+  typeof window < "u" && !_e && (_e = window.matchMedia("(pointer: coarse)"), ot = window.matchMedia("(hover: none)"));
 }, oe = "Unknown", $t = (r) => {
   const e = r.userAgentData?.platform;
   if (e != null && e !== "") {
@@ -217,7 +217,7 @@ const xt = () => {
       return d != null && d !== "" && /ipad|tablet/i.test(d) ? A.Tablet : r.userAgentData.mobile ? A.Mobile : A.Desktop;
     }
     xt();
-    const e = window.innerWidth, t = ve?.matches ?? !1, s = ot?.matches ?? !1, n = "ontouchstart" in window || navigator.maxTouchPoints > 0, i = navigator.userAgent.toLowerCase(), o = /mobile|android|iphone|ipod|blackberry|iemobile|opera mini/.test(i), l = /tablet|ipad|android(?!.*mobile)/.test(i);
+    const e = window.innerWidth, t = _e?.matches ?? !1, s = ot?.matches ?? !1, n = "ontouchstart" in window || navigator.maxTouchPoints > 0, i = navigator.userAgent.toLowerCase(), o = /mobile|android|iphone|ipod|blackberry|iemobile|opera mini/.test(i), l = /tablet|ipad|android(?!.*mobile)/.test(i);
     return e <= 767 || o && n ? A.Mobile : e >= 768 && e <= 1024 || l || t && s && n ? A.Tablet : A.Desktop;
   } catch (r) {
     return a("debug", "Device detection failed, defaulting to desktop", { error: r }), A.Desktop;
@@ -254,7 +254,7 @@ const xt = () => {
   /:\/\/[^:/]+:([^@]+)@/gi,
   // Sensitive URL query parameters (token=, password=, auth=, secret=, api_key=, etc.)
   /[?&](token|password|passwd|auth|secret|secret_key|private_key|auth_key|api_key|apikey|access_token)=[^&\s]+/gi
-], Ge = 500, Xe = 2e3, je = 5e3, ee = 50, Xt = ee * 2, lt = 1, jt = 1e3, Kt = 10, Ke = 5e3, zt = 6e4, Qt = 64, br = {
+], Ge = 500, Xe = 2e3, je = 5e3, ee = 50, Xt = ee * 2, lt = 1, jt = 1e3, Kt = 10, Ke = 5e3, Qt = 6e4, zt = 64, Ar = {
   LCP: 2500,
   // Good: ≤ 2.5s
   FCP: 1800,
@@ -266,7 +266,7 @@ const xt = () => {
   TTFB: 800,
   // Good: ≤ 800ms
   LONG_TASK: 50
-}, ze = {
+}, Qe = {
   LCP: 2500,
   // Needs improvement: > 2.5s (same as good boundary)
   FCP: 1800,
@@ -290,17 +290,17 @@ const xt = () => {
   TTFB: 1800,
   // Poor: > 1800ms
   LONG_TASK: 50
-}, ye = "needs-improvement", Qe = (r = ye) => {
+}, ye = "needs-improvement", ze = (r = ye) => {
   switch (r) {
     case "all":
       return { LCP: 0, FCP: 0, CLS: 0, INP: 0, TTFB: 0, LONG_TASK: 0 };
     // Track everything
     case "needs-improvement":
-      return ze;
+      return Qe;
     case "poor":
       return Yt;
     default:
-      return ze;
+      return Qe;
   }
 }, qt = 1e3, Jt = 50, Zt = "2.9.0", es = Zt, ct = () => typeof window < "u" && typeof sessionStorage < "u", ts = () => {
   try {
@@ -319,10 +319,10 @@ const xt = () => {
     return e === Ue ? (s = !0, sessionStorage.setItem(G, "true"), a("info", "QA Mode ACTIVE", {
       visibility: "qa",
       style: nt
-    })) : e === Fe && (s = !1, sessionStorage.setItem(G, "false"), a("info", "QA Mode DISABLED", {
+    })) : e === He && (s = !1, sessionStorage.setItem(G, "false"), a("info", "QA Mode DISABLED", {
       visibility: "qa",
       style: it
-    })), (e === Ue || e === Fe) && ts(), s ?? t === "true";
+    })), (e === Ue || e === He) && ts(), s ?? t === "true";
   } catch {
     return !1;
   }
@@ -537,6 +537,16 @@ const os = () => {
       throw new p(S.INVALID_MAX_SAME_EVENT_PER_MINUTE, "config");
     if (r.sendIntervalMs !== void 0 && (!Number.isFinite(r.sendIntervalMs) || r.sendIntervalMs < 1e3 || r.sendIntervalMs > 6e4))
       throw new p(S.INVALID_SEND_INTERVAL, "config");
+    if (r.flushOnSpaNavigation !== void 0 && typeof r.flushOnSpaNavigation != "boolean")
+      throw new p(
+        `Invalid flushOnSpaNavigation type: ${typeof r.flushOnSpaNavigation}. Must be a boolean`,
+        "config"
+      );
+    if (r.flushOnPageHidden !== void 0 && typeof r.flushOnPageHidden != "boolean")
+      throw new p(
+        `Invalid flushOnPageHidden type: ${typeof r.flushOnPageHidden}. Must be a boolean`,
+        "config"
+      );
     if (r.viewport !== void 0 && us(r.viewport), r.webVitalsMode !== void 0) {
       if (typeof r.webVitalsMode != "string")
         throw new p(
@@ -633,7 +643,9 @@ const os = () => {
     pageViewThrottleMs: r?.pageViewThrottleMs ?? 1e3,
     clickThrottleMs: r?.clickThrottleMs ?? 300,
     maxSameEventPerMinute: r?.maxSameEventPerMinute ?? 60,
-    sendIntervalMs: r?.sendIntervalMs ?? 1e4
+    sendIntervalMs: r?.sendIntervalMs ?? 1e4,
+    flushOnSpaNavigation: r?.flushOnSpaNavigation ?? !0,
+    flushOnPageHidden: r?.flushOnPageHidden ?? !0
   };
   return e.integrations?.custom && (e.integrations.custom = {
     ...e.integrations.custom,
@@ -909,7 +921,7 @@ function gt(r, e, t) {
   }
 }
 const Ee = { config: {} };
-class v {
+class _ {
   /**
    * Retrieves a value from global state.
    *
@@ -967,7 +979,7 @@ class v {
     return { ...Ee };
   }
 }
-class Ze extends v {
+class Ze extends _ {
   storeManager;
   integrationId;
   apiUrl;
@@ -1524,7 +1536,7 @@ class Ze extends v {
           }
         ), this.consecutiveNetworkFailures = 0, this.circuitOpenedAt = 0, !0) : !1;
       } catch (f) {
-        const g = c === 3;
+        const m = c === 3;
         if (f instanceof O)
           throw this.consecutiveNetworkFailures = 0, this.circuitOpenedAt = 0, f;
         if (f instanceof re) {
@@ -1534,8 +1546,8 @@ class Ze extends v {
           break;
         }
         if (f instanceof ne || (l = !1), f instanceof TypeError || (d = !0), a(
-          g ? "error" : "warn",
-          `Send attempt ${c} failed${this.integrationId ? ` [${this.integrationId}]` : ""}${g ? " (all retries exhausted)" : ", will retry"}`,
+          m ? "error" : "warn",
+          `Send attempt ${c} failed${this.integrationId ? ` [${this.integrationId}]` : ""}${m ? " (all retries exhausted)" : ", will retry"}`,
           {
             error: f,
             data: {
@@ -1545,7 +1557,7 @@ class Ze extends v {
               maxAttempts: 3
             }
           }
-        ), !g) {
+        ), !m) {
           await this.backoffDelay(c);
           continue;
         }
@@ -1633,7 +1645,7 @@ class Ze extends v {
   async readTraceLogErrorCode(e) {
     try {
       const t = await e.clone().json();
-      if (typeof t.code == "string" && t.code.length > 0 && t.code.length <= Qt)
+      if (typeof t.code == "string" && t.code.length > 0 && t.code.length <= zt)
         return t.code;
     } catch {
     }
@@ -1894,12 +1906,12 @@ class Ze extends v {
   }
   logPermanentError(e, t) {
     const s = Date.now(), n = `${t.statusCode ?? "unknown"}:${t.responseCode ?? ""}`;
-    (!this.lastPermanentErrorLog || this.lastPermanentErrorLog.key !== n || s - this.lastPermanentErrorLog.timestamp >= zt) && (a("error", `${e}${this.integrationId ? ` [${this.integrationId}]` : ""}`, {
+    (!this.lastPermanentErrorLog || this.lastPermanentErrorLog.key !== n || s - this.lastPermanentErrorLog.timestamp >= Qt) && (a("error", `${e}${this.integrationId ? ` [${this.integrationId}]` : ""}`, {
       data: { status: t.statusCode, code: t.responseCode, message: t.message }
     }), this.lastPermanentErrorLog = { key: n, timestamp: s });
   }
 }
-class Ts extends v {
+class Ts extends _ {
   bootTime;
   bootTimestamp;
   hasPerformanceNow;
@@ -2048,8 +2060,8 @@ class Ts extends v {
     };
   }
 }
-const Is = new Set(Object.values(u));
-class _s extends v {
+const vs = new Set(Object.values(u));
+class Is extends _ {
   dataSenders;
   emitter;
   transformers;
@@ -2064,6 +2076,9 @@ class _s extends v {
   rateLimitCounter = 0;
   rateLimitWindowStart = 0;
   lastSessionId = null;
+  // Set when a sync flush is requested mid-async-send; drained by the async
+  // finally block. See `drainPendingSyncFlush` for the full rationale.
+  pendingSyncFlush = !1;
   sessionEventCounts = {
     total: 0,
     [u.CLICK]: 0,
@@ -2219,14 +2234,14 @@ class _s extends v {
       a("error", "Event type is required - event will be ignored");
       return;
     }
-    if (!Is.has(e)) {
+    if (!vs.has(e)) {
       a("error", "Invalid event type - event will be ignored", {
         data: { type: e }
       });
       return;
     }
-    const g = this.get("sessionId");
-    if (!g) {
+    const m = this.get("sessionId");
+    if (!m) {
       this.pendingEventsBuffer.length >= 100 && (this.pendingEventsBuffer.shift(), a("debug", "Pending events buffer full - dropping oldest event", {
         data: { maxBufferSize: 100 }
       })), this.pendingEventsBuffer.push({
@@ -2243,14 +2258,14 @@ class _s extends v {
       });
       return;
     }
-    this.lastSessionId !== g && (this.lastSessionId = g, this.sessionEventCounts = this.loadSessionCounts(g));
-    const m = e === u.SESSION_START;
-    if (m && a("debug", "Processing SESSION_START event", {
-      data: { sessionId: g }
-    }), !m && !this.checkRateLimit())
+    this.lastSessionId !== m && (this.lastSessionId = m, this.sessionEventCounts = this.loadSessionCounts(m));
+    const g = e === u.SESSION_START;
+    if (g && a("debug", "Processing SESSION_START event", {
+      data: { sessionId: m }
+    }), !g && !this.checkRateLimit())
       return;
     const E = e;
-    if (!m) {
+    if (!g) {
       if (this.sessionEventCounts.total >= 1e3) {
         a("warn", "Session event limit reached", {
           data: {
@@ -2261,15 +2276,15 @@ class _s extends v {
         });
         return;
       }
-      const T = this.getTypeLimitForEvent(E);
-      if (T) {
+      const v = this.getTypeLimitForEvent(E);
+      if (v) {
         const fe = this.sessionEventCounts[E];
-        if (fe !== void 0 && fe >= T) {
+        if (fe !== void 0 && fe >= v) {
           a("warn", "Session event type limit reached", {
             data: {
               type: E,
               count: fe,
-              limit: T
+              limit: v
             }
           });
           return;
@@ -2277,13 +2292,13 @@ class _s extends v {
       }
     }
     if (E === u.CUSTOM && o?.name) {
-      const T = this.get("config")?.maxSameEventPerMinute ?? 60;
-      if (!this.checkPerEventRateLimit(o.name, T))
+      const v = this.get("config")?.maxSameEventPerMinute ?? 60;
+      if (!this.checkPerEventRateLimit(o.name, v))
         return;
     }
-    const he = E === u.SESSION_START, Q = t || this.get("pageUrl"), U = this.buildEventPayload({
+    const he = E === u.SESSION_START, z = t || this.get("pageUrl"), U = this.buildEventPayload({
       type: E,
-      page_url: Q,
+      page_url: z,
       from_page_url: s,
       scroll_data: n,
       click_data: i,
@@ -2293,16 +2308,16 @@ class _s extends v {
       viewport_data: c,
       page_view: f
     });
-    if (U && !(!m && !this.shouldSample())) {
+    if (U && !(!g && !this.shouldSample())) {
       if (he) {
-        const T = this.get("sessionId");
-        if (!T) {
+        const v = this.get("sessionId");
+        if (!v) {
           a("error", "Session start event requires sessionId - event will be ignored");
           return;
         }
         if (this.get("hasStartSession")) {
           a("debug", "Duplicate session_start detected", {
-            data: { sessionId: T }
+            data: { sessionId: v }
           });
           return;
         }
@@ -2321,8 +2336,8 @@ class _s extends v {
             return;
           }
           if (E === u.VIEWPORT_VISIBLE && c) {
-            const T = c.name || c.id || c.selector;
-            a("info", `Viewport Visible: ${T}`, {
+            const v = c.name || c.id || c.selector;
+            a("info", `Viewport Visible: ${v}`, {
               visibility: "qa",
               data: {
                 selector: c.selector,
@@ -2335,10 +2350,10 @@ class _s extends v {
             return;
           }
         }
-        if (this.addToQueue(U), !m) {
+        if (this.addToQueue(U), !g) {
           this.sessionEventCounts.total++, this.sessionEventCounts[E] !== void 0 && this.sessionEventCounts[E]++;
-          const T = this.get("sessionId");
-          T && this.saveSessionCountsDebounced && this.saveSessionCountsDebounced(T);
+          const v = this.get("sessionId");
+          v && this.saveSessionCountsDebounced && this.saveSessionCountsDebounced(v);
         }
       }
     }
@@ -2378,7 +2393,7 @@ class _s extends v {
    * @see src/managers/README.md (lines 5-75) for cleanup details
    */
   stop() {
-    this.clearSendTimeout(), this.sendInProgress = !1, this.consecutiveSendFailures = 0;
+    this.clearSendTimeout(), this.sendInProgress = !1, this.pendingSyncFlush = !1, this.consecutiveSendFailures = 0;
     const e = this.get("sessionId");
     e && this.saveSessionCounts(e), this.eventsQueue = [], this.pendingEventsBuffer = [], this.recentEventFingerprints.clear(), this.rateLimitCounter = 0, this.rateLimitWindowStart = 0, this.perEventRateLimits.clear(), this.sessionEventCounts = {
       total: 0,
@@ -2465,6 +2480,62 @@ class _s extends v {
   flushImmediatelySync() {
     return this.flushEvents(!0);
   }
+  /**
+   * Sends ONLY the most recently queued event via `navigator.sendBeacon()` in
+   * a dedicated single-event batch.
+   *
+   * **Purpose**: Guarantee delivery of an event that *must* survive an
+   * imminent page unload (purchase confirmation, signup completion, etc.),
+   * independent of the main queue's size or in-flight async send state.
+   *
+   * **Why a dedicated batch**: `flushImmediatelySync()` serialises the entire
+   * queue into one `sendBeacon` call. If the queue is heavy (>64KB) the
+   * beacon fails and the batch is persisted to `localStorage`, which is only
+   * recovered on the next `init()` — useless for one-shot conversion events
+   * where the user never returns.
+   *
+   * **Behaviour**:
+   * - Reads the last entry of `eventsQueue` (the just-tracked event).
+   * - Wraps it in its own `EventsQueue` and dispatches synchronously through
+   *   every `SenderManager` via `sendEventsQueueSync()`.
+   * - Leaves the main queue untouched; the same event will be re-delivered by
+   *   the next periodic / unload flush. Idempotency is the caller-side
+   *   contract: the backend MUST deduplicate by `event.id` (e.g. unique index
+   *   on the ingestion collection) — same guarantee the library already
+   *   relies on for the persisted-events recovery path.
+   *
+   * **Use it after** `track()` so the event is in the queue. Caller is
+   * responsible for verifying that `track()` actually queued the event
+   * (it can be dropped by rate limiting / sampling / `beforeSend`).
+   *
+   * **Standalone mode** (no senders configured): returns `false` without
+   * emitting. The subsequent main-queue drain (`flushImmediatelySync()`) is
+   * responsible for delivering the event to local listeners — emitting here
+   * too would surface the same event twice to a `tracelog.on('queue', ...)`
+   * subscriber.
+   *
+   * @returns `true` if at least one sender delivered the beacon successfully,
+   * `false` otherwise (including standalone mode — the drain handles it).
+   */
+  flushLastEventSync() {
+    if (this.dataSenders.length === 0)
+      return !1;
+    const e = this.eventsQueue[this.eventsQueue.length - 1];
+    if (!e)
+      return !1;
+    const { _session_id: t, ...s } = e;
+    if (!t)
+      return a("debug", "flushLastEventSync: last queued event missing _session_id, skipping"), !1;
+    const n = this.get("config")?.globalMetadata, i = this.get("identity"), o = {
+      user_id: this.get("userId"),
+      session_id: t,
+      device: this.get("device"),
+      events: [s],
+      ...n && { global_metadata: n },
+      ...i && { identify: i }
+    };
+    return this.dataSenders.map((d) => d.sendEventsQueueSync(o)).some(Boolean);
+  }
   /**
    * Sets the custom headers provider callback for the custom integration.
    * Only affects requests to custom backend (not TraceLog SaaS).
@@ -2654,7 +2725,7 @@ class _s extends v {
     }
     if (e && this.sendInProgress) {
       const s = t.reduce((n, i) => n + i.eventIds.length, 0);
-      return a("debug", "Sync flush skipped: async send already in-flight, trusting fetch to deliver", {
+      return this.pendingSyncFlush = !0, a("debug", "Sync flush deferred: async send in-flight, will retry on settle", {
         data: { eventCount: s }
       }), !0;
     }
@@ -2662,13 +2733,29 @@ class _s extends v {
       const s = t.map(({ batch: n, eventIds: i }) => this.sendBatchSync(n, i));
       return this.clearSendTimeout(), s.some(Boolean);
     }
-    return (async () => {
-      const s = await Promise.all(
-        t.map(async ({ batch: n, eventIds: i }) => this.sendBatchAsync(n, i))
-      );
-      return this.clearSendTimeout(), s.some(Boolean);
+    return this.sendInProgress = !0, (async () => {
+      try {
+        const s = await Promise.all(
+          t.map(async ({ batch: n, eventIds: i }) => this.sendBatchAsync(n, i))
+        );
+        return this.clearSendTimeout(), s.some(Boolean);
+      } finally {
+        this.sendInProgress = !1, this.drainPendingSyncFlush();
+      }
     })();
   }
+  /**
+   * Re-runs a sync flush that was deferred while an async send was in flight.
+   *
+   * Called from the `finally` blocks of `flushEvents(false)` and
+   * `sendEventsQueue()`. If `pendingSyncFlush` is set, clears the flag and
+   * invokes `flushImmediatelySync()` synchronously so any events that arrived
+   * after the deferred sync call are delivered before the next event loop
+   * tick. Critical for high-stakes events tracked mid-async-send.
+   */
+  drainPendingSyncFlush() {
+    this.pendingSyncFlush && (this.pendingSyncFlush = !1, this.flushImmediatelySync());
+  }
   /**
    * Sends one batch synchronously across all integrations (sendBeacon path).
    * Optimistic removal: if any integration succeeds, we remove the batch's
@@ -2719,7 +2806,7 @@ class _s extends v {
           e.map(async ({ batch: n, eventIds: i }) => this.sendBatchAsync(n, i))
         )).some(Boolean) ? this.consecutiveSendFailures = 0 : this.consecutiveSendFailures = Math.min(this.consecutiveSendFailures + 1, 5), this.eventsQueue.length === 0 ? this.clearSendTimeout() : this.scheduleSendTimeout();
       } finally {
-        this.sendInProgress = !1;
+        this.sendInProgress = !1, this.drainPendingSyncFlush();
       }
     }
   }
@@ -2744,11 +2831,11 @@ class _s extends v {
    */
   buildBatchFromGroup(e, t) {
     const s = /* @__PURE__ */ new Map(), n = [];
-    for (const m of t) {
-      const E = this.createEventSignature(m);
-      s.has(E) || n.push(E), s.set(E, m);
+    for (const g of t) {
+      const E = this.createEventSignature(g);
+      s.has(E) || n.push(E), s.set(E, g);
     }
-    const i = n.map((m) => s.get(m)).filter((m) => !!m).sort((m, E) => m.type === u.SESSION_START && E.type !== u.SESSION_START ? -1 : E.type === u.SESSION_START && m.type !== u.SESSION_START ? 1 : m.timestamp - E.timestamp).map(({ _session_id: m, ...E }) => E), o = this.get("config")?.globalMetadata, l = this.get("identity");
+    const i = n.map((g) => s.get(g)).filter((g) => !!g).sort((g, E) => g.type === u.SESSION_START && E.type !== u.SESSION_START ? -1 : E.type === u.SESSION_START && g.type !== u.SESSION_START ? 1 : g.timestamp - E.timestamp).map(({ _session_id: g, ...E }) => E), o = this.get("config")?.globalMetadata, l = this.get("identity");
     let d = {
       user_id: this.get("userId"),
       session_id: e,
@@ -2757,10 +2844,10 @@ class _s extends v {
       ...o && { global_metadata: o },
       ...l && { identify: l }
     };
-    const c = this.get("collectApiUrls"), f = !!(c?.custom || c?.saas), g = this.transformers.beforeBatch;
-    if (!f && g) {
-      const m = gt(d, g, "EventManager");
-      m !== null && (d = m);
+    const c = this.get("collectApiUrls"), f = !!(c?.custom || c?.saas), m = this.transformers.beforeBatch;
+    if (!f && m) {
+      const g = gt(d, m, "EventManager");
+      g !== null && (d = g);
     }
     return d;
   }
@@ -2792,12 +2879,12 @@ class _s extends v {
       ...e.page_view && { page_view: e.page_view },
       ...d && { utm: d }
     };
-    const f = this.get("collectApiUrls"), g = !!f?.custom, m = !!f?.saas, E = g || m, he = g && m, Q = this.transformers.beforeSend;
-    if (Q && (!E || g && !he)) {
-      const T = mt(c, Q, "EventManager");
-      if (T === null)
+    const f = this.get("collectApiUrls"), m = !!f?.custom, g = !!f?.saas, E = m || g, he = m && g, z = this.transformers.beforeSend;
+    if (z && (!E || m && !he)) {
+      const v = mt(c, z, "EventManager");
+      if (v === null)
         return null;
-      c = T;
+      c = v;
     }
     return { ...c, _session_id: t };
   }
@@ -2974,7 +3061,7 @@ class _s extends v {
   loadSessionCounts(e) {
     if (typeof window > "u" || typeof localStorage > "u")
       return this.getInitialCounts();
-    const t = this.get("userId") || "anonymous", s = He(t, e);
+    const t = this.get("userId") || "anonymous", s = Fe(t, e);
     try {
       const n = localStorage.getItem(s);
       if (!n)
@@ -3084,7 +3171,7 @@ class _s extends v {
    * @internal
    */
   saveSessionCounts(e) {
-    const t = this.get("userId") || "anonymous", s = He(t, e);
+    const t = this.get("userId") || "anonymous", s = Fe(t, e);
     try {
       const n = {
         ...this.sessionEventCounts,
@@ -3100,7 +3187,7 @@ class _s extends v {
     }
   }
 }
-class vs {
+class _s {
   /**
    * Gets or creates a unique user ID.
    *
@@ -3118,15 +3205,15 @@ class vs {
    * @returns Persistent unique user ID (UUID v4 format)
    */
   static getId(e) {
-    const t = e.getItem(Ie);
+    const t = e.getItem(ve);
     if (t)
       return t;
     const s = dt();
-    return e.setItem(Ie, s), s;
+    return e.setItem(ve, s), s;
   }
 }
 const ys = /^\d{13}-[a-z0-9]{9}$/;
-class ws extends v {
+class ws extends _ {
   storageManager;
   eventManager;
   projectId;
@@ -3457,7 +3544,7 @@ class ws extends v {
     this.clearSessionTimeout(), this.cleanupActivityListeners(), this.cleanupCrossTabSync(), this.cleanupLifecycleListeners(), this.isTracking = !1, this.needsRenewal = !1, this.set("hasStartSession", !1);
   }
 }
-class bs extends v {
+class bs extends _ {
   eventManager;
   storageManager;
   sessionManager = null;
@@ -3545,7 +3632,7 @@ class bs extends v {
     this.destroyed || (this.sessionManager && (this.sessionManager.destroy(), this.sessionManager = null), this.destroyed = !0);
   }
 }
-class Ls extends v {
+class Ls extends _ {
   eventManager;
   onTrack;
   originalPushState;
@@ -3600,7 +3687,7 @@ class Ls extends v {
       page_url: this.get("pageUrl"),
       from_page_url: i,
       ...o && { page_view: o }
-    });
+    }), this.get("config").flushOnSpaNavigation !== !1 && this.eventManager.flushImmediately();
   };
   trackInitialPageView() {
     const e = we(window.location.href, this.get("config").sensitiveQueryParams), t = this.extractPageViewData();
@@ -3621,7 +3708,7 @@ class Ls extends v {
     };
   }
 }
-class As extends v {
+class As extends _ {
   eventManager;
   lastClickTimes = /* @__PURE__ */ new Map();
   clickHandler;
@@ -3658,12 +3745,12 @@ class As extends v {
       if (o) {
         const f = this.extractTrackingData(o);
         if (f) {
-          const g = this.createCustomEventData(f);
+          const m = this.createCustomEventData(f);
           this.eventManager.track({
             type: u.CUSTOM,
             custom_event: {
-              name: g.name,
-              ...g.value && { metadata: { value: g.value } }
+              name: m.name,
+              ...m.value && { metadata: { value: m.value } }
             }
           });
         }
@@ -3885,7 +3972,7 @@ class As extends v {
     };
   }
 }
-class Ms extends v {
+class Ms extends _ {
   eventManager;
   containers = [];
   limitWarningLogged = !1;
@@ -4069,12 +4156,12 @@ class Ms extends v {
     const { element: t, lastScrollPos: s, lastEventTime: n } = e, i = this.getScrollTop(t), o = Date.now(), l = Math.abs(i - s);
     if (l < 10 || t === window && !this.isWindowScrollable())
       return null;
-    const d = this.getViewportHeight(t), c = this.getScrollHeight(t), f = this.getScrollDirection(i, s), g = this.calculateScrollDepth(i, c, d);
-    let m;
-    n > 0 ? m = o - n : e.firstScrollEventTime !== null ? m = o - e.firstScrollEventTime : m = 250;
-    const E = Math.round(l / m * 1e3);
-    return g > e.maxDepthReached && (e.maxDepthReached = g), e.lastScrollPos = i, {
-      depth: g,
+    const d = this.getViewportHeight(t), c = this.getScrollHeight(t), f = this.getScrollDirection(i, s), m = this.calculateScrollDepth(i, c, d);
+    let g;
+    n > 0 ? g = o - n : e.firstScrollEventTime !== null ? g = o - e.firstScrollEventTime : g = 250;
+    const E = Math.round(l / g * 1e3);
+    return m > e.maxDepthReached && (e.maxDepthReached = m), e.lastScrollPos = i, {
+      depth: m,
       direction: f,
       velocity: E,
       max_depth_reached: e.maxDepthReached
@@ -4113,7 +4200,7 @@ class Ms extends v {
     e.isPrimary = t;
   }
 }
-class Cs extends v {
+class Cs extends _ {
   eventManager;
   trackedElements = /* @__PURE__ */ new Map();
   observer = null;
@@ -4275,7 +4362,7 @@ class Cs extends v {
   }
 }
 const Rs = "tracelog_session_id", Ns = "tracelog_user_id";
-class Os extends v {
+class Os extends _ {
   visibilityHandler = null;
   pageshowHandler = null;
   lastSyncedKey = null;
@@ -4617,7 +4704,7 @@ class Ps {
     this.fallbackSessionStorage.delete(e);
   }
 }
-class Ds extends v {
+class Ds extends _ {
   eventManager;
   reportedByNav = /* @__PURE__ */ new Map();
   navigationHistory = [];
@@ -4628,7 +4715,7 @@ class Ds extends v {
   navigationCounter = 0;
   // Counter for handling simultaneous navigations edge case
   constructor(e) {
-    super(), this.eventManager = e, this.vitalThresholds = Qe(ye);
+    super(), this.eventManager = e, this.vitalThresholds = ze(ye);
   }
   /**
    * Starts tracking Web Vitals and performance metrics.
@@ -4646,7 +4733,7 @@ class Ds extends v {
    */
   async startTracking() {
     const e = this.get("config"), t = e?.webVitalsMode ?? ye;
-    this.vitalThresholds = Qe(t), e?.webVitalsThresholds && (this.vitalThresholds = { ...this.vitalThresholds, ...e.webVitalsThresholds }), await this.initWebVitals(), this.observeLongTasks();
+    this.vitalThresholds = ze(t), e?.webVitalsThresholds && (this.vitalThresholds = { ...this.vitalThresholds, ...e.webVitalsThresholds }), await this.initWebVitals(), this.observeLongTasks();
   }
   /**
    * Stops tracking Web Vitals and cleans up resources.
@@ -4716,7 +4803,7 @@ class Ds extends v {
   }
   async initWebVitals() {
     try {
-      const { onLCP: e, onCLS: t, onFCP: s, onTTFB: n, onINP: i } = await Promise.resolve().then(() => hr), o = (l) => (d) => {
+      const { onLCP: e, onCLS: t, onFCP: s, onTTFB: n, onINP: i } = await Promise.resolve().then(() => mr), o = (l) => (d) => {
         const c = Number(d.value.toFixed(2));
         this.sendVital({ type: l, value: c });
       };
@@ -4850,7 +4937,7 @@ class Ds extends v {
     return !(typeof s == "number" && t <= s);
   }
 }
-class ae extends v {
+class ae extends _ {
   eventManager;
   recentErrors = /* @__PURE__ */ new Map();
   errorBurstCounter = 0;
@@ -4902,12 +4989,13 @@ class ae extends v {
     const t = this.sanitize(e.message || "Unknown error");
     if (this.shouldSuppressError(B.JS_ERROR, t))
       return;
-    const s = typeof e.error?.stack == "string" ? this.truncateStack(e.error.stack) : void 0;
+    const s = typeof e.error?.stack == "string" ? this.truncateStack(e.error.stack) : void 0, n = typeof e.error?.name == "string" && e.error.name !== "Error" ? e.error.name : void 0;
     this.eventManager.track({
       type: u.ERROR,
       error_data: {
         type: B.JS_ERROR,
         message: t,
+        ...n !== void 0 && { name: n },
         ...e.filename !== "" && { filename: e.filename },
         ...e.lineno !== 0 && { line: e.lineno },
         ...e.colno !== 0 && { column: e.colno },
@@ -4921,12 +5009,13 @@ class ae extends v {
     const t = this.extractRejectionMessage(e.reason), s = this.sanitize(t);
     if (this.shouldSuppressError(B.PROMISE_REJECTION, s))
       return;
-    const n = e.reason instanceof Error && typeof e.reason.stack == "string" ? this.truncateStack(e.reason.stack) : void 0;
+    const n = e.reason instanceof Error && typeof e.reason.stack == "string" ? this.truncateStack(e.reason.stack) : void 0, i = e.reason instanceof Error && e.reason.name !== "Error" ? e.reason.name : void 0;
     this.eventManager.track({
       type: u.ERROR,
       error_data: {
         type: B.PROMISE_REJECTION,
         message: s,
+        ...i !== void 0 && { name: i },
         ...n !== void 0 && { stack: n }
       }
     });
@@ -4980,10 +5069,12 @@ class ae extends v {
     }
   }
 }
-class ks extends v {
+class ks extends _ {
   isInitialized = !1;
   suppressNextScrollTimer = null;
   pageUnloadHandler = null;
+  pageShowHandler = null;
+  visibilityFlushHandler = null;
   emitter = new Es();
   transformers = {};
   customHeadersProvider;
@@ -5007,7 +5098,7 @@ class ks extends v {
     try {
       this.setupState(e);
       const t = e.integrations?.custom?.headers ?? {}, s = e.integrations?.custom?.fetchCredentials ?? "include";
-      return this.managers.event = new _s(
+      return this.managers.event = new Is(
         this.managers.storage,
         this.emitter,
         this.transformers,
@@ -5024,33 +5115,74 @@ class ks extends v {
     }
   }
   /**
-   * Sends a custom event with optional metadata.
+   * Asynchronously flushes all pending events in the queue.
+   *
+   * Internally calls `EventManager.flushImmediately()` which uses `fetch()` with retries.
+   * Use when you need to force-send buffered events without waiting for the next send interval
+   * (e.g., before a critical user action like sign-out, or before a SPA route teardown).
+   *
+   * @returns Promise<boolean> — `true` if all integrations sent successfully, `false` otherwise
+   * @internal Called from api.flushImmediately()
+   */
+  async flushImmediately() {
+    return await this.managers.event?.flushImmediately() ?? !1;
+  }
+  /**
+   * Synchronously flushes all pending events using `navigator.sendBeacon()`.
+   *
+   * Use only for page-unload scenarios (or equivalent) where async fetch may be cancelled.
+   * For general flush needs, prefer {@link flushImmediately}.
+   *
+   * @returns `true` if all integrations sent successfully, `false` otherwise
+   * @internal Called from api.flushImmediatelySync()
+   */
+  flushImmediatelySync() {
+    return this.managers.event?.flushImmediatelySync() ?? !1;
+  }
+  /**
+   * Sends a custom event with optional metadata and options.
    *
    * @param name - Event name
    * @param metadata - Optional metadata
+   * @param options - Optional event options. `{ critical: true }` triggers the
+   *   double-write delivery path: (1) the just-tracked event is sent in its
+   *   own dedicated single-event `sendBeacon` (immune to the 64KB queue cap),
+   *   and (2) the main queue is drained too — deferred to the in-flight
+   *   async send's `finally` block when one is running, so events tracked
+   *   immediately before the critical one are not stranded. Backend must
+   *   deduplicate by `event.id` since both paths may deliver the same event.
+   *   No-op for events dropped by rate limiting / sampling / `beforeSend`.
    * @internal Called from api.event()
    */
-  sendCustomEvent(e, t) {
+  sendCustomEvent(e, t, s) {
     if (!this.managers.event) {
       a("warn", "Cannot send custom event: TraceLog not initialized", { data: { name: e } });
       return;
     }
-    let s = t;
-    t && typeof t == "object" && !Array.isArray(t) && Object.getPrototypeOf(t) !== Object.prototype && (s = Object.assign({}, t));
-    const { valid: n, error: i, sanitizedMetadata: o } = ps(e, s);
-    if (!n) {
+    let n = t;
+    t && typeof t == "object" && !Array.isArray(t) && Object.getPrototypeOf(t) !== Object.prototype && (n = Object.assign({}, t));
+    const { valid: i, error: o, sanitizedMetadata: l } = ps(e, n);
+    if (!i) {
       if (this.get("mode") === ie.QA)
-        throw new Error(`[TraceLog] Custom event "${e}" validation failed: ${i}`);
-      a("warn", `Custom event "${e}" dropped: ${i}`);
+        throw new Error(`[TraceLog] Custom event "${e}" validation failed: ${o}`);
+      a("warn", `Custom event "${e}" dropped: ${o}`);
       return;
     }
-    this.managers.event.track({
+    const d = this.managers.event.getQueueLength();
+    if (this.managers.event.track({
       type: u.CUSTOM,
       custom_event: {
         name: e,
-        ...o && { metadata: o }
+        ...l && { metadata: l }
       }
-    });
+    }), s?.critical === !0) {
+      if (!(this.managers.event.getQueueLength() > d)) {
+        a("debug", "Critical event was dropped before queueing — no flush triggered", { data: { name: e } });
+        return;
+      }
+      const f = this.managers.event.flushLastEventSync(), m = this.managers.event.flushImmediatelySync();
+      !f && !m && a("debug", "Critical event: dedicated beacon and queue drain both failed", { data: { name: e } });
+    }
   }
   on(e, t) {
     this.emitter.on(e, t);
@@ -5103,11 +5235,11 @@ class ks extends v {
       } catch (s) {
         a("warn", "Failed to stop tracking", { error: s });
       }
-    }), this.suppressNextScrollTimer && (clearTimeout(this.suppressNextScrollTimer), this.suppressNextScrollTimer = null), this.pageUnloadHandler && (window.removeEventListener("pagehide", this.pageUnloadHandler), window.removeEventListener("beforeunload", this.pageUnloadHandler), this.pageUnloadHandler = null), this.managers.event?.flushImmediatelySync(), this.managers.event?.stop(), this.emitter.removeAllListeners(), this.transformers.beforeSend = void 0, this.transformers.beforeBatch = void 0, this.customHeadersProvider = void 0, this.set("suppressNextScroll", !1), this.set("sessionId", null), this.set("identity", void 0), this.clearPersistedIdentity(), this.integrationInstances.shopifyCartLinker?.deactivate(), this.integrationInstances = {}, this.isInitialized = !1, this.handlers = {}, this.managers = {});
+    }), this.suppressNextScrollTimer && (clearTimeout(this.suppressNextScrollTimer), this.suppressNextScrollTimer = null), this.pageUnloadHandler && (window.removeEventListener("pagehide", this.pageUnloadHandler), window.removeEventListener("beforeunload", this.pageUnloadHandler), this.pageUnloadHandler = null), this.pageShowHandler && (window.removeEventListener("pageshow", this.pageShowHandler), this.pageShowHandler = null), this.visibilityFlushHandler && (document.removeEventListener("visibilitychange", this.visibilityFlushHandler), this.visibilityFlushHandler = null), this.managers.event?.flushImmediatelySync(), this.managers.event?.stop(), this.emitter.removeAllListeners(), this.transformers.beforeSend = void 0, this.transformers.beforeBatch = void 0, this.customHeadersProvider = void 0, this.set("suppressNextScroll", !1), this.set("sessionId", null), this.set("identity", void 0), this.clearPersistedIdentity(), this.integrationInstances.shopifyCartLinker?.deactivate(), this.integrationInstances = {}, this.isInitialized = !1, this.handlers = {}, this.managers = {});
   }
   setupState(e = {}) {
     this.set("config", e);
-    const t = vs.getId(this.managers.storage);
+    const t = _s.getId(this.managers.storage);
     this.set("userId", t);
     const s = ls(e);
     this.set("collectApiUrls", s);
@@ -5252,7 +5384,7 @@ class ks extends v {
   async resetIdentity() {
     await this.managers.event?.flushImmediately(), this.set("identity", void 0), this.clearPersistedIdentity();
     const e = dt();
-    this.managers.storage.setItem(Ie, e), this.set("userId", e), this.set("hasStartSession", !1), this.set("sessionId", null), this.handlers.session?.stopTracking(), this.handlers.session?.startTracking(), a("debug", "Identity reset, new UUID generated");
+    this.managers.storage.setItem(ve, e), this.set("userId", e), this.set("hasStartSession", !1), this.set("sessionId", null), this.handlers.session?.stopTracking(), this.handlers.session?.startTracking(), a("debug", "Identity reset, new UUID generated");
   }
   /**
    * Returns the project ID used for identity storage scoping.
@@ -5279,10 +5411,10 @@ class ks extends v {
   loadPersistedIdentity() {
     const e = this.managers.storage, t = this.getProjectId(), s = me(t);
     try {
-      const n = e.getItem(F);
+      const n = e.getItem(H);
       if (n) {
         const i = JSON.parse(n);
-        if (e.removeItem(F), !this.isValidIdentityData(i)) {
+        if (e.removeItem(H), !this.isValidIdentityData(i)) {
           a("debug", "Invalid pending identity in localStorage, discarded");
           return;
         }
@@ -5291,7 +5423,7 @@ class ks extends v {
         return;
       }
     } catch {
-      e.removeItem(F);
+      e.removeItem(H);
     }
     try {
       const n = e.getItem(s);
@@ -5329,7 +5461,7 @@ class ks extends v {
   clearPersistedIdentity() {
     try {
       const e = this.managers.storage, t = this.getProjectId();
-      e.removeItem(me(t)), e.removeItem(F);
+      e.removeItem(me(t)), e.removeItem(H);
     } catch {
       a("debug", "Failed to clear persisted identity");
     }
@@ -5337,7 +5469,13 @@ class ks extends v {
   setupPageLifecycleListeners() {
     this.pageUnloadHandler = () => {
       this.managers.event?.flushImmediatelySync();
-    }, window.addEventListener("pagehide", this.pageUnloadHandler), window.addEventListener("beforeunload", this.pageUnloadHandler);
+    }, this.pageShowHandler = (e) => {
+      e.persisted && this.managers.event?.recoverPersistedEvents().catch((t) => {
+        a("warn", "Failed to recover persisted events on bfcache restore", { error: t });
+      });
+    }, this.visibilityFlushHandler = () => {
+      typeof document > "u" || !document.hidden || this.get("config").flushOnPageHidden !== !1 && this.managers.event?.flushImmediatelySync();
+    }, window.addEventListener("pagehide", this.pageUnloadHandler), window.addEventListener("beforeunload", this.pageUnloadHandler), window.addEventListener("pageshow", this.pageShowHandler), document.addEventListener("visibilitychange", this.visibilityFlushHandler);
   }
   initializeHandlers() {
     const e = this.get("config");
@@ -5361,8 +5499,8 @@ class ks extends v {
   }
 }
 const k = [], M = [];
-let D = null, h = null, R = !1, _ = !1, P = null;
-const Vs = async (r) => typeof window > "u" || typeof document > "u" ? { sessionId: "" } : (_ = !1, window.__traceLogDisabled === !0 ? { sessionId: "" } : h ? { sessionId: h.getSessionId() ?? "" } : (R && P || (R = !0, P = (async () => {
+let D = null, h = null, R = !1, T = !1, P = null;
+const Vs = async (r) => typeof window > "u" || typeof document > "u" ? { sessionId: "" } : (T = !1, window.__traceLogDisabled === !0 ? { sessionId: "" } : h ? { sessionId: h.getSessionId() ?? "" } : (R && P || (R = !0, P = (async () => {
   try {
     const e = fs(r ?? {}), t = new ks();
     try {
@@ -5390,15 +5528,15 @@ const Vs = async (r) => typeof window > "u" || typeof document > "u" ? { session
   } finally {
     R = !1, P = null;
   }
-})()), P)), Us = (r, e) => {
+})()), P)), Us = (r, e, t) => {
   if (!(typeof window > "u" || typeof document > "u")) {
     if (!h)
       throw new Error("[TraceLog] TraceLog not initialized. Please call init() first.");
-    if (_)
+    if (T)
       throw new Error("[TraceLog] Cannot send events while TraceLog is being destroyed");
-    h.sendCustomEvent(r, e);
+    h.sendCustomEvent(r, e, t);
   }
-}, Fs = (r, e) => {
+}, Hs = async () => typeof window > "u" || typeof document > "u" || !h || T ? !1 : h.flushImmediately(), Fs = () => typeof window > "u" || typeof document > "u" || !h || T ? !1 : h.flushImmediatelySync(), xs = (r, e) => {
   if (!(typeof window > "u" || typeof document > "u")) {
     if (!h || R) {
       k.push({ event: r, callback: e });
@@ -5406,7 +5544,7 @@ const Vs = async (r) => typeof window > "u" || typeof document > "u" ? { session
     }
     h.on(r, e);
   }
-}, Hs = (r, e) => {
+}, $s = (r, e) => {
   if (!(typeof window > "u" || typeof document > "u")) {
     if (!h) {
       const t = k.findIndex((s) => s.event === r && s.callback === e);
@@ -5416,7 +5554,7 @@ const Vs = async (r) => typeof window > "u" || typeof document > "u" ? { session
     h.off(r, e);
   }
 };
-function xs(r, e) {
+function Bs(r, e) {
   if (!(typeof window > "u" || typeof document > "u")) {
     if (typeof e != "function")
       throw new Error(`[TraceLog] Transformer must be a function, received: ${typeof e}`);
@@ -5425,23 +5563,23 @@ function xs(r, e) {
       t !== -1 && M.splice(t, 1), M.push({ hook: r, fn: e });
       return;
     }
-    if (_)
+    if (T)
       throw new Error("[TraceLog] Cannot set transformers while TraceLog is being destroyed");
     r === "beforeSend" ? h.setTransformer("beforeSend", e) : h.setTransformer("beforeBatch", e);
   }
 }
-const $s = (r) => {
+const Ws = (r) => {
   if (!(typeof window > "u" || typeof document > "u")) {
     if (!h) {
       const e = M.findIndex((t) => t.hook === r);
       e !== -1 && M.splice(e, 1);
       return;
     }
-    if (_)
+    if (T)
       throw new Error("[TraceLog] Cannot remove transformers while TraceLog is being destroyed");
     h.removeTransformer(r);
   }
-}, Bs = (r) => {
+}, Gs = (r) => {
   if (!(typeof window > "u" || typeof document > "u")) {
     if (typeof r != "function")
       throw new Error(`[TraceLog] Custom headers provider must be a function, received: ${typeof r}`);
@@ -5449,54 +5587,54 @@ const $s = (r) => {
       D = r;
       return;
     }
-    if (_)
+    if (T)
       throw new Error("[TraceLog] Cannot set custom headers while TraceLog is being destroyed");
     h.setCustomHeaders(r);
   }
-}, Ws = () => {
+}, Xs = () => {
   if (!(typeof window > "u" || typeof document > "u")) {
     if (!h) {
       D = null;
       return;
     }
-    if (_)
+    if (T)
       throw new Error("[TraceLog] Cannot remove custom headers while TraceLog is being destroyed");
     h.removeCustomHeaders();
   }
-}, Gs = () => typeof window > "u" || typeof document > "u" ? !1 : h !== null, Xs = () => typeof window > "u" || typeof document > "u" || !h ? null : h.getSessionId(), js = () => {
+}, js = () => typeof window > "u" || typeof document > "u" ? !1 : h !== null, Ks = () => typeof window > "u" || typeof document > "u" || !h ? null : h.getSessionId(), Qs = () => {
   if (!(typeof window > "u" || typeof document > "u")) {
-    if (_)
+    if (T)
       throw new Error("[TraceLog] Destroy operation already in progress");
     if (!h) {
-      _ = !1;
+      T = !1;
       return;
     }
-    _ = !0;
+    T = !0;
     try {
-      h.destroy(), h = null, R = !1, P = null, k.length = 0, M.length = 0, D = null, _ = !1;
+      h.destroy(), h = null, R = !1, P = null, k.length = 0, M.length = 0, D = null, T = !1;
     } catch (r) {
-      h = null, R = !1, P = null, k.length = 0, M.length = 0, D = null, _ = !1, a("warn", "Error during destroy, forced cleanup completed", { error: r });
+      h = null, R = !1, P = null, k.length = 0, M.length = 0, D = null, T = !1, a("warn", "Error during destroy, forced cleanup completed", { error: r });
     }
   }
-}, Ks = (r) => {
-  typeof window > "u" || typeof document > "u" || rs(r);
 }, zs = (r) => {
+  typeof window > "u" || typeof document > "u" || rs(r);
+}, Ys = (r) => {
   if (!(typeof window > "u" || typeof document > "u")) {
     if (!h)
       throw new Error("[TraceLog] TraceLog not initialized. Please call init() first.");
-    if (_)
+    if (T)
       throw new Error("[TraceLog] Cannot update metadata while TraceLog is being destroyed");
     h.updateGlobalMetadata(r);
   }
-}, Qs = (r) => {
+}, qs = (r) => {
   if (!(typeof window > "u" || typeof document > "u")) {
     if (!h)
       throw new Error("[TraceLog] TraceLog not initialized. Please call init() first.");
-    if (_)
+    if (T)
       throw new Error("[TraceLog] Cannot update metadata while TraceLog is being destroyed");
     h.mergeGlobalMetadata(r);
   }
-}, Ys = (r, e) => {
+}, Js = (r, e) => {
   if (!(typeof window > "u" || typeof document > "u")) {
     if (!r || typeof r != "string" || r.trim().length === 0) {
       a("warn", "identify() called with invalid userId");
@@ -5506,7 +5644,7 @@ const $s = (r) => {
       a("warn", "identify() userId exceeds 256 characters");
       return;
     }
-    if (_) {
+    if (T) {
       a("warn", "Cannot identify while TraceLog is being destroyed");
       return;
     }
@@ -5519,41 +5657,43 @@ const $s = (r) => {
         userId: r.trim(),
         ...t ? { traits: t } : {}
       };
-      localStorage.setItem(F, JSON.stringify(s)), a("debug", "Identity persisted pre-init (will be applied on init)");
+      localStorage.setItem(H, JSON.stringify(s)), a("debug", "Identity persisted pre-init (will be applied on init)");
     } catch {
       a("debug", "Failed to persist pre-init identity");
     }
   }
-}, qs = async () => {
+}, Zs = async () => {
   if (!(typeof window > "u" || typeof document > "u")) {
     if (!h) {
       try {
-        localStorage.removeItem(F);
+        localStorage.removeItem(H);
       } catch {
       }
       return;
     }
-    if (_)
+    if (T)
       throw new Error("[TraceLog] Cannot reset identity while TraceLog is being destroyed");
     await h.resetIdentity();
   }
-}, Lr = {
+}, Mr = {
   init: Vs,
   event: Us,
-  on: Fs,
-  off: Hs,
-  setTransformer: xs,
-  removeTransformer: $s,
-  setCustomHeaders: Bs,
-  removeCustomHeaders: Ws,
-  isInitialized: Gs,
-  getSessionId: Xs,
-  destroy: js,
-  setQaMode: Ks,
-  updateGlobalMetadata: zs,
-  mergeGlobalMetadata: Qs,
-  identify: Ys,
-  resetIdentity: qs
+  on: xs,
+  off: $s,
+  setTransformer: Bs,
+  removeTransformer: Ws,
+  setCustomHeaders: Gs,
+  removeCustomHeaders: Xs,
+  isInitialized: js,
+  getSessionId: Ks,
+  destroy: Qs,
+  setQaMode: zs,
+  updateGlobalMetadata: Ys,
+  mergeGlobalMetadata: qs,
+  identify: Js,
+  resetIdentity: Zs,
+  flushImmediately: Hs,
+  flushImmediatelySync: Fs
 };
 var Ae, C, X, pt, le, Et = -1, V = function(r) {
   addEventListener("pageshow", (function(e) {
@@ -5602,28 +5742,28 @@ var Ae, C, X, pt, le, Et = -1, V = function(r) {
   return function() {
     e || (r(), e = !0);
   };
-}, H = -1, et = function() {
+}, F = -1, et = function() {
   return document.visibilityState !== "hidden" || document.prerendering ? 1 / 0 : 0;
 }, ce = function(r) {
-  document.visibilityState === "hidden" && H > -1 && (H = r.type === "visibilitychange" ? r.timeStamp : 0, Js());
+  document.visibilityState === "hidden" && F > -1 && (F = r.type === "visibilitychange" ? r.timeStamp : 0, er());
 }, tt = function() {
   addEventListener("visibilitychange", ce, !0), addEventListener("prerenderingchange", ce, !0);
-}, Js = function() {
+}, er = function() {
   removeEventListener("visibilitychange", ce, !0), removeEventListener("prerenderingchange", ce, !0);
 }, Ve = function() {
-  return H < 0 && (H = et(), tt(), V((function() {
+  return F < 0 && (F = et(), tt(), V((function() {
     setTimeout((function() {
-      H = et(), tt();
+      F = et(), tt();
     }), 0);
   }))), { get firstHiddenTime() {
-    return H;
+    return F;
   } };
-}, z = function(r) {
+}, Q = function(r) {
   document.prerendering ? addEventListener("prerenderingchange", (function() {
     return r();
   }), !0) : r();
 }, Me = [1800, 3e3], St = function(r, e) {
-  e = e || {}, z((function() {
+  e = e || {}, Q((function() {
     var t, s = Ve(), n = y("FCP"), i = x("paint", (function(o) {
       o.forEach((function(l) {
         l.name === "first-contentful-paint" && (i.disconnect(), l.startTime < s.firstHiddenTime && (n.value = Math.max(l.startTime - de(), 0), n.entries.push(l), t(!0)));
@@ -5635,13 +5775,13 @@ var Ae, C, X, pt, le, Et = -1, V = function(r) {
       }));
     })));
   }));
-}, Ce = [0.1, 0.25], Zs = function(r, e) {
+}, Ce = [0.1, 0.25], tr = function(r, e) {
   e = e || {}, St(ue((function() {
     var t, s = y("CLS", 0), n = 0, i = [], o = function(d) {
       d.forEach((function(c) {
         if (!c.hadRecentInput) {
-          var f = i[0], g = i[i.length - 1];
-          n && c.startTime - g.startTime < 1e3 && c.startTime - f.startTime < 5e3 ? (n += c.value, i.push(c)) : (n = c.value, i = [c]);
+          var f = i[0], m = i[i.length - 1];
+          n && c.startTime - m.startTime < 1e3 && c.startTime - f.startTime < 5e3 ? (n += c.value, i.push(c)) : (n = c.value, i = [c]);
         }
       })), n > s.value && (s.value = n, s.entries = i, t());
     }, l = x("layout-shift", o);
@@ -5653,19 +5793,19 @@ var Ae, C, X, pt, le, Et = -1, V = function(r) {
       }));
     })), setTimeout(t, 0));
   })));
-}, Tt = 0, Se = 1 / 0, J = 0, er = function(r) {
+}, Tt = 0, Se = 1 / 0, J = 0, sr = function(r) {
   r.forEach((function(e) {
     e.interactionId && (Se = Math.min(Se, e.interactionId), J = Math.max(J, e.interactionId), Tt = J ? (J - Se) / 7 + 1 : 0);
   }));
-}, It = function() {
+}, vt = function() {
   return Ae ? Tt : performance.interactionCount || 0;
-}, tr = function() {
-  "interactionCount" in performance || Ae || (Ae = x("event", er, { type: "event", buffered: !0, durationThreshold: 0 }));
-}, L = [], te = /* @__PURE__ */ new Map(), _t = 0, sr = function() {
-  var r = Math.min(L.length - 1, Math.floor((It() - _t) / 50));
+}, rr = function() {
+  "interactionCount" in performance || Ae || (Ae = x("event", sr, { type: "event", buffered: !0, durationThreshold: 0 }));
+}, L = [], te = /* @__PURE__ */ new Map(), It = 0, nr = function() {
+  var r = Math.min(L.length - 1, Math.floor((vt() - It) / 50));
   return L[r];
-}, rr = [], nr = function(r) {
-  if (rr.forEach((function(n) {
+}, ir = [], or = function(r) {
+  if (ir.forEach((function(n) {
     return n(r);
   })), r.interactionId || r.entryType === "first-input") {
     var e = L[L.length - 1], t = te.get(r.interactionId);
@@ -5682,28 +5822,28 @@ var Ae, C, X, pt, le, Et = -1, V = function(r) {
       }));
     }
   }
-}, vt = function(r) {
+}, _t = function(r) {
   var e = self.requestIdleCallback || self.setTimeout, t = -1;
   return r = ue(r), document.visibilityState === "hidden" ? r() : (t = e(r), K(r)), t;
-}, Re = [200, 500], ir = function(r, e) {
-  "PerformanceEventTiming" in self && "interactionId" in PerformanceEventTiming.prototype && (e = e || {}, z((function() {
+}, Re = [200, 500], ar = function(r, e) {
+  "PerformanceEventTiming" in self && "interactionId" in PerformanceEventTiming.prototype && (e = e || {}, Q((function() {
     var t;
-    tr();
+    rr();
     var s, n = y("INP"), i = function(l) {
-      vt((function() {
-        l.forEach(nr);
-        var d = sr();
+      _t((function() {
+        l.forEach(or);
+        var d = nr();
         d && d.latency !== n.value && (n.value = d.latency, n.entries = d.entries, s());
       }));
     }, o = x("event", i, { durationThreshold: (t = e.durationThreshold) !== null && t !== void 0 ? t : 40 });
     s = w(r, n, Re, e.reportAllChanges), o && (o.observe({ type: "first-input", buffered: !0 }), K((function() {
       i(o.takeRecords()), s(!0);
     })), V((function() {
-      _t = It(), L.length = 0, te.clear(), n = y("INP"), s = w(r, n, Re, e.reportAllChanges);
+      It = vt(), L.length = 0, te.clear(), n = y("INP"), s = w(r, n, Re, e.reportAllChanges);
     })));
   })));
-}, Ne = [2500, 4e3], Te = {}, or = function(r, e) {
-  e = e || {}, z((function() {
+}, Ne = [2500, 4e3], Te = {}, lr = function(r, e) {
+  e = e || {}, Q((function() {
     var t, s = Ve(), n = y("LCP"), i = function(d) {
       e.reportAllChanges || (d = d.slice(-1)), d.forEach((function(c) {
         c.startTime < s.firstHiddenTime && (n.value = Math.max(c.startTime - de(), 0), n.entries = [c], t());
@@ -5716,7 +5856,7 @@ var Ae, C, X, pt, le, Et = -1, V = function(r) {
       }));
       ["keydown", "click"].forEach((function(d) {
         addEventListener(d, (function() {
-          return vt(l);
+          return _t(l);
         }), { once: !0, capture: !0 });
       })), K(l), V((function(d) {
         n = y("LCP"), t = w(r, n, Ne, e.reportAllChanges), ke((function() {
@@ -5725,31 +5865,31 @@ var Ae, C, X, pt, le, Et = -1, V = function(r) {
       }));
     }
   }));
-}, Oe = [800, 1800], ar = function r(e) {
-  document.prerendering ? z((function() {
+}, Oe = [800, 1800], cr = function r(e) {
+  document.prerendering ? Q((function() {
     return r(e);
   })) : document.readyState !== "complete" ? addEventListener("load", (function() {
     return r(e);
   }), !0) : setTimeout(e, 0);
-}, lr = function(r, e) {
+}, dr = function(r, e) {
   e = e || {};
   var t = y("TTFB"), s = w(r, t, Oe, e.reportAllChanges);
-  ar((function() {
+  cr((function() {
     var n = De();
     n && (t.value = Math.max(n.responseStart - de(), 0), t.entries = [n], s(!0), V((function() {
       t = y("TTFB", 0), (s = w(r, t, Oe, e.reportAllChanges))(!0);
     })));
   }));
-}, W = { passive: !0, capture: !0 }, cr = /* @__PURE__ */ new Date(), st = function(r, e) {
+}, W = { passive: !0, capture: !0 }, ur = /* @__PURE__ */ new Date(), st = function(r, e) {
   C || (C = e, X = r, pt = /* @__PURE__ */ new Date(), wt(removeEventListener), yt());
 }, yt = function() {
-  if (X >= 0 && X < pt - cr) {
+  if (X >= 0 && X < pt - ur) {
     var r = { entryType: "first-input", name: C.type, target: C.target, cancelable: C.cancelable, startTime: C.timeStamp, processingStart: C.timeStamp + X };
     le.forEach((function(e) {
       e(r);
     })), le = [];
   }
-}, dr = function(r) {
+}, hr = function(r) {
   if (r.cancelable) {
     var e = (r.timeStamp > 1e12 ? /* @__PURE__ */ new Date() : performance.now()) - r.timeStamp;
     r.type == "pointerdown" ? (function(t, s) {
@@ -5765,10 +5905,10 @@ var Ae, C, X, pt, le, Et = -1, V = function(r) {
   }
 }, wt = function(r) {
   ["mousedown", "keydown", "touchstart", "pointerdown"].forEach((function(e) {
-    return r(e, dr, W);
+    return r(e, hr, W);
   }));
-}, Pe = [100, 300], ur = function(r, e) {
-  e = e || {}, z((function() {
+}, Pe = [100, 300], fr = function(r, e) {
+  e = e || {}, Q((function() {
     var t, s = Ve(), n = y("FID"), i = function(d) {
       d.startTime < s.firstHiddenTime && (n.value = d.processingStart - d.startTime, n.entries.push(d), t(!0));
     }, o = function(d) {
@@ -5782,7 +5922,7 @@ var Ae, C, X, pt, le, Et = -1, V = function(r) {
     })));
   }));
 };
-const hr = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const mr = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   CLSThresholds: Ce,
   FCPThresholds: Me,
@@ -5790,31 +5930,31 @@ const hr = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   INPThresholds: Re,
   LCPThresholds: Ne,
   TTFBThresholds: Oe,
-  onCLS: Zs,
+  onCLS: tr,
   onFCP: St,
-  onFID: ur,
-  onINP: ir,
-  onLCP: or,
-  onTTFB: lr
+  onFID: fr,
+  onINP: ar,
+  onLCP: lr,
+  onTTFB: dr
 }, Symbol.toStringTag, { value: "Module" }));
 export {
   p as AppConfigValidationError,
-  fr as DEFAULT_SESSION_TIMEOUT,
+  gr as DEFAULT_SESSION_TIMEOUT,
   ye as DEFAULT_WEB_VITALS_MODE,
   A as DeviceType,
   se as EmitterEvent,
   B as ErrorType,
   u as EventType,
-  wr as InitializationTimeoutError,
+  Lr as InitializationTimeoutError,
   N as IntegrationValidationError,
-  _r as MAX_ARRAY_LENGTH,
-  Er as MAX_CUSTOM_EVENT_ARRAY_SIZE,
-  pr as MAX_CUSTOM_EVENT_KEYS,
-  mr as MAX_CUSTOM_EVENT_NAME_LENGTH,
-  gr as MAX_CUSTOM_EVENT_STRING_SIZE,
-  Sr as MAX_NESTED_OBJECT_KEYS,
-  Tr as MAX_STRING_LENGTH,
-  Ir as MAX_STRING_LENGTH_IN_ARRAY,
+  yr as MAX_ARRAY_LENGTH,
+  Tr as MAX_CUSTOM_EVENT_ARRAY_SIZE,
+  Sr as MAX_CUSTOM_EVENT_KEYS,
+  pr as MAX_CUSTOM_EVENT_NAME_LENGTH,
+  Er as MAX_CUSTOM_EVENT_STRING_SIZE,
+  vr as MAX_NESTED_OBJECT_KEYS,
+  Ir as MAX_STRING_LENGTH,
+  _r as MAX_STRING_LENGTH_IN_ARRAY,
   ie as Mode,
   at as PII_PATTERNS,
   O as PermanentError,
@@ -5825,11 +5965,11 @@ export {
   $ as SpecialApiUrl,
   ne as TimeoutError,
   j as TraceLogValidationError,
-  br as WEB_VITALS_GOOD_THRESHOLDS,
-  ze as WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS,
+  Ar as WEB_VITALS_GOOD_THRESHOLDS,
+  Qe as WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS,
   Yt as WEB_VITALS_POOR_THRESHOLDS,
-  Qe as getWebVitalsThresholds,
-  vr as isPrimaryScrollEvent,
-  yr as isSecondaryScrollEvent,
-  Lr as tracelog
+  ze as getWebVitalsThresholds,
+  wr as isPrimaryScrollEvent,
+  br as isSecondaryScrollEvent,
+  Mr as tracelog
 };