@crelora/mark 0.0.16

package/dist/browser.es.js

@@ -0,0 +1,517 @@
+const w = "https://ingest.onelence.com", v = /* @__PURE__ */ new Set(["event_name", "user_id", "consent_state", "source", "is_conversion"]), A = /* @__PURE__ */ new Set([
+  "user_id",
+  "visitor_id",
+  "click_id",
+  "campaign_id",
+  "query",
+  "consent_state",
+  "source"
+]);
+class I {
+  constructor(t, e) {
+    this.deps = e, this.validateConfig(t), this.config = {
+      endpoint: t.endpoint ?? w,
+      ...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;
+  }
+  config;
+  consentRequirement;
+  siteId;
+  siteHost;
+  track(t, e = {}) {
+    return this.trackInternal(t, e, !1);
+  }
+  trackInternal(t, e = {}, i = !1) {
+    if (!t)
+      return this.config.debug && console.warn("[Mark] track called without event name"), !1;
+    if (!this.hasConsent())
+      return this.config.debug && console.warn("[Mark] Tracking blocked due to consent requirement."), !1;
+    const s = this.sanitizeTrackData(e), r = { ...s };
+    "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,
+      ...this.getIdentityFields(s),
+      ...r
+    };
+    i && (o.is_conversion = !0);
+    const a = s.site_id ?? this.siteId, c = s.site_host ?? this.siteHost;
+    return a && (o.site_id = a), c && (o.site_host = c), this.config.include_page_context && typeof window < "u" && (this.applyPageContext(o), !c && o.site && (o.site_host = o.site)), this.deps.transport.send("/event", o), !0;
+  }
+  identify(t, e = {}) {
+    if (!t) {
+      this.config.debug && console.warn("[Mark] identify called without userId");
+      return;
+    }
+    if (!this.hasConsent()) {
+      this.config.debug && console.warn("[Mark] Identify blocked due to consent requirement.");
+      return;
+    }
+    const i = {
+      user_id: t,
+      ...this.sanitizeIdentifyTraits(e),
+      ...this.getIdentityFields()
+    };
+    this.siteId && (i.site_id = this.siteId), this.siteHost && (i.site_host = this.siteHost), this.deps.transport.send("/identify", i);
+  }
+  conversion(t, e = {}) {
+    return this.trackInternal(t, e, !0);
+  }
+  /**
+   * Returns the current visitor ID from storage, if any.
+   * Used by browser/Node wrappers to expose a stable pseudonymous ID for server-side attribution.
+   */
+  getVisitorId() {
+    return this.deps.storage.getVisitorId();
+  }
+  setConsent(t) {
+    this.deps.storage.setConsentStatus(t);
+    const e = {
+      visitor_id: this.deps.storage.getVisitorId(),
+      consent_state: t,
+      source: "sdk"
+    };
+    this.siteId && (e.site_id = this.siteId), this.siteHost && (e.site_host = this.siteHost), this.deps.transport.send("/consent", e);
+  }
+  getIdentityFields(t) {
+    const e = t?.visitor_id ?? this.deps.storage.getVisitorId(), i = t?.click_id ?? this.deps.storage.getLastClickId(), s = t?.campaign_id ?? this.deps.storage.getCampaignId(), r = this.deps.storage.getQueryParams() ?? {}, o = t?.query ?? {}, a = { ...r, ...o }, c = {};
+    return e && (c.visitor_id = e), i && (c.click_id = i), s && (c.campaign_id = s), Object.keys(a).length > 0 && (c.query = a), c;
+  }
+  hasConsent() {
+    if (!this.consentRequirement)
+      return !0;
+    const e = this.deps.storage.getConsentStatus();
+    return this.consentRequirement === "auto", e === "granted";
+  }
+  sanitizeTrackData(t) {
+    const e = {};
+    for (const [i, s] of Object.entries(t))
+      v.has(i) || (e[i] = s);
+    return e;
+  }
+  sanitizeIdentifyTraits(t) {
+    const e = {};
+    for (const [i, s] of Object.entries(t))
+      A.has(i) || (e[i] = s);
+    return e;
+  }
+  validateConfig(t) {
+    if (!t.key || !t.key.trim())
+      throw new Error("[Mark] `key` must be a non-empty string.");
+    if (t.endpoint)
+      try {
+        new URL(t.endpoint);
+      } catch {
+        throw new Error("[Mark] `endpoint` must be a valid absolute URL.");
+      }
+    if (typeof t.site_id == "string" && !t.site_id.trim())
+      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.");
+  }
+  applyPageContext(t) {
+    t.page || t.title || t.referrer || t.site || (t.site = window.location.host, t.page = window.location.pathname, t.title = document.title, document.referrer && (t.referrer = document.referrer));
+  }
+}
+class E {
+  config;
+  endpoint;
+  constructor(t) {
+    this.validateConfig(t), this.config = t, this.endpoint = t.endpoint ?? w;
+  }
+  async send(t, e) {
+    const i = this.joinUrl(this.endpoint, t), s = this.config.key, r = {
+      "Content-Type": "application/json",
+      [s.startsWith("sk_") ? "x-secret-key" : "x-publishable-key"]: s
+    };
+    if (this.config.debug && console.log("[Mark] Sending", i, e), typeof fetch != "function") {
+      this.config.debug && console.error("[Mark] Global fetch is not available in this runtime.");
+      return;
+    }
+    try {
+      const o = await fetch(i, {
+        method: "POST",
+        headers: r,
+        body: JSON.stringify(e),
+        keepalive: !0
+      });
+      if (!o.ok && this.config.debug) {
+        const a = await this.readErrorSnippet(o);
+        console.error("[Mark] Request rejected", {
+          url: i,
+          status: o.status,
+          statusText: o.statusText,
+          body: a
+        });
+      }
+    } catch (o) {
+      this.config.debug && console.error("[Mark] Failed to send", i, o);
+    }
+  }
+  joinUrl(t, e) {
+    const i = t.replace(/\/+$/, ""), s = e.replace(/^\/+/, "");
+    return `${i}/${s}`;
+  }
+  async readErrorSnippet(t) {
+    try {
+      return (await t.text()).slice(0, 300);
+    } catch {
+      return "";
+    }
+  }
+  validateConfig(t) {
+    if (!t.key || !t.key.trim())
+      throw new Error("[Mark] `key` must be a non-empty string.");
+    if (t.endpoint)
+      try {
+        new URL(t.endpoint);
+      } catch {
+        throw new Error("[Mark] `endpoint` must be a valid absolute URL.");
+      }
+  }
+}
+const k = "crelora_mark_data", g = "crelora_mark_vid";
+class x {
+  data;
+  storageKey;
+  options;
+  bridgeFrame;
+  bridgeReady = !1;
+  bridgeOrigin;
+  constructor(t) {
+    this.options = t ?? {}, this.storageKey = this.options.storageKey ?? k, 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);
+  }
+  getVisitorId() {
+    return this.data.visitor_id;
+  }
+  getLastClickId() {
+    return this.data.last_click_id;
+  }
+  getCampaignId() {
+    return this.data.campaign_id;
+  }
+  getQueryParams() {
+    return this.data.query_params;
+  }
+  getConsentStatus() {
+    return this.data.consent_status;
+  }
+  update(t) {
+    this.data = { ...this.data, ...t }, this.save();
+  }
+  setConsentStatus(t) {
+    this.data.consent_status = t, this.save();
+  }
+  load() {
+    try {
+      const e = localStorage.getItem(this.storageKey);
+      if (e)
+        return JSON.parse(e);
+    } catch {
+    }
+    const t = this.getCookie(g);
+    return t ? { visitor_id: t } : {};
+  }
+  save() {
+    try {
+      localStorage.setItem(this.storageKey, JSON.stringify(this.data));
+    } catch {
+    }
+    this.data.visitor_id && this.isCookieEnabled() && (this.setCookie(g, this.data.visitor_id, 365), this.options.bridge?.url && this.bridgeReady && this.postBridgeMessage({
+      type: "MARK_SYNC_UPDATE",
+      visitorId: this.data.visitor_id
+    }));
+  }
+  getCookie(t) {
+    try {
+      const e = document.cookie.match(new RegExp(`(^| )${t}=([^;]+)`));
+      if (e) return e[2];
+    } catch {
+    }
+    return null;
+  }
+  setCookie(t, e, i) {
+    try {
+      const s = new Date(Date.now() + i * 24 * 60 * 60 * 1e3), r = this.options.cookie_domain ? `;domain=${this.options.cookie_domain}` : "";
+      document.cookie = `${t}=${e};expires=${s.toUTCString()};path=/;SameSite=Lax${r}`;
+    } catch {
+    }
+  }
+  generateUUID() {
+    return typeof crypto < "u" && crypto.randomUUID ? crypto.randomUUID() : "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (t) => {
+      const e = Math.random() * 16 | 0;
+      return (t === "x" ? e : e & 3 | 8).toString(16);
+    });
+  }
+  isCookieEnabled() {
+    return this.options.mode ? this.options.mode === "single" || this.options.mode === "subdomain" : !0;
+  }
+  setupBridge(t) {
+    if (typeof document > "u") return;
+    let e;
+    try {
+      e = new URL(t.url, window.location.href);
+    } catch {
+      return;
+    }
+    this.bridgeOrigin = e.origin, this.bridgeFrame = document.createElement("iframe"), this.bridgeFrame.style.display = "none", this.bridgeFrame.setAttribute("aria-hidden", "true"), this.bridgeFrame.src = e.toString();
+    const i = t.timeout_ms ?? 3e3, s = setTimeout(() => {
+      window.removeEventListener("message", this.handleBridgeMessage);
+    }, i);
+    window.addEventListener("message", this.handleBridgeMessage);
+    const r = () => {
+      this.bridgeFrame && document.body && document.body.appendChild(this.bridgeFrame);
+    };
+    document.body ? r() : document.addEventListener("DOMContentLoaded", r, { once: !0 }), this.bridgeFrame.addEventListener("load", () => {
+      clearTimeout(s), this.bridgeReady = !0, this.postBridgeMessage({
+        type: "MARK_SYNC_REQUEST",
+        visitorId: this.data.visitor_id
+      });
+    });
+  }
+  handleBridgeMessage = (t) => {
+    if (!this.bridgeFrame?.contentWindow || t.source !== this.bridgeFrame.contentWindow || !this.isDomainAllowed(t.origin))
+      return;
+    const e = t.data;
+    !e || !e.type || e.type === "MARK_SYNC_RESPONSE" && e.visitorId && e.visitorId !== this.data.visitor_id && (this.data.visitor_id = e.visitorId, this.save());
+  };
+  postBridgeMessage(t) {
+    this.bridgeFrame?.contentWindow && this.bridgeFrame.contentWindow.postMessage(t, this.bridgeOrigin ?? "*");
+  }
+  isDomainAllowed(t) {
+    try {
+      const e = new URL(t);
+      if (this.options.allowed_domains?.length)
+        return this.options.allowed_domains.some(
+          (s) => e.hostname === s || e.hostname.endsWith(`.${s}`)
+        );
+      if (!this.bridgeOrigin)
+        return !1;
+      const i = new URL(this.bridgeOrigin);
+      return e.hostname === i.hostname;
+    } catch {
+      return !1;
+    }
+  }
+}
+const S = [
+  "click_id",
+  "ch_click_id",
+  "gclid",
+  "gbraid",
+  "wbraid",
+  "dclid",
+  "msclkid",
+  "fbclid",
+  "ttclid",
+  "twclid",
+  "li_fat_id"
+], C = ["cid", "campaign_id"], R = [
+  "utm_source",
+  "utm_medium",
+  "utm_campaign",
+  "utm_term",
+  "utm_content",
+  "ref",
+  "referral",
+  "affiliate_id",
+  "click_id",
+  "ch_click_id",
+  "cid",
+  "campaign_id",
+  "gclid",
+  "gbraid",
+  "wbraid",
+  "dclid",
+  "msclkid",
+  "fbclid",
+  "ttclid",
+  "twclid",
+  "li_fat_id"
+], U = {
+  referral: "ref",
+  affiliate_id: "ref",
+  ch_click_id: "click_id",
+  cid: "campaign_id"
+}, P = ["email", "phone", "token", "auth", "password", "code"], T = 30, q = 256;
+function p(d, t = {}) {
+  const e = new URLSearchParams(d), i = L(e), s = m(i, S), r = m(i, C), o = D(e, t), a = {};
+  return s && (a.last_click_id = s), r && (a.campaign_id = r), Object.keys(o).length > 0 && (a.query_params = o), a;
+}
+function D(d, t) {
+  const e = {}, i = new Set(y(t.query_param_denylist, P)), s = _(
+    t.max_captured_query_params,
+    T
+  ), r = _(
+    t.max_query_param_value_length,
+    q
+  ), a = t.capture_all_query_params ?? !1 ? null : /* @__PURE__ */ new Set([
+    ...R.map(l),
+    ...y(t.capture_query_params, [])
+  ]);
+  for (const [c, b] of d.entries()) {
+    const u = l(c);
+    if (!u)
+      continue;
+    const h = U[u] ?? u;
+    if (i.has(u) || i.has(h) || a && !a.has(u))
+      continue;
+    const f = b.trim();
+    if (f) {
+      if (!(h in e) && Object.keys(e).length >= s)
+        break;
+      e[h] = f.slice(0, r);
+    }
+  }
+  return e;
+}
+function m(d, t) {
+  for (const e of t) {
+    const i = l(e), s = d[i]?.trim();
+    if (s)
+      return s;
+  }
+}
+function L(d) {
+  const t = {};
+  for (const [e, i] of d.entries()) {
+    const s = l(e);
+    !s || s in t || (t[s] = i);
+  }
+  return t;
+}
+function l(d) {
+  return d.trim().toLowerCase();
+}
+function y(d, t) {
+  const e = d ?? t, i = /* @__PURE__ */ new Set();
+  for (const s of e) {
+    if (typeof s != "string") continue;
+    const r = l(s);
+    r && i.add(r);
+  }
+  return Array.from(i);
+}
+function _(d, t) {
+  if (typeof d != "number" || !Number.isFinite(d))
+    return t;
+  const e = Math.floor(d);
+  return e < 0 ? t : e;
+}
+class n {
+  static client = null;
+  static storage = null;
+  static config = null;
+  static pageviewTrackerInstalled = !1;
+  static lastPageviewHref = null;
+  static emitAutoPageview = null;
+  static pendingAttribution = {};
+  static init(t) {
+    if (!n.client) {
+      const e = new x(t.cross_domain), i = new E(t);
+      n.client = new I(t, { storage: e, transport: i }), n.storage = e, n.config = t, n.refreshAttribution(e, t), typeof window < "u" && t.autocapture?.pageview && n.installPageviewTracking(t, e);
+    }
+    return n.client;
+  }
+  static track(t, e = {}) {
+    if (!n.client) {
+      console.warn("[Mark] Not initialized. Call init() first.");
+      return;
+    }
+    n.client.track(t, e);
+  }
+  static identify(t, e = {}) {
+    if (!n.client) {
+      console.warn("[Mark] Not initialized. Call init() first.");
+      return;
+    }
+    n.client.identify(t, e);
+  }
+  static conversion(t, e = {}) {
+    if (!n.client) {
+      console.warn("[Mark] Not initialized. Call init() first.");
+      return;
+    }
+    n.client.conversion(t, e);
+  }
+  static setConsent(t) {
+    if (!n.client) {
+      console.warn("[Mark] Not initialized. Call init() first.");
+      return;
+    }
+    n.client.setConsent(t), t === "granted" && (n.flushPendingAttribution(), n.emitAutoPageview?.());
+  }
+  /**
+   * Returns the current visitor ID when available.
+   * When consent is required (`require_consent: true` or `'auto'`), returns `undefined` until consent is granted.
+   * Use this to pass the visitor ID to your backend (e.g. in a header or request body) for server-side attribution
+   * when you do not have an authenticated user ID.
+   */
+  static getVisitorId() {
+    if (!(!n.client || !n.storage || !n.config || (n.config.require_consent ?? !1) && n.storage.getConsentStatus() !== "granted"))
+      return n.client.getVisitorId();
+  }
+  static installPageviewTracking(t, e) {
+    if (n.pageviewTrackerInstalled) return;
+    n.pageviewTrackerInstalled = !0;
+    const i = () => {
+      if (!n.client) return;
+      n.refreshAttribution(e, t);
+      const a = window.location.href;
+      if (a === n.lastPageviewHref) return;
+      n.client.track("page_view", {
+        site: window.location.host,
+        page: window.location.pathname,
+        title: document.title,
+        referrer: document.referrer || void 0
+      }) && (n.lastPageviewHref = a);
+    };
+    if (n.emitAutoPageview = i, i(), !(t.track_route_changes ?? !0)) return;
+    const r = history.pushState, o = history.replaceState;
+    history.pushState = function(...a) {
+      const c = r.apply(this, a);
+      return i(), c;
+    }, history.replaceState = function(...a) {
+      const c = o.apply(this, a);
+      return i(), c;
+    }, window.addEventListener("popstate", i);
+  }
+  static refreshAttribution(t, e) {
+    if (typeof window > "u")
+      return;
+    const i = p(window.location.search, e);
+    if (Object.keys(i).length !== 0) {
+      if (n.shouldPersistAttribution(t, e)) {
+        const s = n.mergeAttributionUpdates(n.pendingAttribution, i);
+        t.update(s), n.pendingAttribution = {};
+        return;
+      }
+      n.pendingAttribution = n.mergeAttributionUpdates(n.pendingAttribution, i);
+    }
+  }
+  static flushPendingAttribution() {
+    const t = n.storage, e = n.config;
+    if (!t || !e || typeof window > "u")
+      return;
+    const i = p(window.location.search, e), s = n.mergeAttributionUpdates(n.pendingAttribution, i);
+    Object.keys(s).length > 0 && t.update(s), n.pendingAttribution = {};
+  }
+  static shouldPersistAttribution(t, e) {
+    return e.require_consent ?? !1 ? t.getConsentStatus() === "granted" : !0;
+  }
+  static mergeAttributionUpdates(t, e) {
+    return {
+      ...t,
+      ...e,
+      query_params: {
+        ...t.query_params ?? {},
+        ...e.query_params ?? {}
+      }
+    };
+  }
+}
+typeof window < "u" && (window.Mark = n);
+export {
+  n as Mark,
+  n as default
+};

