@crelora/mark 0.2.1 → 0.3.0

package/dist/node.es.js

@@ -1,4 +1,4 @@
-const p = "https://ingest.onelence.com";
+const m = "https://ingest.onelence.com";
 class f extends Error {
   status;
   retryAfterMs;
@@ -6,10 +6,10 @@ class f extends Error {
     super(t), this.name = "TransportError", this.status = e.status, this.retryAfterMs = e.retryAfterMs;
   }
 }
-function m(a) {
+function y(a) {
   return !(typeof a != "number" || a < 400 || a >= 500 || a === 408 || a === 429);
 }
-function y(a) {
+function w(a) {
   if (!a) return;
   const t = a.trim();
   if (!t) return;
@@ -22,20 +22,20 @@ function y(a) {
     return i > 0 ? i : 0;
   }
 }
-const w = 5, b = 300, I = 15e3, k = 2880 * 60 * 1e3;
-class v {
+const I = 5, v = 300, b = 15e3, k = 2880 * 60 * 1e3;
+class M {
   constructor(t, e = {}) {
-    this.transport = t, this.maxAttempts = e.maxAttempts ?? w, this.baseBackoffMs = e.baseBackoffMs ?? b, this.maxBackoffMs = e.maxBackoffMs ?? I, this.maxItemAgeMs = e.maxItemAgeMs ?? k, this.debug = e.debug ?? !1, this.loadPersisted = e.loadPersisted, this.savePersisted = e.savePersisted, this.onError = e.onError;
+    this.transport = t, this.maxAttempts = e.maxAttempts ?? I, this.baseBackoffMs = e.baseBackoffMs ?? v, this.maxBackoffMs = e.maxBackoffMs ?? b, this.maxItemAgeMs = e.maxItemAgeMs ?? k, this.debug = e.debug ?? !1, this.loadPersisted = e.loadPersisted, this.savePersisted = e.savePersisted, this.onError = e.onError;
     const s = this.loadPersisted?.() ?? [];
     if (s.length > 0) {
       const i = Date.now();
-      for (const o of s) {
-        const n = o.enqueuedAt ?? i;
-        if (i - n > this.maxItemAgeMs) {
+      for (const n of s) {
+        const r = n.enqueuedAt ?? i;
+        if (i - r > this.maxItemAgeMs) {
           this.dropped += 1;
           continue;
         }
-        this.queue.push({ ...o, enqueuedAt: n });
+        this.queue.push({ ...n, enqueuedAt: r });
       }
       this.persist();
     }
@@ -118,7 +118,7 @@ class v {
           } catch (s) {
             this.failed += 1, this.onError?.(s, e.data);
             const i = s instanceof f ? s.status : void 0;
-            if (m(i)) {
+            if (y(i)) {
               this.queue.shift(), this.dropped += 1, this.persist(), this.debug && console.error("[Mark] Dropping event after non-retriable status", i, e.path);
               continue;
             }
@@ -126,18 +126,18 @@ class v {
               this.queue.shift(), this.dropped += 1, this.persist(), this.debug && console.error("[Mark] Dropping event after max retries", e.path, s);
               continue;
             }
-            const o = s instanceof f ? s.retryAfterMs : void 0;
-            let n;
-            if (typeof o == "number")
-              n = Math.min(this.maxBackoffMs, Math.max(0, o));
+            const n = s instanceof f ? s.retryAfterMs : void 0;
+            let r;
+            if (typeof n == "number")
+              r = Math.min(this.maxBackoffMs, Math.max(0, n));
             else {
-              const r = Math.random() * this.baseBackoffMs;
-              n = Math.min(
+              const o = Math.random() * this.baseBackoffMs;
+              r = Math.min(
                 this.maxBackoffMs,
-                this.baseBackoffMs * 2 ** (e.attempts - 1) + r
+                this.baseBackoffMs * 2 ** (e.attempts - 1) + o
               );
             }
-            e.nextAttemptAt = Date.now() + n, this.persist();
+            e.nextAttemptAt = Date.now() + r, this.persist();
             break;
           }
         }
@@ -147,7 +147,15 @@ class v {
     }
   }
 }
-const M = /* @__PURE__ */ new Set(["event_name", "user_id", "consent_state", "source", "is_conversion"]), q = /* @__PURE__ */ new Set([
+const A = 256;
+function p(a) {
+  if (typeof a != "string")
+    return;
+  const t = a.trim();
+  if (!(!t || t.length > A) && !t.includes("@") && !/\s/.test(t))
+    return t;
+}
+const S = /* @__PURE__ */ new Set(["event_name", "user_id", "consent_state", "source", "is_conversion"]), q = /* @__PURE__ */ new Set([
   "user_id",
   "visitor_id",
   "click_id",
@@ -156,13 +164,13 @@ const M = /* @__PURE__ */ new Set(["event_name", "user_id", "consent_state", "so
   "consent_state",
   "source"
 ]);
-class A {
+class D {
   constructor(t, e) {
     this.deps = e, this.validateConfig(t), this.config = {
-      endpoint: t.endpoint ?? p,
+      endpoint: t.endpoint ?? m,
       ...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 v(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 M(this.deps.transport, {
       debug: this.config.debug,
       loadPersisted: () => this.deps.storage.getOutbox?.() ?? [],
       savePersisted: (s) => this.deps.storage.setOutbox?.(s),
@@ -204,19 +212,19 @@ class A {
       return this.config.debug && console.warn("[Mark] Tracking blocked due to consent requirement."), !1;
     if (!s && !this.shouldSampleTrack())
       return !0;
-    const o = this.sanitizeTrackData(e), n = { ...o };
-    "query" in n && delete n.query, "site_id" in n && delete n.site_id, "site_host" in n && delete n.site_host;
-    const r = {
+    const n = this.sanitizeTrackData(e), r = { ...n };
+    "query" in r && delete r.query, "site_id" in r && delete r.site_id, "site_host" in r && delete r.site_host;
+    const o = {
       event_name: t,
       message_id: this.createMessageId(),
-      ...this.getIdentityFields(o),
-      ...n
+      ...this.getIdentityFields(n),
+      ...r
     };
-    s && (r.is_conversion = !0);
-    const h = o.site_id ?? this.siteId, d = o.site_host ?? this.siteHost;
-    h && (r.site_id = h), d && (r.site_host = d), this.config.include_page_context && typeof window < "u" && (this.applyPageContext(r), !d && r.site && (r.site_host = r.site)), this.applyInternalFlag(r, o.is_internal);
-    const u = this.config.before_send ? this.config.before_send(r) : r;
-    return u ? (this.ensureSession(), this.config.batching?.enabled && !s && !i?.preferBeacon ? (this.enqueueBatch(u), !0) : (this.queue.enqueue("/event", { ...u, __prefer_beacon: i?.preferBeacon === !0 }), !0)) : !0;
+    s && (o.is_conversion = !0);
+    const h = n.site_id ?? this.siteId, u = n.site_host ?? this.siteHost;
+    h && (o.site_id = h), u && (o.site_host = u), this.config.include_page_context && typeof window < "u" && (this.applyPageContext(o), !u && o.site && (o.site_host = o.site)), this.applyInternalFlag(o, n.is_internal);
+    const d = this.config.before_send ? this.config.before_send(o) : o;
+    return d ? (this.ensureSession(), this.applySessionFields(d), this.config.batching?.enabled && !s && !i?.preferBeacon ? (this.enqueueBatch(d), !0) : (this.queue.enqueue("/event", { ...d, __prefer_beacon: i?.preferBeacon === !0 }), !0)) : !0;
   }
   identify(t, e = {}) {
     if (!t) {
@@ -236,7 +244,7 @@ class A {
     };
     this.siteId && (s.site_id = this.siteId), this.siteHost && (s.site_host = this.siteHost), this.applyInternalFlag(s);
     const i = this.config.before_send ? this.config.before_send(s) : s;
-    i && this.queue.enqueue("/identify", i);
+    i && (this.ensureSession(), this.applySessionFields(i), this.queue.enqueue("/identify", i));
   }
   conversion(t, e = {}) {
     return this.trackInternal(t, e, !0);
@@ -251,6 +259,15 @@ class A {
   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 = p(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 A {
     e === !0 || s ? t.is_internal = !0 : delete t.is_internal;
   }
   getIdentityFields(t) {
-    const e = t?.visitor_id ?? this.deps.storage.getVisitorId(), s = t?.user_id ?? this.deps.storage.getUserId?.(), i = t?.click_id ?? this.deps.storage.getLastClickId(), o = t?.campaign_id ?? this.deps.storage.getCampaignId(), n = t?.session_id ?? this.deps.storage.getSessionId?.(), r = this.deps.storage.getQueryParams() ?? {}, h = t?.query ?? {}, d = { ...r, ...h }, u = {};
-    return e && (u.visitor_id = e), s && (u.user_id = s), i && (u.click_id = i), o && (u.campaign_id = o), n && (u.session_id = n), Object.keys(d).length > 0 && (u.query = d), u;
+    const e = t?.visitor_id ?? this.deps.storage.getVisitorId(), s = t?.user_id ?? this.deps.storage.getUserId?.(), i = t?.click_id ?? this.deps.storage.getLastClickId(), n = t?.campaign_id ?? this.deps.storage.getCampaignId(), r = t?.session_id ?? this.deps.storage.getSessionId?.(), o = this.deps.storage.getQueryParams() ?? {}, h = t?.query ?? {}, u = { ...o, ...h }, d = {};
+    e && (d.visitor_id = e), s && (d.user_id = s), i && (d.click_id = i), n && (d.campaign_id = n), r && (d.session_id = r);
+    const l = this.deps.storage.getSessionStartedAt?.();
+    return r && l && (d.session_started_at = l, d.session_elapsed_ms = Date.now() - Date.parse(l)), Object.keys(u).length > 0 && (d.query = u), 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 s = this.deps.storage.getSessionId?.(), i = this.deps.storage.getSessionStartedAt?.();
+      s && (t.session_id = s), i && (t.session_started_at = i);
+    }
+    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,7 +363,7 @@ class A {
   sanitizeTrackData(t) {
     const e = {};
     for (const [s, i] of Object.entries(t))
-      M.has(s) || (e[s] = i);
+      S.has(s) || (e[s] = i);
     return e;
   }
   sanitizeIdentifyTraits(t) {
@@ -354,6 +385,8 @@ class A {
       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 && !p(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 A {
   ensureSession() {
     const t = Date.now(), e = this.deps.storage.getSessionId?.(), s = this.deps.storage.getLastActivityAt?.(), i = s ? Date.parse(s) : 0;
     if (!e || !i || t - i >= this.sessionTimeoutMs || this.crossedUtcDay(i, t)) {
-      const n = this.createMessageId(), r = new Date(t).toISOString();
+      const r = this.createMessageId(), o = new Date(t).toISOString();
       this.deps.storage.update({
-        session_id: n,
-        session_started_at: r,
-        last_activity_at: r
+        session_id: r,
+        session_started_at: o,
+        last_activity_at: o
       });
       return;
     }
@@ -433,22 +466,22 @@ class A {
     if (t?.type !== "tcf" || typeof window > "u") return;
     const e = t.purposes, s = (i) => {
       try {
-        const o = window;
-        if (typeof o.__tcfapi != "function") {
+        const n = window;
+        if (typeof n.__tcfapi != "function") {
           i > 0 && setTimeout(() => s(i - 1), 200);
           return;
         }
-        o.__tcfapi("addEventListener", 2, (n, r) => {
-          if (!r || !n) {
+        n.__tcfapi("addEventListener", 2, (r, o) => {
+          if (!o || !r) {
             this.tcfCachedAllowed = !1;
             return;
           }
-          if (n.gdprApplies === !1) {
+          if (r.gdprApplies === !1) {
             this.tcfCachedAllowed = !0;
             return;
           }
-          const h = n.purpose?.consents ?? {};
-          this.tcfCachedAllowed = e.every((d) => h[String(d)] === !0);
+          const h = r.purpose?.consents ?? {};
+          this.tcfCachedAllowed = e.every((u) => h[String(u)] === !0);
         });
       } catch {
         this.tcfCachedAllowed = !1;
@@ -457,12 +490,12 @@ class A {
     s(10);
   }
 }
-class D {
+class T {
   config;
   endpoint;
   pending = /* @__PURE__ */ new Set();
   constructor(t) {
-    this.config = t, this.endpoint = t.endpoint ?? p;
+    this.config = t, this.endpoint = t.endpoint ?? m;
   }
   async send(t, e, s) {
     const i = this.sendInternal(t, e, s);
@@ -477,54 +510,54 @@ class D {
     this.pending.size !== 0 && await Promise.allSettled(Array.from(this.pending));
   }
   async sendInternal(t, e, s) {
-    const i = this.joinUrl(this.endpoint, t), o = this.config.key, n = {
+    const i = this.joinUrl(this.endpoint, t), n = this.config.key, r = {
       "Content-Type": "application/json",
-      [o.startsWith("sk_") ? "x-secret-key" : "x-publishable-key"]: o
+      [n.startsWith("sk_") ? "x-secret-key" : "x-publishable-key"]: n
     };
     this.config.debug && console.log("[Mark] Sending", i, e);
-    const r = JSON.stringify(e);
+    const o = JSON.stringify(e);
     if (s?.preferBeacon && typeof navigator < "u" && typeof navigator.sendBeacon == "function") {
-      const c = new Blob([r], { type: "application/json" });
+      const c = new Blob([o], { type: "application/json" });
       if (navigator.sendBeacon(i, c))
         return;
     }
     if (typeof fetch != "function")
       throw this.config.debug && console.error("[Mark] Global fetch is not available in this runtime."), new f("[Mark] Global fetch is not available in this runtime.");
-    const h = this.config.request_timeout_ms ?? 1e4, d = new AbortController();
-    let u = !1;
-    const _ = setTimeout(() => {
-      u = !0, d.abort();
+    const h = this.config.request_timeout_ms ?? 1e4, u = new AbortController();
+    let d = !1;
+    const l = setTimeout(() => {
+      d = !0, u.abort();
     }, h);
     try {
       const c = await fetch(i, {
         method: "POST",
-        headers: n,
-        body: r,
+        headers: r,
+        body: o,
         keepalive: !0,
-        signal: d.signal
+        signal: u.signal
       });
       if (!c.ok) {
-        const l = await this.readErrorSnippet(c), g = y(c.headers.get("Retry-After"));
+        const g = await this.readErrorSnippet(c), _ = w(c.headers.get("Retry-After"));
         throw this.config.debug && console.error("[Mark] Request rejected", {
           url: i,
           status: c.status,
           statusText: c.statusText,
-          body: l,
-          retryAfterMs: g
+          body: g,
+          retryAfterMs: _
         }), new f(
-          `[Mark] Request rejected with status ${c.status}: ${l}`,
-          { status: c.status, retryAfterMs: g }
+          `[Mark] Request rejected with status ${c.status}: ${g}`,
+          { status: c.status, retryAfterMs: _ }
         );
       }
     } catch (c) {
       if (this.config.debug && console.error("[Mark] Failed to send", i, c), c instanceof f)
         throw c;
-      if (u)
+      if (d)
         throw new f(`[Mark] Request timed out after ${h}ms`, { status: 408 });
-      const l = c instanceof Error ? c.message : String(c);
-      throw new f(`[Mark] Network error: ${l}`);
+      const g = c instanceof Error ? c.message : String(c);
+      throw new f(`[Mark] Network error: ${g}`);
     } finally {
-      clearTimeout(_);
+      clearTimeout(l);
     }
   }
   joinUrl(t, e) {
@@ -539,7 +572,7 @@ class D {
     }
   }
 }
-class S {
+class E {
   constructor(t = {}) {
     this.defaults = t;
   }
@@ -580,6 +613,10 @@ class S {
   }
   rotateVisitorId() {
   }
+  setVisitorId(t) {
+    const e = p(t);
+    return e ? (this.defaults.visitor_id = e, !0) : !1;
+  }
   getInternal() {
     return this.defaults.is_internal;
   }
@@ -587,7 +624,7 @@ class S {
     this.defaults.is_internal = t ? !0 : void 0;
   }
 }
-class T {
+class x {
   constructor(t) {
     this.client = t;
   }
@@ -620,6 +657,14 @@ class T {
   getVisitorId() {
     return this.client.getVisitorId();
   }
+  /**
+   * Adopts or replaces the visitor id for this NodeMark instance.
+   * With default StatelessStorage, updates the in-memory defaults used by
+   * subsequent track/identify calls.
+   */
+  setVisitorId(t) {
+    return this.client.setVisitorId(t);
+  }
   /**
    * Marks the current request/visitor as internal traffic. When using the
    * default StatelessStorage, the flag is scoped to this NodeMark instance.
@@ -631,9 +676,9 @@ class T {
     return this.client.getInternal();
   }
 }
-const E = (a, t = {}) => {
-  const e = t.storage ?? new S({
-    visitor_id: t.storageDefaults?.visitor_id,
+const C = (a, t = {}) => {
+  const e = p(a.visitor_id), s = t.storage ?? new E({
+    visitor_id: t.storageDefaults?.visitor_id ?? e,
     user_id: t.storageDefaults?.user_id,
     session_id: t.storageDefaults?.session_id,
     session_started_at: t.storageDefaults?.session_started_at,
@@ -643,12 +688,12 @@ const E = (a, t = {}) => {
     query_params: t.storageDefaults?.query_params,
     consent_status: t.storageDefaults?.consent_status,
     is_internal: t.storageDefaults?.is_internal
-  }), s = t.transport ?? new D(a), i = new A(a, { storage: e, transport: s });
-  return new T(i);
+  }), i = t.transport ?? new T(a), n = new D(a, { storage: s, transport: i });
+  return new x(n);
 };
 export {
-  T as NodeMark,
-  S as StatelessStorage,
-  E as createNodeMark
+  x as NodeMark,
+  E as StatelessStorage,
+  C as createNodeMark
 };
 //# sourceMappingURL=node.es.js.map