@crelora/mark 0.2.1 → 0.3.0

package/dist/browser.es.js

@@ -1,17 +1,17 @@
-const I = "https://ingest.onelence.com";
-class h extends Error {
+const N = "https://ingest.onelence.com";
+class p extends Error {
   status;
   retryAfterMs;
   constructor(t, e = {}) {
     super(t), this.name = "TransportError", this.status = e.status, this.retryAfterMs = e.retryAfterMs;
   }
 }
-function E(c) {
-  return !(typeof c != "number" || c < 400 || c >= 500 || c === 408 || c === 429);
+function V(r) {
+  return !(typeof r != "number" || r < 400 || r >= 500 || r === 408 || r === 429);
 }
-function x(c) {
-  if (!c) return;
-  const t = c.trim();
+function z(r) {
+  if (!r) return;
+  const t = r.trim();
   if (!t) return;
   const e = Number(t);
   if (Number.isFinite(e) && e >= 0)
@@ -22,20 +22,20 @@ function x(c) {
     return n > 0 ? n : 0;
   }
 }
-const q = 5, T = 300, D = 15e3, C = 2880 * 60 * 1e3;
-class U {
+const M = 5, $ = 300, j = 15e3, Y = 2880 * 60 * 1e3;
+class Q {
   constructor(t, e = {}) {
-    this.transport = t, this.maxAttempts = e.maxAttempts ?? q, this.baseBackoffMs = e.baseBackoffMs ?? T, this.maxBackoffMs = e.maxBackoffMs ?? D, this.maxItemAgeMs = e.maxItemAgeMs ?? C, this.debug = e.debug ?? !1, this.loadPersisted = e.loadPersisted, this.savePersisted = e.savePersisted, this.onError = e.onError;
+    this.transport = t, this.maxAttempts = e.maxAttempts ?? M, this.baseBackoffMs = e.baseBackoffMs ?? $, this.maxBackoffMs = e.maxBackoffMs ?? j, this.maxItemAgeMs = e.maxItemAgeMs ?? Y, this.debug = e.debug ?? !1, this.loadPersisted = e.loadPersisted, this.savePersisted = e.savePersisted, this.onError = e.onError;
     const i = this.loadPersisted?.() ?? [];
     if (i.length > 0) {
       const n = Date.now();
-      for (const r of i) {
-        const o = r.enqueuedAt ?? n;
-        if (n - o > this.maxItemAgeMs) {
+      for (const o of i) {
+        const a = o.enqueuedAt ?? n;
+        if (n - a > this.maxItemAgeMs) {
           this.dropped += 1;
           continue;
         }
-        this.queue.push({ ...r, enqueuedAt: o });
+        this.queue.push({ ...o, enqueuedAt: a });
       }
       this.persist();
     }
@@ -117,8 +117,8 @@ class U {
             delete i.__prefer_beacon, await this.transport.send(e.path, i, { preferBeacon: n }), this.queue.shift(), this.sent += 1, this.persist();
           } catch (i) {
             this.failed += 1, this.onError?.(i, e.data);
-            const n = i instanceof h ? i.status : void 0;
-            if (E(n)) {
+            const n = i instanceof p ? i.status : void 0;
+            if (V(n)) {
               this.queue.shift(), this.dropped += 1, this.persist(), this.debug && console.error("[Mark] Dropping event after non-retriable status", n, e.path);
               continue;
             }
@@ -126,18 +126,18 @@ class U {
               this.queue.shift(), this.dropped += 1, this.persist(), this.debug && console.error("[Mark] Dropping event after max retries", e.path, i);
               continue;
             }
-            const r = i instanceof h ? i.retryAfterMs : void 0;
-            let o;
-            if (typeof r == "number")
-              o = Math.min(this.maxBackoffMs, Math.max(0, r));
+            const o = i instanceof p ? i.retryAfterMs : void 0;
+            let a;
+            if (typeof o == "number")
+              a = Math.min(this.maxBackoffMs, Math.max(0, o));
             else {
-              const a = Math.random() * this.baseBackoffMs;
-              o = Math.min(
+              const c = Math.random() * this.baseBackoffMs;
+              a = Math.min(
                 this.maxBackoffMs,
-                this.baseBackoffMs * 2 ** (e.attempts - 1) + a
+                this.baseBackoffMs * 2 ** (e.attempts - 1) + c
               );
             }
-            e.nextAttemptAt = Date.now() + o, this.persist();
+            e.nextAttemptAt = Date.now() + a, this.persist();
             break;
           }
         }
@@ -147,7 +147,15 @@ class U {
     }
   }
 }
-const k = /* @__PURE__ */ new Set(["event_name", "user_id", "consent_state", "source", "is_conversion"]), P = /* @__PURE__ */ new Set([
+const W = 256;
+function E(r) {
+  if (typeof r != "string")
+    return;
+  const t = r.trim();
+  if (!(!t || t.length > W) && !t.includes("@") && !/\s/.test(t))
+    return t;
+}
+const G = /* @__PURE__ */ new Set(["event_name", "user_id", "consent_state", "source", "is_conversion"]), X = /* @__PURE__ */ new Set([
   "user_id",
   "visitor_id",
   "click_id",
@@ -156,13 +164,13 @@ const k = /* @__PURE__ */ new Set(["event_name", "user_id", "consent_state", "so
   "consent_state",
   "source"
 ]);
-class L {
+class J {
   constructor(t, e) {
     this.deps = e, this.validateConfig(t), this.config = {
-      endpoint: t.endpoint ?? I,
+      endpoint: t.endpoint ?? N,
       ...t,
       include_page_context: t.include_page_context ?? !0
-    }, this.consentRequirement = t.require_consent ?? !1, this.siteId = t.site_id, this.siteHost = t.site_host, this.sessionTimeoutMs = t.session_timeout_ms ?? 1800 * 1e3, this.queue = new U(this.deps.transport, {
+    }, this.consentRequirement = t.require_consent ?? !1, this.siteId = t.site_id, this.siteHost = t.site_host, this.sessionTimeoutMs = t.session_timeout_ms ?? 1800 * 1e3, this.queue = new Q(this.deps.transport, {
       debug: this.config.debug,
       loadPersisted: () => this.deps.storage.getOutbox?.() ?? [],
       savePersisted: (i) => this.deps.storage.setOutbox?.(i),
@@ -204,19 +212,19 @@ class L {
       return this.config.debug && console.warn("[Mark] Tracking blocked due to consent requirement."), !1;
     if (!i && !this.shouldSampleTrack())
       return !0;
-    const r = this.sanitizeTrackData(e), o = { ...r };
-    "query" in o && delete o.query, "site_id" in o && delete o.site_id, "site_host" in o && delete o.site_host;
-    const a = {
+    const o = this.sanitizeTrackData(e), a = { ...o };
+    "query" in a && delete a.query, "site_id" in a && delete a.site_id, "site_host" in a && delete a.site_host;
+    const c = {
       event_name: t,
       message_id: this.createMessageId(),
-      ...this.getIdentityFields(r),
-      ...o
+      ...this.getIdentityFields(o),
+      ...a
     };
-    i && (a.is_conversion = !0);
-    const u = r.site_id ?? this.siteId, l = r.site_host ?? this.siteHost;
-    u && (a.site_id = u), l && (a.site_host = l), this.config.include_page_context && typeof window < "u" && (this.applyPageContext(a), !l && a.site && (a.site_host = a.site)), this.applyInternalFlag(a, r.is_internal);
-    const d = this.config.before_send ? this.config.before_send(a) : a;
-    return d ? (this.ensureSession(), this.config.batching?.enabled && !i && !n?.preferBeacon ? (this.enqueueBatch(d), !0) : (this.queue.enqueue("/event", { ...d, __prefer_beacon: n?.preferBeacon === !0 }), !0)) : !0;
+    i && (c.is_conversion = !0);
+    const f = o.site_id ?? this.siteId, l = o.site_host ?? this.siteHost;
+    f && (c.site_id = f), l && (c.site_host = l), this.config.include_page_context && typeof window < "u" && (this.applyPageContext(c), !l && c.site && (c.site_host = c.site)), this.applyInternalFlag(c, o.is_internal);
+    const d = this.config.before_send ? this.config.before_send(c) : c;
+    return d ? (this.ensureSession(), this.applySessionFields(d), this.config.batching?.enabled && !i && !n?.preferBeacon ? (this.enqueueBatch(d), !0) : (this.queue.enqueue("/event", { ...d, __prefer_beacon: n?.preferBeacon === !0 }), !0)) : !0;
   }
   identify(t, e = {}) {
     if (!t) {
@@ -236,7 +244,7 @@ class L {
     };
     this.siteId && (i.site_id = this.siteId), this.siteHost && (i.site_host = this.siteHost), this.applyInternalFlag(i);
     const n = this.config.before_send ? this.config.before_send(i) : i;
-    n && this.queue.enqueue("/identify", n);
+    n && (this.ensureSession(), this.applySessionFields(n), this.queue.enqueue("/identify", n));
   }
   conversion(t, e = {}) {
     return this.trackInternal(t, e, !0);
@@ -251,6 +259,15 @@ class L {
   getVisitorId() {
     return this.deps.storage.getVisitorId();
   }
+  /**
+   * Adopts or replaces the stored visitor id with a trusted first-party value.
+   * Use when an external anonymous id (for example a platform client id) arrives
+   * after init. Returns false when the id is invalid.
+   */
+  setVisitorId(t) {
+    const e = E(t);
+    return e ? this.deps.storage.setVisitorId ? this.deps.storage.setVisitorId(e) : (this.deps.storage.getVisitorId() === e || this.deps.storage.update({ visitor_id: e }), !0) : (this.config.debug && console.warn("[Mark] setVisitorId called with an invalid visitor id."), !1);
+  }
   setConsent(t) {
     const e = this.deps.storage.getConsentStatus();
     this.deps.storage.setConsentStatus(t), t === "denied" ? (this.deps.storage.clearAttribution?.(), this.deps.storage.clearCookieVisitorId?.(), this.deps.storage.setInternal?.(!1)) : t === "granted" && e === "denied" && this.config.rotate_visitor_on_consent_change && this.deps.storage.rotateVisitorId?.();
@@ -318,8 +335,22 @@ class L {
     e === !0 || i ? t.is_internal = !0 : delete t.is_internal;
   }
   getIdentityFields(t) {
-    const e = t?.visitor_id ?? this.deps.storage.getVisitorId(), i = t?.user_id ?? this.deps.storage.getUserId?.(), n = t?.click_id ?? this.deps.storage.getLastClickId(), r = t?.campaign_id ?? this.deps.storage.getCampaignId(), o = t?.session_id ?? this.deps.storage.getSessionId?.(), a = this.deps.storage.getQueryParams() ?? {}, u = t?.query ?? {}, l = { ...a, ...u }, d = {};
-    return e && (d.visitor_id = e), i && (d.user_id = i), n && (d.click_id = n), r && (d.campaign_id = r), o && (d.session_id = o), Object.keys(l).length > 0 && (d.query = l), d;
+    const e = t?.visitor_id ?? this.deps.storage.getVisitorId(), i = t?.user_id ?? this.deps.storage.getUserId?.(), n = t?.click_id ?? this.deps.storage.getLastClickId(), o = t?.campaign_id ?? this.deps.storage.getCampaignId(), a = t?.session_id ?? this.deps.storage.getSessionId?.(), c = this.deps.storage.getQueryParams() ?? {}, f = t?.query ?? {}, l = { ...c, ...f }, d = {};
+    e && (d.visitor_id = e), i && (d.user_id = i), n && (d.click_id = n), o && (d.campaign_id = o), a && (d.session_id = a);
+    const h = this.deps.storage.getSessionStartedAt?.();
+    return a && h && (d.session_started_at = h, d.session_elapsed_ms = Date.now() - Date.parse(h)), Object.keys(l).length > 0 && (d.query = l), d;
+  }
+  /**
+   * Patches session fields after ensureSession when the first event in a session was built
+   * before rotation created an id. Rotation events keep the previous session_id from identity.
+   */
+  applySessionFields(t) {
+    if (!t.session_id) {
+      const i = this.deps.storage.getSessionId?.(), n = this.deps.storage.getSessionStartedAt?.();
+      i && (t.session_id = i), n && (t.session_started_at = n);
+    }
+    const e = t.session_started_at;
+    t.session_id && typeof e == "string" && (t.session_elapsed_ms = Date.now() - Date.parse(e));
   }
   hasConsent() {
     if (this.config.consent_source?.type === "tcf" && typeof window < "u" && !this.tcfCachedAllowed)
@@ -332,13 +363,13 @@ class L {
   sanitizeTrackData(t) {
     const e = {};
     for (const [i, n] of Object.entries(t))
-      k.has(i) || (e[i] = n);
+      G.has(i) || (e[i] = n);
     return e;
   }
   sanitizeIdentifyTraits(t) {
     const e = {};
     for (const [i, n] of Object.entries(t))
-      P.has(i) || (e[i] = n);
+      X.has(i) || (e[i] = n);
     return e;
   }
   validateConfig(t) {
@@ -354,6 +385,8 @@ class L {
       throw new Error("[Mark] `site_id` cannot be an empty string.");
     if (typeof t.site_host == "string" && !t.site_host.trim())
       throw new Error("[Mark] `site_host` cannot be an empty string.");
+    if (t.visitor_id !== void 0 && !E(t.visitor_id))
+      throw new Error("[Mark] `visitor_id` must be a non-empty string (max 256 characters).");
   }
   applyPageContext(t) {
     typeof document > "u" || (t.site || (t.site = window.location.host), t.page || (t.page = window.location.pathname), t.title || (t.title = document.title), !t.referrer && document.referrer && (t.referrer = this.scrubReferrer(document.referrer)));
@@ -383,11 +416,11 @@ class L {
   ensureSession() {
     const t = Date.now(), e = this.deps.storage.getSessionId?.(), i = this.deps.storage.getLastActivityAt?.(), n = i ? Date.parse(i) : 0;
     if (!e || !n || t - n >= this.sessionTimeoutMs || this.crossedUtcDay(n, t)) {
-      const o = this.createMessageId(), a = new Date(t).toISOString();
+      const a = this.createMessageId(), c = new Date(t).toISOString();
       this.deps.storage.update({
-        session_id: o,
-        session_started_at: a,
-        last_activity_at: a
+        session_id: a,
+        session_started_at: c,
+        last_activity_at: c
       });
       return;
     }
@@ -433,22 +466,22 @@ class L {
     if (t?.type !== "tcf" || typeof window > "u") return;
     const e = t.purposes, i = (n) => {
       try {
-        const r = window;
-        if (typeof r.__tcfapi != "function") {
+        const o = window;
+        if (typeof o.__tcfapi != "function") {
           n > 0 && setTimeout(() => i(n - 1), 200);
           return;
         }
-        r.__tcfapi("addEventListener", 2, (o, a) => {
-          if (!a || !o) {
+        o.__tcfapi("addEventListener", 2, (a, c) => {
+          if (!c || !a) {
             this.tcfCachedAllowed = !1;
             return;
           }
-          if (o.gdprApplies === !1) {
+          if (a.gdprApplies === !1) {
             this.tcfCachedAllowed = !0;
             return;
           }
-          const u = o.purpose?.consents ?? {};
-          this.tcfCachedAllowed = e.every((l) => u[String(l)] === !0);
+          const f = a.purpose?.consents ?? {};
+          this.tcfCachedAllowed = e.every((l) => f[String(l)] === !0);
         });
       } catch {
         this.tcfCachedAllowed = !1;
@@ -457,12 +490,12 @@ class L {
     i(10);
   }
 }
-class R {
+class Z {
   config;
   endpoint;
   pending = /* @__PURE__ */ new Set();
   constructor(t) {
-    this.config = t, this.endpoint = t.endpoint ?? I;
+    this.config = t, this.endpoint = t.endpoint ?? N;
   }
   async send(t, e, i) {
     const n = this.sendInternal(t, e, i);
@@ -477,54 +510,54 @@ class R {
     this.pending.size !== 0 && await Promise.allSettled(Array.from(this.pending));
   }
   async sendInternal(t, e, i) {
-    const n = this.joinUrl(this.endpoint, t), r = this.config.key, o = {
+    const n = this.joinUrl(this.endpoint, t), o = this.config.key, a = {
       "Content-Type": "application/json",
-      [r.startsWith("sk_") ? "x-secret-key" : "x-publishable-key"]: r
+      [o.startsWith("sk_") ? "x-secret-key" : "x-publishable-key"]: o
     };
     this.config.debug && console.log("[Mark] Sending", n, e);
-    const a = JSON.stringify(e);
+    const c = JSON.stringify(e);
     if (i?.preferBeacon && typeof navigator < "u" && typeof navigator.sendBeacon == "function") {
-      const f = new Blob([a], { type: "application/json" });
-      if (navigator.sendBeacon(n, f))
+      const u = new Blob([c], { type: "application/json" });
+      if (navigator.sendBeacon(n, u))
         return;
     }
     if (typeof fetch != "function")
-      throw this.config.debug && console.error("[Mark] Global fetch is not available in this runtime."), new h("[Mark] Global fetch is not available in this runtime.");
-    const u = this.config.request_timeout_ms ?? 1e4, l = new AbortController();
+      throw this.config.debug && console.error("[Mark] Global fetch is not available in this runtime."), new p("[Mark] Global fetch is not available in this runtime.");
+    const f = this.config.request_timeout_ms ?? 1e4, l = new AbortController();
     let d = !1;
-    const p = setTimeout(() => {
+    const h = setTimeout(() => {
       d = !0, l.abort();
-    }, u);
+    }, f);
     try {
-      const f = await fetch(n, {
+      const u = await fetch(n, {
         method: "POST",
-        headers: o,
-        body: a,
+        headers: a,
+        body: c,
         keepalive: !0,
         signal: l.signal
       });
-      if (!f.ok) {
-        const g = await this.readErrorSnippet(f), w = x(f.headers.get("Retry-After"));
+      if (!u.ok) {
+        const g = await this.readErrorSnippet(u), L = z(u.headers.get("Retry-After"));
         throw this.config.debug && console.error("[Mark] Request rejected", {
           url: n,
-          status: f.status,
-          statusText: f.statusText,
+          status: u.status,
+          statusText: u.statusText,
           body: g,
-          retryAfterMs: w
-        }), new h(
-          `[Mark] Request rejected with status ${f.status}: ${g}`,
-          { status: f.status, retryAfterMs: w }
+          retryAfterMs: L
+        }), new p(
+          `[Mark] Request rejected with status ${u.status}: ${g}`,
+          { status: u.status, retryAfterMs: L }
         );
       }
-    } catch (f) {
-      if (this.config.debug && console.error("[Mark] Failed to send", n, f), f instanceof h)
-        throw f;
+    } catch (u) {
+      if (this.config.debug && console.error("[Mark] Failed to send", n, u), u instanceof p)
+        throw u;
       if (d)
-        throw new h(`[Mark] Request timed out after ${u}ms`, { status: 408 });
-      const g = f instanceof Error ? f.message : String(f);
-      throw new h(`[Mark] Network error: ${g}`);
+        throw new p(`[Mark] Request timed out after ${f}ms`, { status: 408 });
+      const g = u instanceof Error ? u.message : String(u);
+      throw new p(`[Mark] Network error: ${g}`);
     } finally {
-      clearTimeout(p);
+      clearTimeout(h);
     }
   }
   joinUrl(t, e) {
@@ -539,8 +572,8 @@ class R {
     }
   }
 }
-const B = "crelora_mark_data", F = "crelora_mark_outbox", y = "crelora_mark_vid";
-class H {
+const tt = "crelora_mark_data", et = "crelora_mark_outbox", k = "crelora_mark_vid";
+class it {
   data;
   storageKey;
   outboxKey;
@@ -549,11 +582,13 @@ class H {
   bridgeReady = !1;
   bridgeOrigin;
   constructor(t) {
-    if (this.options = t ?? {}, this.storageKey = this.options.storageKey ?? B, this.outboxKey = this.options.outboxKey ?? F, typeof window > "u") {
+    if (this.options = t ?? {}, this.storageKey = this.options.storageKey ?? tt, this.outboxKey = this.options.outboxKey ?? et, typeof window > "u") {
       this.data = {};
       return;
     }
-    this.data = this.load(), this.data.visitor_id || (this.data.visitor_id = this.generateUUID(), this.save()), typeof window < "u" && this.options.bridge?.url && this.setupBridge(this.options.bridge), window.addEventListener("storage", this.handleStorageEvent);
+    this.data = this.load();
+    const e = E(this.options.seed_visitor_id);
+    !this.data.visitor_id && e && (this.data.visitor_id = e, this.save()), this.data.visitor_id || (this.data.visitor_id = this.generateUUID(), this.save()), typeof window < "u" && this.options.bridge?.url && this.setupBridge(this.options.bridge), window.addEventListener("storage", this.handleStorageEvent);
   }
   getVisitorId() {
     return this.data.visitor_id;
@@ -602,11 +637,19 @@ class H {
     });
   }
   clearCookieVisitorId() {
-    this.setCookie(y, "", -1);
+    this.setCookie(k, "", -1);
   }
   rotateVisitorId() {
     this.update({ visitor_id: this.generateUUID() });
   }
+  /**
+   * Adopts or replaces the stored visitor id with a trusted first-party value.
+   * No-op when the id is invalid or already set to the same value.
+   */
+  setVisitorId(t) {
+    const e = E(t);
+    return e ? (this.data.visitor_id === e || this.update({ visitor_id: e }), !0) : !1;
+  }
   getOutbox() {
     if (typeof window > "u") return [];
     try {
@@ -634,7 +677,7 @@ class H {
         return JSON.parse(e);
     } catch {
     }
-    const t = this.getCookie(y);
+    const t = this.getCookie(k);
     return t ? { visitor_id: t } : {};
   }
   save() {
@@ -643,7 +686,7 @@ class H {
         localStorage.setItem(this.storageKey, JSON.stringify(this.data));
       } catch {
       }
-      this.data.visitor_id && this.isCookieEnabled() && (this.setCookie(y, this.data.visitor_id, 365), this.options.bridge?.url && this.bridgeReady && this.postBridgeMessage({
+      this.data.visitor_id && this.isCookieEnabled() && (this.setCookie(k, this.data.visitor_id, 365), this.options.bridge?.url && this.bridgeReady && this.postBridgeMessage({
         type: "MARK_SYNC_UPDATE",
         visitorId: this.data.visitor_id
       }));
@@ -662,8 +705,8 @@ class H {
   setCookie(t, e, i) {
     if (!(typeof document > "u"))
       try {
-        const n = new Date(Date.now() + i * 24 * 60 * 60 * 1e3), r = this.options.cookie_domain ? `;domain=${this.options.cookie_domain}` : "";
-        document.cookie = `${t}=${e};expires=${n.toUTCString()};path=/;SameSite=Lax${r}`;
+        const n = new Date(Date.now() + i * 24 * 60 * 60 * 1e3), o = this.options.cookie_domain ? `;domain=${this.options.cookie_domain}` : "";
+        document.cookie = `${t}=${e};expires=${n.toUTCString()};path=/;SameSite=Lax${o}`;
       } catch {
       }
   }
@@ -697,10 +740,10 @@ class H {
       window.removeEventListener("message", this.handleBridgeMessage);
     }, i);
     window.addEventListener("message", this.handleBridgeMessage);
-    const r = () => {
+    const o = () => {
       this.bridgeFrame && document.body && document.body.appendChild(this.bridgeFrame);
     };
-    document.body ? r() : document.addEventListener("DOMContentLoaded", r, { once: !0 }), this.bridgeFrame.addEventListener("load", () => {
+    document.body ? o() : document.addEventListener("DOMContentLoaded", o, { once: !0 }), this.bridgeFrame.addEventListener("load", () => {
       clearTimeout(n), this.bridgeReady = !0, this.postBridgeMessage({
         type: "MARK_SYNC_REQUEST",
         visitorId: this.data.visitor_id
@@ -739,7 +782,7 @@ class H {
       }
   };
 }
-const O = [
+const nt = [
   "click_id",
   "ch_click_id",
   "gclid",
@@ -751,7 +794,7 @@ const O = [
   "ttclid",
   "twclid",
   "li_fat_id"
-], N = ["cid", "campaign_id"], K = [
+], st = ["cid", "campaign_id"], rt = [
   "utm_source",
   "utm_medium",
   "utm_campaign",
@@ -773,101 +816,232 @@ const O = [
   "ttclid",
   "twclid",
   "li_fat_id"
-], z = {
+], ot = {
   referral: "ref",
   affiliate_id: "ref",
   ch_click_id: "click_id",
   cid: "campaign_id"
-}, $ = ["email", "phone", "token", "auth", "password", "code"], V = 30, j = 256;
-function b(c, t = {}) {
-  const e = new URLSearchParams(c), i = Q(e), n = v(i, O), r = v(i, N), o = Y(e, t), a = {};
-  return n && (a.last_click_id = n), r && (a.campaign_id = r), Object.keys(o).length > 0 && (a.query_params = o), a;
+}, at = ["email", "phone", "token", "auth", "password", "code"], ct = 30, dt = 256;
+function U(r, t = {}) {
+  const e = new URLSearchParams(r), i = lt(e), n = R(i, nt), o = R(i, st), a = ut(e, t), c = {};
+  return n && (c.last_click_id = n), o && (c.campaign_id = o), Object.keys(a).length > 0 && (c.query_params = a), c;
 }
-function Y(c, t) {
-  const e = {}, i = new Set(_(t.query_param_denylist, $)), n = A(
+function ut(r, t) {
+  const e = {}, i = new Set(B(t.query_param_denylist, at)), n = F(
     t.max_captured_query_params,
-    V
-  ), r = A(
+    ct
+  ), o = F(
     t.max_query_param_value_length,
-    j
-  ), a = t.capture_all_query_params ?? !1 ? null : /* @__PURE__ */ new Set([
-    ...K.map(m),
-    ..._(t.capture_query_params, [])
+    dt
+  ), c = t.capture_all_query_params ?? !1 ? null : /* @__PURE__ */ new Set([
+    ...rt.map(S),
+    ...B(t.capture_query_params, [])
   ]);
-  for (const [u, l] of c.entries()) {
-    const d = m(u);
+  for (const [f, l] of r.entries()) {
+    const d = S(f);
     if (!d)
       continue;
-    const p = z[d] ?? d;
-    if (i.has(d) || i.has(p) || a && !a.has(d))
+    const h = ot[d] ?? d;
+    if (i.has(d) || i.has(h) || c && !c.has(d))
       continue;
-    const f = l.trim();
-    if (f) {
-      if (!(p in e) && Object.keys(e).length >= n)
+    const u = l.trim();
+    if (u) {
+      if (!(h in e) && Object.keys(e).length >= n)
         break;
-      e[p] = f.slice(0, r);
+      e[h] = u.slice(0, o);
     }
   }
   return e;
 }
-function v(c, t) {
+function R(r, t) {
   for (const e of t) {
-    const i = m(e), n = c[i]?.trim();
+    const i = S(e), n = r[i]?.trim();
     if (n)
       return n;
   }
 }
-function Q(c) {
+function lt(r) {
   const t = {};
-  for (const [e, i] of c.entries()) {
-    const n = m(e);
+  for (const [e, i] of r.entries()) {
+    const n = S(e);
     !n || n in t || (t[n] = i);
   }
   return t;
 }
-function m(c) {
-  return c.trim().toLowerCase();
+function S(r) {
+  return r.trim().toLowerCase();
 }
-function _(c, t) {
-  const e = c ?? t, i = /* @__PURE__ */ new Set();
+function B(r, t) {
+  const e = r ?? t, i = /* @__PURE__ */ new Set();
   for (const n of e) {
     if (typeof n != "string") continue;
-    const r = m(n);
-    r && i.add(r);
+    const o = S(n);
+    o && i.add(o);
   }
   return Array.from(i);
 }
-function A(c, t) {
-  if (typeof c != "number" || !Number.isFinite(c))
+function F(r, t) {
+  if (typeof r != "number" || !Number.isFinite(r))
     return t;
-  const e = Math.floor(c);
+  const e = Math.floor(r);
   return e < 0 ? t : e;
 }
-function S(c) {
-  return c.length > 1 && c.endsWith("/") ? c.slice(0, -1) : c;
+function x(r) {
+  return r.length > 1 && r.endsWith("/") ? r.slice(0, -1) : r;
 }
-function W(c) {
-  if (!c || c === "?")
+function ft(r) {
+  if (!r || r === "?")
     return "";
-  const t = c.startsWith("?") ? c.slice(1) : c;
+  const t = r.startsWith("?") ? r.slice(1) : r;
   if (!t)
     return "";
   const e = new URLSearchParams(t), i = [];
-  e.forEach((o, a) => {
-    i.push([a, o]);
-  }), i.sort(([o, a], [u, l]) => {
-    const d = o.localeCompare(u);
-    return d !== 0 ? d : a.localeCompare(l);
+  e.forEach((a, c) => {
+    i.push([c, a]);
+  }), i.sort(([a, c], [f, l]) => {
+    const d = a.localeCompare(f);
+    return d !== 0 ? d : c.localeCompare(l);
   });
   const n = new URLSearchParams();
-  for (const [o, a] of i)
-    n.append(o, a);
-  const r = n.toString();
-  return r === "" ? "" : `?${r}`;
+  for (const [a, c] of i)
+    n.append(a, c);
+  const o = n.toString();
+  return o === "" ? "" : `?${o}`;
+}
+function q(r) {
+  const t = x(r.pathname), e = ft(r.search);
+  return `${r.origin}${t}${e}${r.hash}`;
+}
+let D = !1, m = null;
+const w = [], y = [], _ = [];
+let v = null, b = null, A = null, I = null;
+function C() {
+  if (typeof window > "u") return;
+  const r = q(window.location);
+  if (r === m) return;
+  const t = { previousKey: m, nextKey: r };
+  for (const e of w)
+    e(t);
+  m = r;
+  for (const e of y)
+    e(t);
+}
+function ht() {
+  for (const r of _)
+    r();
+}
+function gt(r = {}) {
+  if (D || typeof window > "u" || typeof document > "u")
+    return;
+  D = !0;
+  const t = r.trackRouteChanges ?? !0;
+  m = q(window.location), I = ht, window.addEventListener("pagehide", I), t && (v = history.pushState, b = history.replaceState, history.pushState = function(...e) {
+    const i = v.apply(this, e);
+    return C(), i;
+  }, history.replaceState = function(...e) {
+    const i = b.apply(this, e);
+    return C(), i;
+  }, A = C, window.addEventListener("popstate", A));
+}
+function pt(r) {
+  return w.push(r), () => {
+    const t = w.indexOf(r);
+    t >= 0 && w.splice(t, 1);
+  };
+}
+function P(r) {
+  return y.push(r), () => {
+    const t = y.indexOf(r);
+    t >= 0 && y.splice(t, 1);
+  };
+}
+function mt(r) {
+  return _.push(r), () => {
+    const t = _.indexOf(r);
+    t >= 0 && _.splice(t, 1);
+  };
+}
+function wt() {
+  !D || typeof window > "u" || (v && (history.pushState = v), b && (history.replaceState = b), A && window.removeEventListener("popstate", A), I && window.removeEventListener("pagehide", I), v = null, b = null, A = null, I = null, w.length = 0, y.length = 0, _.length = 0, m = null, D = !1);
+}
+let T = 0;
+function H() {
+  T = 0;
+}
+function yt() {
+  return T;
+}
+function _t() {
+  if (typeof document > "u" || typeof window > "u")
+    return 0;
+  const r = document.documentElement, t = window.scrollY || r.scrollTop, e = Math.max(1, r.scrollHeight - window.innerHeight);
+  return Math.min(100, Math.round(t / e * 100));
+}
+function K() {
+  const r = _t();
+  return r > T && (T = r), r;
+}
+const vt = [25, 50, 75, 100];
+function bt(r, t = vt) {
+  if (typeof window > "u") return;
+  const e = /* @__PURE__ */ new Set(), i = () => {
+    e.clear(), H();
+  };
+  i(), P(() => {
+    i();
+  }), window.addEventListener(
+    "scroll",
+    () => {
+      const n = K();
+      for (const o of t)
+        n >= o && !e.has(o) && (e.add(o), r.track("scroll_depth", { percent: o }));
+    },
+    { passive: !0 }
+  );
+}
+const O = 1e4;
+function At(r) {
+  return r === !0 ? { minActiveMs: O, useBeacon: !0 } : {
+    minActiveMs: r.min_active_ms ?? O,
+    useBeacon: r.use_beacon !== !1
+  };
 }
-function M(c) {
-  const t = S(c.pathname), e = W(c.search);
-  return `${c.origin}${t}${e}${c.hash}`;
+function It(r, t) {
+  if (typeof window > "u" || typeof document > "u") return;
+  let e = Date.now(), i = 0, n = document.visibilityState === "visible" ? Date.now() : null, o = x(window.location.pathname), a = !1;
+  const c = () => {
+    n !== null && (i += Date.now() - n, n = null);
+  }, f = () => {
+    document.visibilityState === "visible" && n === null && (n = Date.now());
+  }, l = (h) => {
+    if (!a) {
+      a = !0;
+      try {
+        if (c(), K(), i < t.minActiveMs)
+          return;
+        const u = Date.now() - e, g = {
+          page: o,
+          active_time_ms: i,
+          total_time_ms: u,
+          max_scroll_percent: yt()
+        };
+        t.useBeacon && h ? r.trackWithOptions("page_engagement", g, { preferBeacon: !0 }) : r.track("page_engagement", g);
+      } finally {
+        a = !1;
+      }
+    }
+  }, d = () => {
+    e = Date.now(), i = 0, o = x(window.location.pathname), H(), f();
+  };
+  d(), pt(() => {
+    l(!0), c();
+  }), P(() => {
+    d();
+  }), mt(() => {
+    l(!0);
+  }), document.addEventListener("visibilitychange", () => {
+    document.visibilityState === "hidden" ? c() : f();
+  });
 }
 class s {
   static client = null;
@@ -877,17 +1051,17 @@ class s {
   static lastPageviewDedupeKey = null;
   static emitAutoPageview = null;
   static pendingAttribution = {};
-  static originalPushState = null;
-  static originalReplaceState = null;
-  static popstateHandler = null;
   static beaconDrainHandler = null;
   static visibilityHandler = null;
   static onlineHandler = null;
   static kickTimer = null;
   static init(t) {
     if (!s.client) {
-      const e = new H(t.cross_domain), i = new R(t);
-      s.client = new L(t, { storage: e, transport: i }), s.storage = e, s.config = t, s.refreshAttribution(e, t), typeof window < "u" && t.autocapture?.pageview && s.installPageviewTracking(t, e), typeof window < "u" && (s.installExtendedAutocapture(t), s.installLifecycleFlushing());
+      const e = new it({
+        ...t.cross_domain,
+        seed_visitor_id: t.visitor_id
+      }), i = new Z(t);
+      s.client = new J(t, { storage: e, transport: i }), s.storage = e, s.config = t, s.refreshAttribution(e, t), typeof window < "u" && (s.installPageLifecycleIfNeeded(t), t.autocapture?.pageview && s.installPageviewTracking(t, e), s.installExtendedAutocapture(t), s.installLifecycleFlushing());
     }
     return s.client;
   }
@@ -942,6 +1116,17 @@ class s {
     if (!(!s.client || !s.storage || !s.config || (s.config.require_consent ?? !1) && s.storage.getConsentStatus() !== "granted"))
       return s.client.getVisitorId();
   }
+  /**
+   * Adopts or replaces the stored visitor id with a trusted first-party value.
+   * Updates in-memory storage, localStorage, and the visitor cookie immediately.
+   * Use when an external anonymous id (for example a platform client id) is
+   * available after init. Theme embeds and pixels should call this with the
+   * same source id. Returns false when the id is invalid or the SDK is not
+   * initialized.
+   */
+  static setVisitorId(t) {
+    return s.client ? s.client.setVisitorId(t) : (s.config?.debug && console.warn("[Mark] Not initialized. Call init() first."), !1);
+  }
   static flush() {
     return s.client ? s.client.flush() : Promise.resolve();
   }
@@ -976,7 +1161,13 @@ class s {
     return s.client?.getStats() ?? { queued: 0, sent: 0, failed: 0, dropped: 0 };
   }
   static destroy() {
-    typeof window > "u" || (s.originalPushState && (history.pushState = s.originalPushState), s.originalReplaceState && (history.replaceState = s.originalReplaceState), s.popstateHandler && window.removeEventListener("popstate", s.popstateHandler), s.beaconDrainHandler && (window.removeEventListener("pagehide", s.beaconDrainHandler), window.removeEventListener("beforeunload", s.beaconDrainHandler)), s.visibilityHandler && typeof document < "u" && document.removeEventListener("visibilitychange", s.visibilityHandler), s.onlineHandler && window.removeEventListener("online", s.onlineHandler), s.kickTimer && clearInterval(s.kickTimer), s.originalPushState = null, s.originalReplaceState = null, s.popstateHandler = null, s.beaconDrainHandler = null, s.visibilityHandler = null, s.onlineHandler = null, s.kickTimer = null, s.pageviewTrackerInstalled = !1);
+    typeof window > "u" || (wt(), s.beaconDrainHandler && (window.removeEventListener("pagehide", s.beaconDrainHandler), window.removeEventListener("beforeunload", s.beaconDrainHandler)), s.visibilityHandler && typeof document < "u" && document.removeEventListener("visibilitychange", s.visibilityHandler), s.onlineHandler && window.removeEventListener("online", s.onlineHandler), s.kickTimer && clearInterval(s.kickTimer), s.beaconDrainHandler = null, s.visibilityHandler = null, s.onlineHandler = null, s.kickTimer = null, s.pageviewTrackerInstalled = !1);
+  }
+  static installPageLifecycleIfNeeded(t) {
+    const e = t.autocapture;
+    if (!(!!e?.pageview || !!e?.scroll_depth || !!e?.page_engagement)) return;
+    const n = t.track_route_changes ?? !0;
+    gt({ trackRouteChanges: n });
   }
   static installPageviewTracking(t, e) {
     if (s.pageviewTrackerInstalled) return;
@@ -984,29 +1175,23 @@ class s {
     const i = () => {
       if (!s.client) return;
       s.refreshAttribution(e, t);
-      const a = M(window.location);
-      if (a === s.lastPageviewDedupeKey) return;
+      const o = q(window.location);
+      if (o === s.lastPageviewDedupeKey) return;
       s.client.track("page_view", {
         site: window.location.host,
-        page: S(window.location.pathname),
+        page: x(window.location.pathname),
         title: document.title,
         referrer: document.referrer || void 0
-      }) && (s.lastPageviewDedupeKey = a);
+      }) && (s.lastPageviewDedupeKey = o);
     };
-    if (s.emitAutoPageview = i, i(), !(t.track_route_changes ?? !0)) return;
-    const r = history.pushState, o = history.replaceState;
-    s.originalPushState = r, s.originalReplaceState = o, history.pushState = function(...a) {
-      const u = r.apply(this, a);
-      return i(), u;
-    }, history.replaceState = function(...a) {
-      const u = o.apply(this, a);
-      return i(), u;
-    }, s.popstateHandler = i, window.addEventListener("popstate", i);
+    s.emitAutoPageview = i, i(), (t.track_route_changes ?? !0) && P(() => {
+      i();
+    });
   }
   static refreshAttribution(t, e) {
     if (typeof window > "u")
       return;
-    const i = b(window.location.search, e);
+    const i = U(window.location.search, e);
     if (Object.keys(i).length !== 0) {
       if (s.shouldPersistAttribution(t, e)) {
         const n = s.mergeAttributionUpdates(s.pendingAttribution, i);
@@ -1020,7 +1205,7 @@ class s {
     const t = s.storage, e = s.config;
     if (!t || !e || typeof window > "u")
       return;
-    const i = b(window.location.search, e), n = s.mergeAttributionUpdates(s.pendingAttribution, i);
+    const i = U(window.location.search, e), n = s.mergeAttributionUpdates(s.pendingAttribution, i);
     Object.keys(n).length > 0 && t.update(n), s.pendingAttribution = {};
   }
   static shouldPersistAttribution(t, e) {
@@ -1039,60 +1224,46 @@ class s {
   static installExtendedAutocapture(t) {
     if (!s.client || typeof document > "u") return;
     const e = t.autocapture;
-    if (e) {
-      if (e.click && document.addEventListener("click", (i) => {
-        const n = i.target;
-        if (!n) return;
-        const r = typeof e.click == "object" ? e.click.selector : void 0, o = r ? n.closest(r) : n.closest("[data-mark-event]");
-        if (!o) return;
-        const a = o.getAttribute("data-mark-event") || "click";
-        s.client?.track(a, {
-          element_id: o.id || void 0,
-          element_classes: o.className || void 0,
-          text: o.textContent?.trim().slice(0, 120) || void 0,
-          href: o.href || void 0
-        });
-      }), e.form_submit && document.addEventListener("submit", (i) => {
-        const n = i.target;
-        n && s.client?.track("form_submit", {
-          form_id: n.id || void 0,
-          form_name: n.name || void 0,
-          action: n.action || void 0
-        });
-      }), e.outbound_link && document.addEventListener("click", (i) => {
-        const n = i.target?.closest("a[href]");
-        if (!(!n || !n.href))
-          try {
-            const r = new URL(n.href, window.location.href), o = new URL(window.location.href);
-            r.origin !== o.origin && s.client?.trackWithOptions("outbound_link_click", { href: r.toString() }, { preferBeacon: !0 });
-          } catch {
-          }
-      }), e.scroll_depth) {
-        const i = [25, 50, 75, 100], n = /* @__PURE__ */ new Set();
-        window.addEventListener(
-          "scroll",
-          () => {
-            const r = document.documentElement, o = window.scrollY || r.scrollTop, a = Math.max(1, r.scrollHeight - window.innerHeight), u = Math.min(100, Math.round(o / a * 100));
-            for (const l of i)
-              u >= l && !n.has(l) && (n.add(l), s.client?.track("scroll_depth", { percent: l }));
-          },
-          { passive: !0 }
-        );
-      }
-      e.web_vitals && import("./web-vitals-CrnTllyu.js").then((i) => {
-        const n = (r) => {
-          s.client?.track("web_vital", {
-            metric: r.name,
-            value: r.value,
-            rating: r.rating,
-            metric_id: r.id
-          });
-        };
-        i.onLCP(n), i.onCLS(n), i.onINP(n), i.onTTFB(n);
-      }).catch(() => {
-        t.debug && console.warn("[Mark] web-vitals package not available; skipping autocapture.web_vitals.");
+    e && (e.click && document.addEventListener("click", (i) => {
+      const n = i.target;
+      if (!n) return;
+      const o = typeof e.click == "object" ? e.click.selector : void 0, a = o ? n.closest(o) : n.closest("[data-mark-event]");
+      if (!a) return;
+      const c = a.getAttribute("data-mark-event") || "click";
+      s.client?.track(c, {
+        element_id: a.id || void 0,
+        element_classes: a.className || void 0,
+        text: a.textContent?.trim().slice(0, 120) || void 0,
+        href: a.href || void 0
       });
-    }
+    }), e.form_submit && document.addEventListener("submit", (i) => {
+      const n = i.target;
+      n && s.client?.track("form_submit", {
+        form_id: n.id || void 0,
+        form_name: n.name || void 0,
+        action: n.action || void 0
+      });
+    }), e.outbound_link && document.addEventListener("click", (i) => {
+      const n = i.target?.closest("a[href]");
+      if (!(!n || !n.href))
+        try {
+          const o = new URL(n.href, window.location.href), a = new URL(window.location.href);
+          o.origin !== a.origin && s.client?.trackWithOptions("outbound_link_click", { href: o.toString() }, { preferBeacon: !0 });
+        } catch {
+        }
+    }), e.scroll_depth && s.client && bt(s.client), e.page_engagement && s.client && It(s.client, At(e.page_engagement)), e.web_vitals && import("./web-vitals-CrnTllyu.js").then((i) => {
+      const n = (o) => {
+        s.client?.track("web_vital", {
+          metric: o.name,
+          value: o.value,
+          rating: o.rating,
+          metric_id: o.id
+        });
+      };
+      i.onLCP(n), i.onCLS(n), i.onINP(n), i.onTTFB(n);
+    }).catch(() => {
+      t.debug && console.warn("[Mark] web-vitals package not available; skipping autocapture.web_vitals.");
+    }));
   }
 }
 typeof window < "u" && (window.Mark = s);