package/dist/browser.umd.js

@@ -0,0 +1 @@
+(function(u,l){typeof exports=="object"&&typeof module<"u"?l(exports):typeof define=="function"&&define.amd?define(["exports"],l):(u=typeof globalThis<"u"?globalThis:u||self,l(u.Mark={}))})(this,(function(u){"use strict";const l="https://ingest.onelence.com",v=new Set(["event_name","user_id","consent_state","source","is_conversion"]),A=new Set(["user_id","visitor_id","click_id","campaign_id","query","consent_state","source"]);class I{constructor(t,e){this.deps=e,this.validateConfig(t),this.config={endpoint:t.endpoint??l,...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}config;consentRequirement;siteId;siteHost;track(t,e={}){return this.trackInternal(t,e,!1)}trackInternal(t,e={},i=!1){if(!t)return this.config.debug&&console.warn("[Mark] track called without event name"),!1;if(!this.hasConsent())return this.config.debug&&console.warn("[Mark] Tracking blocked due to consent requirement."),!1;const s=this.sanitizeTrackData(e),r={...s};"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,...this.getIdentityFields(s),...r};i&&(o.is_conversion=!0);const a=s.site_id??this.siteId,c=s.site_host??this.siteHost;return a&&(o.site_id=a),c&&(o.site_host=c),this.config.include_page_context&&typeof window<"u"&&(this.applyPageContext(o),!c&&o.site&&(o.site_host=o.site)),this.deps.transport.send("/event",o),!0}identify(t,e={}){if(!t){this.config.debug&&console.warn("[Mark] identify called without userId");return}if(!this.hasConsent()){this.config.debug&&console.warn("[Mark] Identify blocked due to consent requirement.");return}const i={user_id:t,...this.sanitizeIdentifyTraits(e),...this.getIdentityFields()};this.siteId&&(i.site_id=this.siteId),this.siteHost&&(i.site_host=this.siteHost),this.deps.transport.send("/identify",i)}conversion(t,e={}){return this.trackInternal(t,e,!0)}getVisitorId(){return this.deps.storage.getVisitorId()}setConsent(t){this.deps.storage.setConsentStatus(t);const e={visitor_id:this.deps.storage.getVisitorId(),consent_state:t,source:"sdk"};this.siteId&&(e.site_id=this.siteId),this.siteHost&&(e.site_host=this.siteHost),this.deps.transport.send("/consent",e)}getIdentityFields(t){const e=t?.visitor_id??this.deps.storage.getVisitorId(),i=t?.click_id??this.deps.storage.getLastClickId(),s=t?.campaign_id??this.deps.storage.getCampaignId(),r=this.deps.storage.getQueryParams()??{},o=t?.query??{},a={...r,...o},c={};return e&&(c.visitor_id=e),i&&(c.click_id=i),s&&(c.campaign_id=s),Object.keys(a).length>0&&(c.query=a),c}hasConsent(){if(!this.consentRequirement)return!0;const e=this.deps.storage.getConsentStatus();return this.consentRequirement==="auto",e==="granted"}sanitizeTrackData(t){const e={};for(const[i,s]of Object.entries(t))v.has(i)||(e[i]=s);return e}sanitizeIdentifyTraits(t){const e={};for(const[i,s]of Object.entries(t))A.has(i)||(e[i]=s);return e}validateConfig(t){if(!t.key||!t.key.trim())throw new Error("[Mark] `key` must be a non-empty string.");if(t.endpoint)try{new URL(t.endpoint)}catch{throw new Error("[Mark] `endpoint` must be a valid absolute URL.")}if(typeof t.site_id=="string"&&!t.site_id.trim())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.")}applyPageContext(t){t.page||t.title||t.referrer||t.site||(t.site=window.location.host,t.page=window.location.pathname,t.title=document.title,document.referrer&&(t.referrer=document.referrer))}}class k{config;endpoint;constructor(t){this.validateConfig(t),this.config=t,this.endpoint=t.endpoint??l}async send(t,e){const i=this.joinUrl(this.endpoint,t),s=this.config.key,r={"Content-Type":"application/json",[s.startsWith("sk_")?"x-secret-key":"x-publishable-key"]:s};if(this.config.debug&&console.log("[Mark] Sending",i,e),typeof fetch!="function"){this.config.debug&&console.error("[Mark] Global fetch is not available in this runtime.");return}try{const o=await fetch(i,{method:"POST",headers:r,body:JSON.stringify(e),keepalive:!0});if(!o.ok&&this.config.debug){const a=await this.readErrorSnippet(o);console.error("[Mark] Request rejected",{url:i,status:o.status,statusText:o.statusText,body:a})}}catch(o){this.config.debug&&console.error("[Mark] Failed to send",i,o)}}joinUrl(t,e){const i=t.replace(/\/+$/,""),s=e.replace(/^\/+/,"");return`${i}/${s}`}async readErrorSnippet(t){try{return(await t.text()).slice(0,300)}catch{return""}}validateConfig(t){if(!t.key||!t.key.trim())throw new Error("[Mark] `key` must be a non-empty string.");if(t.endpoint)try{new URL(t.endpoint)}catch{throw new Error("[Mark] `endpoint` must be a valid absolute URL.")}}}const E="crelora_mark_data",p="crelora_mark_vid";class S{data;storageKey;options;bridgeFrame;bridgeReady=!1;bridgeOrigin;constructor(t){this.options=t??{},this.storageKey=this.options.storageKey??E,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)}getVisitorId(){return this.data.visitor_id}getLastClickId(){return this.data.last_click_id}getCampaignId(){return this.data.campaign_id}getQueryParams(){return this.data.query_params}getConsentStatus(){return this.data.consent_status}update(t){this.data={...this.data,...t},this.save()}setConsentStatus(t){this.data.consent_status=t,this.save()}load(){try{const e=localStorage.getItem(this.storageKey);if(e)return JSON.parse(e)}catch{}const t=this.getCookie(p);return t?{visitor_id:t}:{}}save(){try{localStorage.setItem(this.storageKey,JSON.stringify(this.data))}catch{}this.data.visitor_id&&this.isCookieEnabled()&&(this.setCookie(p,this.data.visitor_id,365),this.options.bridge?.url&&this.bridgeReady&&this.postBridgeMessage({type:"MARK_SYNC_UPDATE",visitorId:this.data.visitor_id}))}getCookie(t){try{const e=document.cookie.match(new RegExp(`(^| )${t}=([^;]+)`));if(e)return e[2]}catch{}return null}setCookie(t,e,i){try{const s=new Date(Date.now()+i*24*60*60*1e3),r=this.options.cookie_domain?`;domain=${this.options.cookie_domain}`:"";document.cookie=`${t}=${e};expires=${s.toUTCString()};path=/;SameSite=Lax${r}`}catch{}}generateUUID(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,t=>{const e=Math.random()*16|0;return(t==="x"?e:e&3|8).toString(16)})}isCookieEnabled(){return this.options.mode?this.options.mode==="single"||this.options.mode==="subdomain":!0}setupBridge(t){if(typeof document>"u")return;let e;try{e=new URL(t.url,window.location.href)}catch{return}this.bridgeOrigin=e.origin,this.bridgeFrame=document.createElement("iframe"),this.bridgeFrame.style.display="none",this.bridgeFrame.setAttribute("aria-hidden","true"),this.bridgeFrame.src=e.toString();const i=t.timeout_ms??3e3,s=setTimeout(()=>{window.removeEventListener("message",this.handleBridgeMessage)},i);window.addEventListener("message",this.handleBridgeMessage);const r=()=>{this.bridgeFrame&&document.body&&document.body.appendChild(this.bridgeFrame)};document.body?r():document.addEventListener("DOMContentLoaded",r,{once:!0}),this.bridgeFrame.addEventListener("load",()=>{clearTimeout(s),this.bridgeReady=!0,this.postBridgeMessage({type:"MARK_SYNC_REQUEST",visitorId:this.data.visitor_id})})}handleBridgeMessage=t=>{if(!this.bridgeFrame?.contentWindow||t.source!==this.bridgeFrame.contentWindow||!this.isDomainAllowed(t.origin))return;const e=t.data;!e||!e.type||e.type==="MARK_SYNC_RESPONSE"&&e.visitorId&&e.visitorId!==this.data.visitor_id&&(this.data.visitor_id=e.visitorId,this.save())};postBridgeMessage(t){this.bridgeFrame?.contentWindow&&this.bridgeFrame.contentWindow.postMessage(t,this.bridgeOrigin??"*")}isDomainAllowed(t){try{const e=new URL(t);if(this.options.allowed_domains?.length)return this.options.allowed_domains.some(s=>e.hostname===s||e.hostname.endsWith(`.${s}`));if(!this.bridgeOrigin)return!1;const i=new URL(this.bridgeOrigin);return e.hostname===i.hostname}catch{return!1}}}const x=["click_id","ch_click_id","gclid","gbraid","wbraid","dclid","msclkid","fbclid","ttclid","twclid","li_fat_id"],C=["cid","campaign_id"],R=["utm_source","utm_medium","utm_campaign","utm_term","utm_content","ref","referral","affiliate_id","click_id","ch_click_id","cid","campaign_id","gclid","gbraid","wbraid","dclid","msclkid","fbclid","ttclid","twclid","li_fat_id"],U={referral:"ref",affiliate_id:"ref",ch_click_id:"click_id",cid:"campaign_id"},P=["email","phone","token","auth","password","code"],T=30,q=256;function m(d,t={}){const e=new URLSearchParams(d),i=L(e),s=y(i,x),r=y(i,C),o=D(e,t),a={};return s&&(a.last_click_id=s),r&&(a.campaign_id=r),Object.keys(o).length>0&&(a.query_params=o),a}function D(d,t){const e={},i=new Set(_(t.query_param_denylist,P)),s=w(t.max_captured_query_params,T),r=w(t.max_query_param_value_length,q),a=t.capture_all_query_params??!1?null:new Set([...R.map(h),..._(t.capture_query_params,[])]);for(const[c,F]of d.entries()){const f=h(c);if(!f)continue;const g=U[f]??f;if(i.has(f)||i.has(g)||a&&!a.has(f))continue;const b=F.trim();if(b){if(!(g in e)&&Object.keys(e).length>=s)break;e[g]=b.slice(0,r)}}return e}function y(d,t){for(const e of t){const i=h(e),s=d[i]?.trim();if(s)return s}}function L(d){const t={};for(const[e,i]of d.entries()){const s=h(e);!s||s in t||(t[s]=i)}return t}function h(d){return d.trim().toLowerCase()}function _(d,t){const e=d??t,i=new Set;for(const s of e){if(typeof s!="string")continue;const r=h(s);r&&i.add(r)}return Array.from(i)}function w(d,t){if(typeof d!="number"||!Number.isFinite(d))return t;const e=Math.floor(d);return e<0?t:e}class n{static client=null;static storage=null;static config=null;static pageviewTrackerInstalled=!1;static lastPageviewHref=null;static emitAutoPageview=null;static pendingAttribution={};static init(t){if(!n.client){const e=new S(t.cross_domain),i=new k(t);n.client=new I(t,{storage:e,transport:i}),n.storage=e,n.config=t,n.refreshAttribution(e,t),typeof window<"u"&&t.autocapture?.pageview&&n.installPageviewTracking(t,e)}return n.client}static track(t,e={}){if(!n.client){console.warn("[Mark] Not initialized. Call init() first.");return}n.client.track(t,e)}static identify(t,e={}){if(!n.client){console.warn("[Mark] Not initialized. Call init() first.");return}n.client.identify(t,e)}static conversion(t,e={}){if(!n.client){console.warn("[Mark] Not initialized. Call init() first.");return}n.client.conversion(t,e)}static setConsent(t){if(!n.client){console.warn("[Mark] Not initialized. Call init() first.");return}n.client.setConsent(t),t==="granted"&&(n.flushPendingAttribution(),n.emitAutoPageview?.())}static getVisitorId(){if(!(!n.client||!n.storage||!n.config||(n.config.require_consent??!1)&&n.storage.getConsentStatus()!=="granted"))return n.client.getVisitorId()}static installPageviewTracking(t,e){if(n.pageviewTrackerInstalled)return;n.pageviewTrackerInstalled=!0;const i=()=>{if(!n.client)return;n.refreshAttribution(e,t);const a=window.location.href;if(a===n.lastPageviewHref)return;n.client.track("page_view",{site:window.location.host,page:window.location.pathname,title:document.title,referrer:document.referrer||void 0})&&(n.lastPageviewHref=a)};if(n.emitAutoPageview=i,i(),!(t.track_route_changes??!0))return;const r=history.pushState,o=history.replaceState;history.pushState=function(...a){const c=r.apply(this,a);return i(),c},history.replaceState=function(...a){const c=o.apply(this,a);return i(),c},window.addEventListener("popstate",i)}static refreshAttribution(t,e){if(typeof window>"u")return;const i=m(window.location.search,e);if(Object.keys(i).length!==0){if(n.shouldPersistAttribution(t,e)){const s=n.mergeAttributionUpdates(n.pendingAttribution,i);t.update(s),n.pendingAttribution={};return}n.pendingAttribution=n.mergeAttributionUpdates(n.pendingAttribution,i)}}static flushPendingAttribution(){const t=n.storage,e=n.config;if(!t||!e||typeof window>"u")return;const i=m(window.location.search,e),s=n.mergeAttributionUpdates(n.pendingAttribution,i);Object.keys(s).length>0&&t.update(s),n.pendingAttribution={}}static shouldPersistAttribution(t,e){return e.require_consent??!1?t.getConsentStatus()==="granted":!0}static mergeAttributionUpdates(t,e){return{...t,...e,query_params:{...t.query_params??{},...e.query_params??{}}}}}typeof window<"u"&&(window.Mark=n),u.Mark=n,u.default=n,Object.defineProperties(u,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})}));

