@aranova/tracking-next 0.17.2 → 0.18.0

package/dist/index.js

@@ -35,6 +35,7 @@ __export(src_exports, {
   ConsentBanner: () => ConsentBanner,
   DEFAULT_DECLINE_TTL_DAYS: () => DEFAULT_DECLINE_TTL_DAYS,
   DEFAULT_PHONE_COUNTRY: () => DEFAULT_PHONE_COUNTRY,
+  EVENT_SEMANTICS: () => EVENT_SEMANTICS,
   GoogleAdsTracking: () => GoogleAdsTracking,
   NAMED_RANGES: () => NAMED_RANGES,
   PhoneField: () => PhoneField,
@@ -55,6 +56,8 @@ __export(src_exports, {
   fromMinor: () => fromMinor,
   getConsentChoice: () => getConsentChoice,
   getConsentState: () => getConsentState,
+  getEventSemantics: () => getEventSemantics,
+  getTrackingConfigRuntime: () => getTrackingConfigRuntime,
   onConsentChange: () => onConsentChange,
   optIn: () => optIn,
   optOut: () => optOut,
@@ -302,6 +305,11 @@ function captureTrackingParamsFromLocation(url = typeof window === "undefined" ?
 }
 
 // ../tracking-core/src/gtag.ts
+var GTAG_SCRIPT_HOST = "https://www.googletagmanager.com/gtag/js";
+var TRACKING_SCRIPT_ATTRIBUTE = "data-aranova-tracking";
+function getScriptMarker(id) {
+  return `aranova-${id}`;
+}
 var GTAG_ID_PATTERN = /^[A-Z]{1,3}-[A-Za-z0-9_-]+$/;
 function isValidGtagId(id) {
   return GTAG_ID_PATTERN.test(id);
@@ -330,6 +338,15 @@ gtag('js', new Date());
 gtag('config', '${gtagId}');
 `.trim();
 }
+function ensureGtagFunction() {
+  window.dataLayer = window.dataLayer || [];
+  if (typeof window.gtag === "function") return window.gtag;
+  function gtag() {
+    window.dataLayer?.push(arguments);
+  }
+  window.gtag = gtag;
+  return window.gtag;
+}
 var SEND_TO_RE = /^AW-[A-Za-z0-9]+\/[A-Za-z0-9_-]+$/;
 function isValidSendTo(sendTo) {
   return SEND_TO_RE.test(sendTo);
@@ -348,6 +365,27 @@ function fireGtagConversion(input) {
     return false;
   }
 }
+function applyDefaultConsentState() {
+  const gtag = ensureGtagFunction();
+  gtag(
+    "consent",
+    "default",
+    buildConsentPayload(getConsentState() === "denied" ? "denied" : "granted")
+  );
+}
+function loadGtagScript(gtagId) {
+  if (typeof document === "undefined") return;
+  const marker = getScriptMarker("gtag-loader");
+  const existingScript = document.querySelector(
+    `script[${TRACKING_SCRIPT_ATTRIBUTE}="${marker}"]`
+  );
+  if (existingScript) return;
+  const script = document.createElement("script");
+  script.async = true;
+  script.src = `${GTAG_SCRIPT_HOST}?id=${encodeURIComponent(gtagId)}`;
+  script.setAttribute(TRACKING_SCRIPT_ATTRIBUTE, marker);
+  document.head.append(script);
+}
 function createGtagInitScriptMulti(gtagIds) {
   const safeIds = gtagIds.filter(isValidGtagId);
   const configs = safeIds.map((id) => `gtag('config', '${id}');`).join("\n");
@@ -634,6 +672,7 @@ function parseConversionConfig(raw) {
     business_id: typeof obj.business_id === "string" ? obj.business_id : void 0,
     customer_id: typeof obj.customer_id === "string" ? obj.customer_id : null,
     environment: typeof obj.environment === "string" ? obj.environment : void 0,
+    google_tracking_state: obj.google_tracking_state === "active" ? "active" : "disabled",
     gtag_ids: isStringMap(obj.gtag_ids) ? obj.gtag_ids : {},
     meta_pixel_ids: isStringMap(obj.meta_pixel_ids) ? obj.meta_pixel_ids : {},
     services,
@@ -680,9 +719,9 @@ function resolveConversionConfig(options) {
     }
   }
   function notifyResolved() {
-    const listeners = [...resolveListeners];
+    const listeners2 = [...resolveListeners];
     resolveListeners.clear();
-    for (const listener of listeners) {
+    for (const listener of listeners2) {
       try {
         listener();
       } catch {
@@ -769,6 +808,283 @@ function formatDateInTz(iso, timeZone, opts, locale) {
   }).format(date);
 }
 
+// ../tracking-core/src/resources/tracking-config-runtime.ts
+var CACHE_PREFIX2 = "_aranova_cfg_runtime_";
+var AUTHORITY_TTL_MS = 6e4;
+var runtimes = /* @__PURE__ */ new Map();
+var configuredIds = /* @__PURE__ */ new Set();
+var scriptLoad = null;
+var jsInitialized = false;
+function cacheKey2(url) {
+  return `${CACHE_PREFIX2}${url}`;
+}
+function readCache2(url) {
+  if (typeof window === "undefined") return null;
+  try {
+    const raw = window.sessionStorage.getItem(cacheKey2(url));
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    const config = parseConversionConfig(parsed.config);
+    if (!config) return null;
+    return {
+      etag: typeof parsed.etag === "string" ? parsed.etag : null,
+      config
+    };
+  } catch {
+    return null;
+  }
+}
+function writeCache2(url, entry) {
+  if (typeof window === "undefined") return;
+  try {
+    window.sessionStorage.setItem(cacheKey2(url), JSON.stringify(entry));
+  } catch {
+  }
+}
+function isTombstone(config) {
+  return config.google_tracking_state === "disabled" || Object.keys(config.gtag_ids).length === 0;
+}
+function validateConfig(config, ref) {
+  return config.business_id === ref.businessId && config.environment === ref.environment && (config.google_tracking_state === "active" || config.google_tracking_state === "disabled");
+}
+function pageViewSnapshot() {
+  if (typeof window === "undefined" || typeof document === "undefined") return null;
+  return {
+    href: window.location.href,
+    title: document.title || null,
+    referrer: document.referrer || null
+  };
+}
+function ensureScript(gtagId) {
+  if (typeof window === "undefined" || typeof document === "undefined") return Promise.resolve();
+  applyDefaultConsentState();
+  loadGtagScript(gtagId);
+  if (scriptLoad) return scriptLoad;
+  scriptLoad = new Promise((resolve) => {
+    const script = document.querySelector(
+      'script[data-aranova-tracking="aranova-gtag-loader"]'
+    );
+    if (!script) {
+      resolve();
+      return;
+    }
+    if (script.dataset.loaded === "true") {
+      resolve();
+      return;
+    }
+    window.setTimeout(resolve, 0);
+    script.addEventListener(
+      "load",
+      () => {
+        script.dataset.loaded = "true";
+        resolve();
+      },
+      { once: true }
+    );
+    script.addEventListener("error", () => resolve(), { once: true });
+  });
+  return scriptLoad;
+}
+var TrackingConfigRuntime = class {
+  constructor(ref, fetchImpl = globalThis.fetch) {
+    this.ref = ref;
+    this.fetchImpl = fetchImpl;
+    this.current = null;
+    this.etag = null;
+    this.stateValue = "unconfirmed";
+    this.confirmedAt = 0;
+    this.inFlight = null;
+    this.conversionQueue = [];
+    this.automaticQueue = [];
+    this.pageQueue = [];
+    this.listeners = /* @__PURE__ */ new Set();
+    const cached = readCache2(ref.cdnUrl);
+    this.current = cached?.config ?? null;
+    this.etag = cached?.etag ?? null;
+    void this.revalidate();
+    if (typeof window !== "undefined") {
+      window.addEventListener("visibilitychange", () => {
+        if (document.visibilityState === "visible") void this.revalidate();
+      });
+      window.addEventListener("focus", () => void this.revalidate());
+    }
+  }
+  state() {
+    return this.stateValue;
+  }
+  config() {
+    return this.stateValue === "active" || this.stateValue === "tombstone" ? this.current : null;
+  }
+  __unsafeExpireAuthorityForTests() {
+    this.confirmedAt = 0;
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  async ensureAuthority() {
+    if (this.stateValue !== "unconfirmed" && Date.now() - this.confirmedAt < AUTHORITY_TTL_MS) {
+      return true;
+    }
+    await this.revalidate();
+    return this.stateValue !== "unconfirmed" && Date.now() - this.confirmedAt < AUTHORITY_TTL_MS;
+  }
+  async revalidate() {
+    if (typeof window === "undefined" || !this.fetchImpl) return;
+    if (this.inFlight) return this.inFlight;
+    this.inFlight = this.revalidateNow().finally(() => {
+      this.inFlight = null;
+    });
+    return this.inFlight;
+  }
+  queuePageView(snapshot = pageViewSnapshot()) {
+    if (!snapshot) return;
+    this.pageQueue.push(snapshot);
+    void this.flush();
+  }
+  fireConversion(key, options) {
+    this.conversionQueue.push({ key, ...options });
+    void this.flush();
+  }
+  queueAutomaticEvent(eventType, metadata, transactionPath) {
+    this.automaticQueue.push({ eventType, metadata, transactionPath });
+    void this.flush();
+  }
+  listGoals() {
+    return this.current?.goals ?? [];
+  }
+  async revalidateNow() {
+    try {
+      const headers = {};
+      if (this.etag) headers["If-None-Match"] = this.etag;
+      const response = await this.fetchImpl(this.ref.cdnUrl, {
+        method: "GET",
+        headers,
+        cache: "no-cache"
+      });
+      if (response.status === 304 && this.current && validateConfig(this.current, this.ref)) {
+        this.confirm(this.current, this.etag);
+        await this.flush();
+        return;
+      }
+      if (!response.ok) {
+        this.expireAuthority();
+        return;
+      }
+      const next = parseConversionConfig(await response.json());
+      if (!next || !validateConfig(next, this.ref)) {
+        this.expireAuthority();
+        return;
+      }
+      if (this.current && next.config_version < this.current.config_version) {
+        this.expireAuthority();
+        return;
+      }
+      this.confirm(next, response.headers.get("ETag"));
+      await this.flush();
+    } catch {
+      this.expireAuthority();
+    }
+  }
+  expireAuthority() {
+    if (this.stateValue !== "unconfirmed") this.stateValue = "unconfirmed";
+  }
+  confirm(config, etag) {
+    this.current = config;
+    this.etag = etag;
+    this.confirmedAt = Date.now();
+    this.stateValue = isTombstone(config) ? "tombstone" : "active";
+    writeCache2(this.ref.cdnUrl, { etag, config });
+    if (this.stateValue === "tombstone") {
+      this.conversionQueue.length = 0;
+      this.automaticQueue.length = 0;
+      this.pageQueue.length = 0;
+    }
+    for (const listener of this.listeners) listener();
+  }
+  async flush() {
+    if (!await this.ensureAuthority()) return;
+    if (this.stateValue !== "active" || !this.current) return;
+    const ids = Object.values(this.current.gtag_ids).filter(
+      (id) => typeof id === "string" && isValidGtagId(id)
+    );
+    if (ids.length === 0) return;
+    await ensureScript(ids[0]);
+    const gtag = window.gtag;
+    if (typeof gtag !== "function") return;
+    if (!jsInitialized) {
+      gtag("js", /* @__PURE__ */ new Date());
+      jsInitialized = true;
+    }
+    for (const id of ids) {
+      if (configuredIds.has(id)) continue;
+      gtag("config", id, { send_page_view: false });
+      configuredIds.add(id);
+    }
+    while (this.pageQueue.length) {
+      const page = this.pageQueue.shift();
+      gtag("event", "page_view", {
+        page_location: page.href,
+        page_title: page.title ?? void 0,
+        page_referrer: page.referrer ?? void 0
+      });
+    }
+    while (this.automaticQueue.length) {
+      const event = this.automaticQueue.shift();
+      for (const goal of this.current.goals) {
+        if (goal.kind !== "event" || !goal.firing) continue;
+        if (!automaticThresholdMet(goal, event.eventType, event.metadata)) continue;
+        this.conversionQueue.push({
+          key: goal.key,
+          transactionId: `auto:${goal.key}:${event.transactionPath}`
+        });
+      }
+    }
+    while (this.conversionQueue.length) {
+      const item = this.conversionQueue.shift();
+      const goal = this.current.goals.find((g) => g.key === item.key);
+      const firing = goal?.firing;
+      if (!firing || getConsentState() === "denied") continue;
+      const currency = item.currency ?? firing.currency ?? null;
+      const value = item.value ?? (firing.value_cents != null && currency ? fromMinor(firing.value_cents, currency) : null);
+      fireGtagConversion({
+        sendTo: firing.send_to,
+        value,
+        currency,
+        transactionId: item.transactionId ?? null
+      });
+    }
+  }
+};
+function automaticThresholdMet(goal, eventType, metadata) {
+  const t = goal.trigger;
+  if (!t || t.event_type !== eventType) return false;
+  switch (eventType) {
+    case "scroll_depth":
+      return typeof metadata.depth_percent === "number" && t.threshold_percent != null && metadata.depth_percent >= t.threshold_percent;
+    case "time_on_site":
+      return typeof metadata.duration_ms === "number" && t.threshold_seconds != null && metadata.duration_ms >= t.threshold_seconds * 1e3;
+    case "multi_page_session":
+      return typeof metadata.page_count === "number" && t.page_threshold != null && metadata.page_count >= t.page_threshold;
+    case "specific_page_visit":
+      return typeof metadata.page_name === "string" && metadata.page_name === t.page_name;
+    case "page_view":
+    case "form_start":
+    case "phone_click":
+      return true;
+    default:
+      return false;
+  }
+}
+function getTrackingConfigRuntime(ref, fetchImpl) {
+  const key = `${ref.cdnUrl}|${ref.businessId}|${ref.environment}`;
+  const existing = runtimes.get(key);
+  if (existing) return existing;
+  const runtime = new TrackingConfigRuntime(ref, fetchImpl ?? globalThis.fetch);
+  runtimes.set(key, runtime);
+  return runtime;
+}
+
 // ../tracking-core/src/resources/conversion-autofire.ts
 function thresholdMet(goal, eventType, metadata) {
   const t = goal.trigger;
@@ -801,6 +1117,12 @@ function createConversionAutoFire(store) {
     for (const goal of store.listGoals()) {
       if (goal.kind !== "event" || !goal.firing) continue;
       if (!thresholdMet(goal, eventType, metadata)) continue;
+      if ("queueAutomaticEvent" in store) {
+        store.fireConversion(goal.key, {
+          transactionId: `auto:${goal.key}:${currentPath()}`
+        });
+        continue;
+      }
       const firing = goal.firing;
       const cents = firing.value_cents ?? null;
       const currency = firing.currency ?? null;
@@ -816,6 +1138,10 @@ function createConversionAutoFire(store) {
   }
   return {
     onAutomaticEvent(eventType, metadata) {
+      if ("queueAutomaticEvent" in store) {
+        store.queueAutomaticEvent(eventType, metadata, currentPath());
+        return;
+      }
       if (store.isReady()) {
         fireMatching(eventType, metadata);
         return;
@@ -1412,6 +1738,14 @@ var pageExitMetadataSchema = import_zod7.z.object({
   // null = left without any scroll signal; floor is 0 so a valid 0% is never
   // rejected (a single bad field 422s the whole keepalive beacon batch).
   max_scroll_percent: import_zod7.z.number().int().min(0).max(100).nullable(),
+  // The gating baseline: the fraction of the page visible at load with
+  // zero scrolling — or, for pages that grew after the post-paint snapshot
+  // (skeleton/streaming renders), the first-scroll position that
+  // established it. null = page had no scrollable range, or the segment
+  // ended before the snapshot. `.optional()` is load-bearing: SDK builds
+  // predating this field keep POSTing page_exit without the key —
+  // requiring it would 422 whole keepalive beacon batches.
+  scroll_baseline_percent: import_zod7.z.number().int().min(0).max(100).nullable().optional(),
   page: import_zod7.z.object({
     path: import_zod7.z.string()
   }).strict()
@@ -1487,69 +1821,154 @@ var timeOnSiteConfigSchema = import_zod11.z.object({
   thresholdSeconds: import_zod11.z.number().int().positive()
 }).strict();
 
+// ../tracking-core/src/events/semantics.ts
+var EVENT_SEMANTICS = {
+  page_view: {
+    label: "Page view",
+    category: "page",
+    outcomeRole: "navigation",
+    clientVisibility: "simple"
+  },
+  time_on_site: {
+    label: "Time on site",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "detailed"
+  },
+  specific_page_visit: {
+    label: "Key page visit",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "detailed"
+  },
+  scroll_depth: {
+    label: "Scroll depth",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "detailed"
+  },
+  multi_page_session: {
+    label: "Multi-page session",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "detailed"
+  },
+  form_start: {
+    label: "Form started",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "simple"
+  },
+  sdk_heartbeat: {
+    label: "SDK heartbeat",
+    category: "system",
+    outcomeRole: "diagnostic",
+    clientVisibility: "hidden"
+  },
+  page_exit: {
+    label: "Page exit",
+    category: "engagement",
+    outcomeRole: "diagnostic",
+    clientVisibility: "detailed"
+  },
+  form_submit: {
+    label: "Form submitted",
+    category: "lead",
+    outcomeRole: "lead",
+    clientVisibility: "simple"
+  },
+  phone_click: {
+    label: "Phone click",
+    category: "lead",
+    outcomeRole: "lead",
+    clientVisibility: "simple"
+  },
+  cta_click: {
+    label: "CTA click",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "simple"
+  }
+};
+function getEventSemantics(eventName) {
+  return eventName in EVENT_SEMANTICS ? EVENT_SEMANTICS[eventName] : null;
+}
+
 // ../tracking-core/src/events/registry.ts
 var EVENT_REGISTRY = {
   // --- automatic triggers ---
   page_view: {
     kind: "automatic",
+    semantics: EVENT_SEMANTICS.page_view,
     metadataSchema: pageViewMetadataSchema,
     configSchema: pageViewConfigSchema
   },
   time_on_site: {
     kind: "automatic",
+    semantics: EVENT_SEMANTICS.time_on_site,
     metadataSchema: timeOnSiteMetadataSchema,
     configSchema: timeOnSiteConfigSchema
   },
   specific_page_visit: {
     kind: "automatic",
+    semantics: EVENT_SEMANTICS.specific_page_visit,
     metadataSchema: specificPageVisitMetadataSchema,
     configSchema: specificPageVisitConfigSchema
   },
   scroll_depth: {
     kind: "automatic",
+    semantics: EVENT_SEMANTICS.scroll_depth,
     metadataSchema: scrollDepthMetadataSchema,
     configSchema: scrollDepthConfigSchema
   },
   multi_page_session: {
     kind: "automatic",
+    semantics: EVENT_SEMANTICS.multi_page_session,
     metadataSchema: multiPageSessionMetadataSchema,
     configSchema: multiPageSessionConfigSchema
   },
   form_start: {
     kind: "automatic",
+    semantics: EVENT_SEMANTICS.form_start,
     metadataSchema: formStartMetadataSchema,
     configSchema: formStartConfigSchema
   },
   // --- SDK-internal automatic (not consumer-configurable) ---
   sdk_heartbeat: {
     kind: "automatic",
+    semantics: EVENT_SEMANTICS.sdk_heartbeat,
     metadataSchema: sdkHeartbeatMetadataSchema,
     configSchema: sdkHeartbeatConfigSchema
   },
   page_exit: {
     kind: "automatic",
+    semantics: EVENT_SEMANTICS.page_exit,
     metadataSchema: pageExitMetadataSchema,
     configSchema: pageExitConfigSchema
   },
   // --- manual triggers ---
   form_submit: {
     kind: "manual",
+    semantics: EVENT_SEMANTICS.form_submit,
     metadataSchema: formSubmitMetadataSchema,
     configSchema: formSubmitConfigSchema
   },
   phone_click: {
     kind: "manual",
+    semantics: EVENT_SEMANTICS.phone_click,
     metadataSchema: phoneClickMetadataSchema,
     configSchema: phoneClickConfigSchema
   },
   cta_click: {
     kind: "manual",
+    semantics: EVENT_SEMANTICS.cta_click,
     metadataSchema: ctaClickMetadataSchema,
     configSchema: ctaClickConfigSchema
   }
 };
 var ALL_AUTOMATIC_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.kind === "automatic").map(([name]) => name);
 var ALL_MANUAL_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.kind === "manual").map(([name]) => name);
+var ALL_LEAD_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.semantics.outcomeRole === "lead").map(([name]) => name);
 function getEventDefinition(name) {
   return EVENT_REGISTRY[name];
 }
@@ -1636,6 +2055,97 @@ function attachTimeOnSite(client, config) {
   };
 }
 
+// ../tracking-core/src/triggers/navigation.ts
+var listeners = /* @__PURE__ */ new Set();
+var restorePatch = null;
+function notify() {
+  for (const listener of listeners) listener();
+}
+function notifyDeferred() {
+  setTimeout(notify, 0);
+}
+function installPatch() {
+  const originalPushState = history.pushState;
+  const originalReplaceState = history.replaceState;
+  function patchedPushState(...args) {
+    originalPushState.apply(this, args);
+    notifyDeferred();
+  }
+  function patchedReplaceState(...args) {
+    originalReplaceState.apply(this, args);
+    notifyDeferred();
+  }
+  history.pushState = patchedPushState;
+  history.replaceState = patchedReplaceState;
+  window.addEventListener("popstate", notify);
+  restorePatch = () => {
+    history.pushState = originalPushState;
+    history.replaceState = originalReplaceState;
+    window.removeEventListener("popstate", notify);
+    restorePatch = null;
+  };
+}
+function onHistoryChange(listener) {
+  if (listeners.size === 0) installPatch();
+  listeners.add(listener);
+  return () => {
+    if (!listeners.delete(listener)) return;
+    if (listeners.size === 0) restorePatch?.();
+  };
+}
+
+// ../tracking-core/src/triggers/scroll-measurement.ts
+var BOTTOM_EPSILON_PX = 2;
+function measureScrollPercent() {
+  const root = document.scrollingElement ?? document.documentElement;
+  const scrollHeight = root.scrollHeight;
+  const clientHeight = root.clientHeight;
+  if (scrollHeight <= 0 || clientHeight <= 0) return null;
+  if (scrollHeight <= clientHeight + BOTTOM_EPSILON_PX) return null;
+  const maxTop = scrollHeight - clientHeight;
+  const scrollTop = Math.min(Math.max(root.scrollTop, 0), maxTop);
+  if (scrollTop + clientHeight >= scrollHeight - BOTTOM_EPSILON_PX) return 100;
+  return Math.max(1, Math.min(100, Math.round((scrollTop + clientHeight) / scrollHeight * 100)));
+}
+function scheduleBaselineSnapshot(onSnapshot) {
+  let rafId = requestAnimationFrame(() => {
+    rafId = requestAnimationFrame(() => {
+      onSnapshot(measureScrollPercent());
+    });
+  });
+  return () => cancelAnimationFrame(rafId);
+}
+function createBaselineGate() {
+  let baselinePercent = null;
+  let ready = false;
+  let cancelSnapshot = null;
+  return {
+    rebaseline() {
+      cancelSnapshot?.();
+      ready = false;
+      baselinePercent = null;
+      cancelSnapshot = scheduleBaselineSnapshot((b) => {
+        baselinePercent = b;
+        ready = true;
+      });
+    },
+    cancel() {
+      cancelSnapshot?.();
+    },
+    baseline() {
+      return ready ? baselinePercent : null;
+    },
+    sample() {
+      if (!ready) return null;
+      if (baselinePercent === null) {
+        baselinePercent = measureScrollPercent();
+        return null;
+      }
+      return measureScrollPercent();
+    }
+  };
+}
+
 // ../tracking-core/src/triggers/scroll-depth.ts
 function attachScrollDepth(client, config) {
   if (typeof window === "undefined" || typeof document === "undefined") {
@@ -1646,17 +2156,14 @@ function attachScrollDepth(client, config) {
   let firedForPath = /* @__PURE__ */ new Set();
   let currentPath2 = window.location.pathname;
   let rafId = null;
-  function getScrollPercent() {
-    const doc = document.documentElement;
-    const scrollTop = window.scrollY || doc.scrollTop;
-    const scrollHeight = doc.scrollHeight;
-    const clientHeight = doc.clientHeight;
-    if (scrollHeight <= clientHeight) return 100;
-    return Math.round((scrollTop + clientHeight) / scrollHeight * 100);
-  }
+  const gate = createBaselineGate();
   function checkThresholds() {
-    const percent = getScrollPercent();
+    const percent = gate.sample();
+    if (percent === null) return;
+    const baseline = gate.baseline();
+    if (baseline === null) return;
     for (const threshold of thresholds) {
+      if (threshold <= baseline) continue;
       if (percent >= threshold && !firedForPath.has(threshold)) {
         firedForPath.add(threshold);
         client.trackEvent({
@@ -1683,28 +2190,15 @@ function attachScrollDepth(client, config) {
     if (newPath === currentPath2) return;
     currentPath2 = newPath;
     firedForPath = /* @__PURE__ */ new Set();
-    setTimeout(checkThresholds, 0);
-  }
-  const originalPushState = history.pushState.bind(history);
-  const originalReplaceState = history.replaceState.bind(history);
-  function patchedPushState(...args) {
-    originalPushState(...args);
-    setTimeout(resetIfPathChanged, 0);
-  }
-  function patchedReplaceState(...args) {
-    originalReplaceState(...args);
-    setTimeout(resetIfPathChanged, 0);
+    gate.rebaseline();
   }
-  history.pushState = patchedPushState;
-  history.replaceState = patchedReplaceState;
-  window.addEventListener("popstate", resetIfPathChanged);
+  const unsubscribeNav = onHistoryChange(resetIfPathChanged);
   window.addEventListener("scroll", onScroll, { passive: true });
-  setTimeout(checkThresholds, 0);
+  gate.rebaseline();
   return () => {
     if (rafId !== null) cancelAnimationFrame(rafId);
-    history.pushState = originalPushState;
-    history.replaceState = originalReplaceState;
-    window.removeEventListener("popstate", resetIfPathChanged);
+    gate.cancel();
+    unsubscribeNav();
     window.removeEventListener("scroll", onScroll);
   };
 }
@@ -1786,21 +2280,14 @@ function attachPageExit(client) {
   let accumulatedMs = 0;
   let maxScrollPercent = null;
   let rafId = null;
-  function getScrollPercent() {
-    const doc = document.documentElement;
-    const scrollTop = window.scrollY || doc.scrollTop;
-    const scrollHeight = doc.scrollHeight;
-    const clientHeight = doc.clientHeight;
-    if (scrollHeight <= clientHeight) return 100;
-    return Math.round((scrollTop + clientHeight) / scrollHeight * 100);
-  }
+  const gate = createBaselineGate();
   function onScroll() {
     if (rafId !== null) return;
     rafId = requestAnimationFrame(() => {
       rafId = null;
-      const percent = getScrollPercent();
-      if (percent >= 1 && (maxScrollPercent === null || percent > maxScrollPercent)) {
-        maxScrollPercent = Math.min(percent, 100);
+      const percent = gate.sample();
+      if (percent !== null && (maxScrollPercent === null || percent > maxScrollPercent)) {
+        maxScrollPercent = percent;
       }
     });
   }
@@ -1819,6 +2306,12 @@ function attachPageExit(client) {
       metadata: {
         dwell_ms: dwell,
         max_scroll_percent: maxScrollPercent,
+        // Lets the backend tell "scrolled to the bottom" apart from "the page
+        // was barely scrollable". null = unscrollable page or the segment
+        // ended before the post-paint snapshot landed. For pages that grew
+        // after the snapshot this is the first-scroll position, not the
+        // at-load fraction (see BaselineGate.baseline).
+        scroll_baseline_percent: gate.baseline(),
         page: { path }
       },
       pageUrl: window.location.href,
@@ -1836,6 +2329,7 @@ function attachPageExit(client) {
     emitSegment(currentPath2, false);
     currentPath2 = newPath;
     maxScrollPercent = null;
+    gate.rebaseline();
     accumulatedMs = 0;
     activeSince = document.visibilityState === "visible" ? Date.now() : null;
   }
@@ -1849,27 +2343,15 @@ function attachPageExit(client) {
   function onPageHide() {
     emitSegment(currentPath2, true);
   }
-  const originalPushState = history.pushState.bind(history);
-  const originalReplaceState = history.replaceState.bind(history);
-  function patchedPushState(...args) {
-    originalPushState(...args);
-    setTimeout(onNavigate, 0);
-  }
-  function patchedReplaceState(...args) {
-    originalReplaceState(...args);
-    setTimeout(onNavigate, 0);
-  }
-  history.pushState = patchedPushState;
-  history.replaceState = patchedReplaceState;
-  window.addEventListener("popstate", onNavigate);
+  const unsubscribeNav = onHistoryChange(onNavigate);
   window.addEventListener("scroll", onScroll, { passive: true });
   document.addEventListener("visibilitychange", onVisibilityChange);
   window.addEventListener("pagehide", onPageHide);
+  gate.rebaseline();
   return () => {
     if (rafId !== null) cancelAnimationFrame(rafId);
-    history.pushState = originalPushState;
-    history.replaceState = originalReplaceState;
-    window.removeEventListener("popstate", onNavigate);
+    gate.cancel();
+    unsubscribeNav();
     window.removeEventListener("scroll", onScroll);
     document.removeEventListener("visibilitychange", onVisibilityChange);
     window.removeEventListener("pagehide", onPageHide);
@@ -2084,6 +2566,14 @@ function fireRecordedConversions(firing, input, recorded, sale, currency) {
   const txnBase = input.external_id ?? sale.id;
   for (const item of recorded) {
     if (!item.service) continue;
+    if ("fireConversion" in firing) {
+      firing.fireConversion(item.service, {
+        value: item.amount_cents != null ? fromMinor(item.amount_cents, currency) : void 0,
+        currency,
+        transactionId: `${txnBase}:${item.service}`
+      });
+      continue;
+    }
     const config = firing.getFiring(item.service);
     if (!config) continue;
     const cents = item.amount_cents ?? config.value_cents ?? null;
@@ -2126,6 +2616,14 @@ function createSalesClient(config) {
     // recordSale is the intent-revealing alias — same behavior, clearer call site.
     recordSale: record,
     trackConversion(key, options) {
+      if (config.firing && "fireConversion" in config.firing) {
+        config.firing.fireConversion(key, {
+          value: options?.value ?? void 0,
+          currency: options?.currency ?? config.defaultCurrency ?? void 0,
+          transactionId: options?.transactionId ?? null
+        });
+        return;
+      }
       const firing = config.firing?.getFiring(key);
       if (!firing) return;
       const currency = firing.currency ?? options?.currency ?? config.defaultCurrency ?? null;
@@ -2631,14 +3129,24 @@ var ANIMATION_KEYFRAMES = `
 
 // src/AdPlatformTracking.tsx
 var import_script = __toESM(require("next/script"));
+var import_react3 = require("react");
 var import_jsx_runtime2 = require("react/jsx-runtime");
 function AdPlatformTracking({
   gtagId,
   gtagIds,
+  trackingConfig,
+  standalonePageView = false,
   metaPixelId,
   metaPixelIds
 }) {
-  const gtagAll = gtagIds ? Object.values(gtagIds).filter((id) => id != null) : gtagId ? [gtagId] : [];
+  const trackingConfigKey = trackingConfig ? `${trackingConfig.cdnUrl}:${trackingConfig.businessId}:${trackingConfig.environment}` : "";
+  (0, import_react3.useEffect)(() => {
+    if (!trackingConfig) return;
+    const runtime = getTrackingConfigRuntime(trackingConfig);
+    if (standalonePageView) runtime.queuePageView();
+    else void runtime.revalidate();
+  }, [trackingConfigKey, standalonePageView]);
+  const gtagAll = trackingConfig ? [] : gtagIds ? Object.values(gtagIds).filter((id) => id != null) : gtagId ? [gtagId] : [];
   const metaAll = metaPixelIds ? Object.values(metaPixelIds).filter((id) => id != null) : metaPixelId ? [metaPixelId] : [];
   const gtagLoaderId = gtagAll[0];
   const gtagInitScript = gtagAll.length === 1 ? createGtagInitScript(gtagAll[0]) : createGtagInitScriptMulti(gtagAll);
@@ -2685,20 +3193,20 @@ function GoogleAdsTracking(props) {
 }
 
 // src/factory.tsx
-var import_navigation = require("next/navigation");
+var import_navigation3 = require("next/navigation");
 
 // package.json
-var version = "0.17.2";
+var version = "0.18.0";
 
 // src/factory.tsx
-var import_react4 = require("react");
+var import_react5 = require("react");
 
 // ../tracking-core/src/phone-react.tsx
-var import_react3 = require("react");
+var import_react4 = require("react");
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var _phoneConfigContext;
 function phoneConfigContext() {
-  return _phoneConfigContext ?? (_phoneConfigContext = (0, import_react3.createContext)(null));
+  return _phoneConfigContext ?? (_phoneConfigContext = (0, import_react4.createContext)(null));
 }
 function PhoneConfigProvider({
   value,
@@ -2708,7 +3216,7 @@ function PhoneConfigProvider({
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Ctx.Provider, { value, children });
 }
 function usePhoneConfig() {
-  const ctx = (0, import_react3.useContext)(phoneConfigContext());
+  const ctx = (0, import_react4.useContext)(phoneConfigContext());
   return {
     defaultCountry: ctx?.defaultCountry ?? DEFAULT_PHONE_COUNTRY,
     display: ctx?.display ?? "national"
@@ -2719,10 +3227,10 @@ function usePhoneField(opts = {}) {
   const country = opts.country ?? cfg.defaultCountry;
   const display = opts.display ?? cfg.display;
   const { onValueChange } = opts;
-  const [value, setValue] = (0, import_react3.useState)(() => formatPhoneAsTyped(opts.defaultValue ?? "", country));
-  const [touched, setTouched] = (0, import_react3.useState)(false);
-  const parsed = (0, import_react3.useMemo)(() => parsePhone(value, country), [value, country]);
-  const onChange = (0, import_react3.useCallback)(
+  const [value, setValue] = (0, import_react4.useState)(() => formatPhoneAsTyped(opts.defaultValue ?? "", country));
+  const [touched, setTouched] = (0, import_react4.useState)(false);
+  const parsed = (0, import_react4.useMemo)(() => parsePhone(value, country), [value, country]);
+  const onChange = (0, import_react4.useCallback)(
     (event) => {
       const next = formatPhoneAsTyped(event.target.value, country);
       setValue(next);
@@ -2730,7 +3238,7 @@ function usePhoneField(opts = {}) {
     },
     [country, onValueChange]
   );
-  const onBlur = (0, import_react3.useCallback)(
+  const onBlur = (0, import_react4.useCallback)(
     (_event) => {
       setTouched(true);
       setValue((current) => {
@@ -2750,11 +3258,11 @@ function usePhoneField(opts = {}) {
     inputProps: { value, onChange, onBlur, type: "tel", inputMode: "tel", autoComplete: "tel" }
   };
 }
-var PhoneField = (0, import_react3.forwardRef)(function PhoneField2({ country, value, defaultValue, onChange, onE164Change, ...rest }, ref) {
+var PhoneField = (0, import_react4.forwardRef)(function PhoneField2({ country, value, defaultValue, onChange, onE164Change, ...rest }, ref) {
   const cfg = usePhoneConfig();
   const resolvedCountry = country ?? cfg.defaultCountry;
   const isControlled = value !== void 0;
-  const [internal, setInternal] = (0, import_react3.useState)(
+  const [internal, setInternal] = (0, import_react4.useState)(
     () => formatPhoneAsTyped(defaultValue ?? "", resolvedCountry)
   );
   const handleChange = (event) => {
@@ -2782,15 +3290,25 @@ var PhoneField = (0, import_react3.forwardRef)(function PhoneField2({ country, v
 // src/factory.tsx
 var import_jsx_runtime5 = require("react/jsx-runtime");
 function PageViewTracker({ fire }) {
-  const pathname = (0, import_navigation.usePathname)();
-  const searchParams = (0, import_navigation.useSearchParams)();
-  (0, import_react4.useEffect)(() => {
+  const pathname = (0, import_navigation3.usePathname)();
+  const searchParams = (0, import_navigation3.useSearchParams)();
+  (0, import_react5.useEffect)(() => {
     fire();
   }, [pathname, searchParams, fire]);
   return null;
 }
 function createTracking(options) {
-  const { apiKey, endpoint, triggers, environment, gtagIds, debug, phone, conversionConfig } = options;
+  const {
+    apiKey,
+    endpoint,
+    triggers,
+    environment,
+    gtagIds,
+    debug,
+    phone,
+    conversionConfig,
+    trackingConfig
+  } = options;
   if (!apiKey || !endpoint) {
     if (apiKey || endpoint) {
       console.warn(
@@ -2810,12 +3328,12 @@ function createTracking(options) {
       useTracking: () => noopClient
     };
   }
-  const TrackingContext = (0, import_react4.createContext)(null);
+  const TrackingContext = (0, import_react5.createContext)(null);
   const specificPageVisitConfig = triggers.automatic.specific_page_visit ?? null;
   const timeOnSiteConfig = triggers.automatic.time_on_site ?? null;
   function TrackingProvider({ children }) {
-    const pathname = (0, import_navigation.usePathname)();
-    const client = (0, import_react4.useMemo)(
+    const pathname = (0, import_navigation3.usePathname)();
+    const client = (0, import_react5.useMemo)(
       () => createTypedClient(
         getOrCreateTrackingClient({
           apiKey,
@@ -2833,18 +3351,18 @@ function createTracking(options) {
       ),
       []
     );
-    const conversionStore = (0, import_react4.useMemo)(
-      () => conversionConfig ? resolveConversionConfig({
+    const conversionStore = (0, import_react5.useMemo)(
+      () => trackingConfig ? getTrackingConfigRuntime(trackingConfig) : conversionConfig ? resolveConversionConfig({
         cdnUrl: conversionConfig.cdnUrl,
         baked: conversionConfig.baked
       }) : null,
       []
     );
-    const wrapClient = (0, import_react4.useMemo)(() => {
+    const wrapClient = (0, import_react5.useMemo)(() => {
       const autoFire = conversionStore ? createConversionAutoFire(conversionStore) : null;
       return (c) => autoFire ? withConversionAutoFire(c, autoFire) : c;
     }, [conversionStore]);
-    const firePageView = (0, import_react4.useCallback)(() => {
+    const firePageView = (0, import_react5.useCallback)(() => {
       const rawClient = getOrCreateTrackingClient({
         apiKey,
         endpoint,
@@ -2856,9 +3374,10 @@ function createTracking(options) {
         debug
       });
       fireManualPageView(wrapClient(rawClient));
+      if (trackingConfig) getTrackingConfigRuntime(trackingConfig).queuePageView();
     }, [wrapClient]);
-    const firedPagesRef = (0, import_react4.useRef)(/* @__PURE__ */ new Set());
-    (0, import_react4.useEffect)(() => {
+    const firedPagesRef = (0, import_react5.useRef)(/* @__PURE__ */ new Set());
+    (0, import_react5.useEffect)(() => {
       if (!specificPageVisitConfig || pathname === null) return;
       const rawClient = getOrCreateTrackingClient({
         apiKey,
@@ -2888,8 +3407,8 @@ function createTracking(options) {
       }
     }, [pathname]);
     const multiPageSessionConfig = triggers.automatic.multi_page_session ?? null;
-    const mpsLastPathRef = (0, import_react4.useRef)(null);
-    (0, import_react4.useEffect)(() => {
+    const mpsLastPathRef = (0, import_react5.useRef)(null);
+    (0, import_react5.useEffect)(() => {
       if (!multiPageSessionConfig || pathname === null) return;
       if (pathname === mpsLastPathRef.current) return;
       mpsLastPathRef.current = pathname;
@@ -2936,7 +3455,7 @@ function createTracking(options) {
       } catch {
       }
     }, [pathname]);
-    (0, import_react4.useEffect)(() => {
+    (0, import_react5.useEffect)(() => {
       const rawClient = getOrCreateTrackingClient({
         apiKey,
         endpoint,
@@ -2979,12 +3498,12 @@ function createTracking(options) {
       });
     }, []);
     return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(TrackingContext.Provider, { value: client, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react4.Suspense, { fallback: null, children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PageViewTracker, { fire: firePageView }) }),
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react5.Suspense, { fallback: null, children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PageViewTracker, { fire: firePageView }) }),
       /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PhoneConfigProvider, { value: phone ?? null, children })
     ] });
   }
   function useTracking() {
-    const client = (0, import_react4.useContext)(TrackingContext);
+    const client = (0, import_react5.useContext)(TrackingContext);
     if (client === null) {
       throw new Error(
         "useTracking must be called inside a <TrackingProvider> returned by createTracking()"
@@ -3001,6 +3520,7 @@ function createTracking(options) {
   ConsentBanner,
   DEFAULT_DECLINE_TTL_DAYS,
   DEFAULT_PHONE_COUNTRY,
+  EVENT_SEMANTICS,
   GoogleAdsTracking,
   NAMED_RANGES,
   PhoneField,
@@ -3021,6 +3541,8 @@ function createTracking(options) {
   fromMinor,
   getConsentChoice,
   getConsentState,
+  getEventSemantics,
+  getTrackingConfigRuntime,
   onConsentChange,
   optIn,
   optOut,