package/dist/node.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c="https://ingest.onelence.com",l=new Set(["event_name","user_id","consent_state","source","is_conversion"]),f=new Set(["user_id","visitor_id","click_id","campaign_id","query","consent_state","source"]);class g{constructor(t,e){this.deps=e,this.validateConfig(t),this.config={endpoint:t.endpoint??c,...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}config;consentRequirement;siteId;siteHost;track(t,e={}){return this.trackInternal(t,e,!1)}trackInternal(t,e={},s=!1){if(!t)return this.config.debug&&console.warn("[Mark] track called without event name"),!1;if(!this.hasConsent())return this.config.debug&&console.warn("[Mark] Tracking blocked due to consent requirement."),!1;const i=this.sanitizeTrackData(e),r={...i};"query"in r&&delete r.query,"site_id"in r&&delete r.site_id,"site_host"in r&&delete r.site_host;const n={event_name:t,...this.getIdentityFields(i),...r};s&&(n.is_conversion=!0);const a=i.site_id??this.siteId,o=i.site_host??this.siteHost;return a&&(n.site_id=a),o&&(n.site_host=o),this.config.include_page_context&&typeof window<"u"&&(this.applyPageContext(n),!o&&n.site&&(n.site_host=n.site)),this.deps.transport.send("/event",n),!0}identify(t,e={}){if(!t){this.config.debug&&console.warn("[Mark] identify called without userId");return}if(!this.hasConsent()){this.config.debug&&console.warn("[Mark] Identify blocked due to consent requirement.");return}const s={user_id:t,...this.sanitizeIdentifyTraits(e),...this.getIdentityFields()};this.siteId&&(s.site_id=this.siteId),this.siteHost&&(s.site_host=this.siteHost),this.deps.transport.send("/identify",s)}conversion(t,e={}){return this.trackInternal(t,e,!0)}getVisitorId(){return this.deps.storage.getVisitorId()}setConsent(t){this.deps.storage.setConsentStatus(t);const e={visitor_id:this.deps.storage.getVisitorId(),consent_state:t,source:"sdk"};this.siteId&&(e.site_id=this.siteId),this.siteHost&&(e.site_host=this.siteHost),this.deps.transport.send("/consent",e)}getIdentityFields(t){const e=t?.visitor_id??this.deps.storage.getVisitorId(),s=t?.click_id??this.deps.storage.getLastClickId(),i=t?.campaign_id??this.deps.storage.getCampaignId(),r=this.deps.storage.getQueryParams()??{},n=t?.query??{},a={...r,...n},o={};return e&&(o.visitor_id=e),s&&(o.click_id=s),i&&(o.campaign_id=i),Object.keys(a).length>0&&(o.query=a),o}hasConsent(){if(!this.consentRequirement)return!0;const e=this.deps.storage.getConsentStatus();return this.consentRequirement==="auto",e==="granted"}sanitizeTrackData(t){const e={};for(const[s,i]of Object.entries(t))l.has(s)||(e[s]=i);return e}sanitizeIdentifyTraits(t){const e={};for(const[s,i]of Object.entries(t))f.has(s)||(e[s]=i);return e}validateConfig(t){if(!t.key||!t.key.trim())throw new Error("[Mark] `key` must be a non-empty string.");if(t.endpoint)try{new URL(t.endpoint)}catch{throw new Error("[Mark] `endpoint` must be a valid absolute URL.")}if(typeof t.site_id=="string"&&!t.site_id.trim())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.")}applyPageContext(t){t.page||t.title||t.referrer||t.site||(t.site=window.location.host,t.page=window.location.pathname,t.title=document.title,document.referrer&&(t.referrer=document.referrer))}}class _{config;endpoint;constructor(t){this.validateConfig(t),this.config=t,this.endpoint=t.endpoint??c}async send(t,e){const s=this.joinUrl(this.endpoint,t),i=this.config.key,r={"Content-Type":"application/json",[i.startsWith("sk_")?"x-secret-key":"x-publishable-key"]:i};if(this.config.debug&&console.log("[Mark] Sending",s,e),typeof fetch!="function"){this.config.debug&&console.error("[Mark] Global fetch is not available in this runtime.");return}try{const n=await fetch(s,{method:"POST",headers:r,body:JSON.stringify(e),keepalive:!0});if(!n.ok&&this.config.debug){const a=await this.readErrorSnippet(n);console.error("[Mark] Request rejected",{url:s,status:n.status,statusText:n.statusText,body:a})}}catch(n){this.config.debug&&console.error("[Mark] Failed to send",s,n)}}joinUrl(t,e){const s=t.replace(/\/+$/,""),i=e.replace(/^\/+/,"");return`${s}/${i}`}async readErrorSnippet(t){try{return(await t.text()).slice(0,300)}catch{return""}}validateConfig(t){if(!t.key||!t.key.trim())throw new Error("[Mark] `key` must be a non-empty string.");if(t.endpoint)try{new URL(t.endpoint)}catch{throw new Error("[Mark] `endpoint` must be a valid absolute URL.")}}}class u{constructor(t={}){this.defaults=t}getVisitorId(){return this.defaults.visitor_id}getLastClickId(){return this.defaults.last_click_id}getCampaignId(){return this.defaults.campaign_id}getQueryParams(){return this.defaults.query_params}getConsentStatus(){return this.defaults.consent_status}update(){}setConsentStatus(){}}class h{constructor(t){this.client=t}track(t,e={}){this.client.track(t,e)}conversion(t,e={}){this.client.conversion(t,e)}identify(t,e={}){this.client.identify(t,e)}setConsent(t){this.client.setConsent(t)}getVisitorId(){return this.client.getVisitorId()}}const p=(d,t={})=>{const e=t.storage??new u({visitor_id:t.storageDefaults?.visitor_id,last_click_id:t.storageDefaults?.last_click_id,campaign_id:t.storageDefaults?.campaign_id,query_params:t.storageDefaults?.query_params,consent_status:t.storageDefaults?.consent_status}),s=t.transport??new _(d),i=new g(d,{storage:e,transport:s});return new h(i)};exports.NodeMark=h;exports.StatelessStorage=u;exports.createNodeMark=p;