@aranova/tracking-next 0.14.2 → 0.16.0

package/dist/index.js

@@ -33,6 +33,7 @@ __export(src_exports, {
   AdPlatformTracking: () => AdPlatformTracking,
   AranovaApiError: () => AranovaApiError,
   ConsentBanner: () => ConsentBanner,
+  DEFAULT_DECLINE_TTL_DAYS: () => DEFAULT_DECLINE_TTL_DAYS,
   DEFAULT_PHONE_COUNTRY: () => DEFAULT_PHONE_COUNTRY,
   GoogleAdsTracking: () => GoogleAdsTracking,
   NAMED_RANGES: () => NAMED_RANGES,
@@ -52,7 +53,11 @@ __export(src_exports, {
   formatPhone: () => formatPhone,
   formatPhoneAsTyped: () => formatPhoneAsTyped,
   fromMinor: () => fromMinor,
+  getConsentChoice: () => getConsentChoice,
   getConsentState: () => getConsentState,
+  onConsentChange: () => onConsentChange,
+  optIn: () => optIn,
+  optOut: () => optOut,
   parsePhone: () => parsePhone,
   phoneField: () => phoneField,
   resetConsent: () => resetConsent,
@@ -67,6 +72,7 @@ __export(src_exports, {
   toMinor: () => toMinor,
   useConsent: () => useConsent,
   useConsentState: () => useConsentState,
+  useCookiePreferences: () => useCookiePreferences,
   useGclid: () => useGclid,
   usePhoneConfig: () => usePhoneConfig,
   usePhoneField: () => usePhoneField,
@@ -77,13 +83,30 @@ module.exports = __toCommonJS(src_exports);
 // ../tracking-core/src/consent.ts
 var CONSENT_STATE_KEY = "consent_state";
 var CONSENT_TIMESTAMP_KEY = "consent_timestamp";
-var grantedListeners = /* @__PURE__ */ new Set();
-function onConsentGranted(listener) {
-  grantedListeners.add(listener);
+var CONSENT_EXPIRES_AT_KEY = "consent_expires_at";
+var DEFAULT_DECLINE_TTL_DAYS = 90;
+var DAY_MS = 864e5;
+var DEFAULT_CHOICE = {
+  state: "granted",
+  source: "default",
+  updatedAt: null,
+  expiresAt: null
+};
+var changeListeners = /* @__PURE__ */ new Set();
+function onConsentChange(listener) {
+  changeListeners.add(listener);
   return () => {
-    grantedListeners.delete(listener);
+    changeListeners.delete(listener);
   };
 }
+function notifyConsentChanged(choice) {
+  for (const listener of changeListeners) {
+    try {
+      listener(choice);
+    } catch {
+    }
+  }
+}
 function buildConsentPayload(state) {
   return {
     ad_storage: state,
@@ -92,42 +115,88 @@ function buildConsentPayload(state) {
     analytics_storage: state
   };
 }
-function getConsentState() {
-  if (typeof window === "undefined") return "pending";
+function getConsentChoice() {
+  if (typeof window === "undefined") return DEFAULT_CHOICE;
   try {
-    const storedState = window.localStorage.getItem(CONSENT_STATE_KEY);
-    if (storedState === "granted" || storedState === "denied") return storedState;
+    const stored = window.localStorage.getItem(CONSENT_STATE_KEY);
+    const updatedAt = window.localStorage.getItem(CONSENT_TIMESTAMP_KEY);
+    if (stored === "granted")
+      return { state: "granted", source: "explicit", updatedAt, expiresAt: null };
+    if (stored === "denied") {
+      let expiresAt = window.localStorage.getItem(CONSENT_EXPIRES_AT_KEY);
+      if (!expiresAt) {
+        expiresAt = new Date(Date.now() + DEFAULT_DECLINE_TTL_DAYS * DAY_MS).toISOString();
+        try {
+          window.localStorage.setItem(CONSENT_EXPIRES_AT_KEY, expiresAt);
+        } catch {
+        }
+      }
+      if (!(Date.parse(expiresAt) <= Date.now()))
+        return { state: "denied", source: "explicit", updatedAt, expiresAt };
+    }
   } catch {
   }
-  return "pending";
+  return DEFAULT_CHOICE;
 }
-function setConsentState(state) {
+function getConsentState() {
+  return getConsentChoice().state;
+}
+function pushConsentToPlatforms(state) {
   if (typeof window === "undefined") return;
-  try {
-    window.localStorage.setItem(CONSENT_STATE_KEY, state);
-    window.localStorage.setItem(CONSENT_TIMESTAMP_KEY, (/* @__PURE__ */ new Date()).toISOString());
-  } catch {
-  }
   if (typeof window.gtag === "function")
     window.gtag("consent", "update", buildConsentPayload(state));
   if (typeof window.fbq === "function")
     window.fbq("consent", state === "granted" ? "grant" : "revoke");
-  if (state === "granted") {
-    for (const listener of grantedListeners) {
-      try {
-        listener();
-      } catch {
-      }
+}
+function setConsentState(state, options) {
+  if (typeof window === "undefined") return;
+  const requestedTtl = options?.declineTtlDays;
+  const ttlDays = typeof requestedTtl === "number" && Number.isFinite(requestedTtl) && requestedTtl > 0 ? requestedTtl : DEFAULT_DECLINE_TTL_DAYS;
+  const updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const expiresAt = state === "denied" ? new Date(Date.now() + ttlDays * DAY_MS).toISOString() : null;
+  try {
+    window.localStorage.setItem(CONSENT_STATE_KEY, state);
+    window.localStorage.setItem(CONSENT_TIMESTAMP_KEY, updatedAt);
+    if (expiresAt !== null) {
+      window.localStorage.setItem(CONSENT_EXPIRES_AT_KEY, expiresAt);
+    } else {
+      window.localStorage.removeItem(CONSENT_EXPIRES_AT_KEY);
     }
+  } catch {
   }
+  pushConsentToPlatforms(state);
+  notifyConsentChanged({ state, source: "explicit", updatedAt, expiresAt });
+}
+function optIn() {
+  setConsentState("granted");
+}
+function optOut(options) {
+  setConsentState("denied", options);
 }
 function resetConsent() {
   if (typeof window === "undefined") return;
   try {
     window.localStorage.removeItem(CONSENT_STATE_KEY);
     window.localStorage.removeItem(CONSENT_TIMESTAMP_KEY);
+    window.localStorage.removeItem(CONSENT_EXPIRES_AT_KEY);
   } catch {
   }
+  pushConsentToPlatforms("granted");
+  notifyConsentChanged(DEFAULT_CHOICE);
+}
+function createEffectiveConsentSnippet() {
+  return `
+var aranovaConsent = (function () {
+  try {
+    if (window.localStorage.getItem('${CONSENT_STATE_KEY}') === 'denied') {
+      var exp = window.localStorage.getItem('${CONSENT_EXPIRES_AT_KEY}');
+      var expMs = exp ? Date.parse(exp) : NaN;
+      if (!(expMs <= Date.now())) return 'denied';
+    }
+  } catch (e) {}
+  return 'granted';
+})();
+`.trim();
 }
 
 // ../tracking-core/src/tracking.ts
@@ -242,12 +311,12 @@ function createConsentDefaultScript() {
 window.dataLayer = window.dataLayer || [];
 function gtag(){dataLayer.push(arguments);}
 window.gtag = gtag;
+${createEffectiveConsentSnippet()}
 gtag('consent', 'default', {
-  ad_storage: 'denied',
-  ad_user_data: 'denied',
-  ad_personalization: 'denied',
-  analytics_storage: 'denied',
-  wait_for_update: 500,
+  ad_storage: aranovaConsent,
+  ad_user_data: aranovaConsent,
+  ad_personalization: aranovaConsent,
+  analytics_storage: aranovaConsent
 });
 `.trim();
 }
@@ -261,21 +330,6 @@ gtag('js', new Date());
 gtag('config', '${gtagId}');
 `.trim();
 }
-function createConsentRestoreScript() {
-  return `
-try {
-  var consentState = window.localStorage.getItem('consent_state');
-  if (window.gtag && (consentState === 'granted' || consentState === 'denied')) {
-    window.gtag('consent', 'update', {
-      ad_storage: consentState,
-      ad_user_data: consentState,
-      ad_personalization: consentState,
-      analytics_storage: consentState,
-    });
-  }
-} catch (e) {}
-`.trim();
-}
 var SEND_TO_RE = /^AW-[A-Za-z0-9]+\/[A-Za-z0-9_-]+$/;
 function isValidSendTo(sendTo) {
   return SEND_TO_RE.test(sendTo);
@@ -354,7 +408,8 @@ document,'script','${FB_EVENTS_SCRIPT_HOST}');`.trim();
 }
 function createMetaConsentDefaultScript() {
   return `${fbqStubScript()}
-fbq('consent', 'revoke');`;
+${createEffectiveConsentSnippet()}
+fbq('consent', aranovaConsent === 'denied' ? 'revoke' : 'grant');`;
 }
 function createMetaPixelInitScript(pixelId) {
   if (!isValidMetaPixelId(pixelId)) return "";
@@ -367,14 +422,71 @@ function createMetaPixelInitScriptMulti(pixelIds) {
   return `${inits.join("\n")}
 fbq('track', 'PageView');`;
 }
-function createMetaConsentRestoreScript() {
-  return `
-try {
-  var consentState = window.localStorage.getItem('consent_state');
-  if (window.fbq && (consentState === 'granted' || consentState === 'denied')) {
-    window.fbq('consent', consentState === 'granted' ? 'grant' : 'revoke');
+
+// ../tracking-core/src/landing.ts
+var LANDING_STORAGE_KEY = "_aranova_track_landing";
+var memoryRecord = null;
+function sanitizeParams(value) {
+  if (typeof value !== "object" || value === null) return {};
+  const source = value;
+  return TRACKING_PARAM_KEYS.reduce((params, key) => {
+    const entry = source[key];
+    if (typeof entry === "string" && entry.length > 0) params[key] = entry;
+    return params;
+  }, {});
+}
+function readStoredRecord() {
+  try {
+    const raw = window.localStorage.getItem(LANDING_STORAGE_KEY);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.session_id !== "string" || parsed.session_id.length === 0) return null;
+    return { session_id: parsed.session_id, params: sanitizeParams(parsed.params) };
+  } catch {
+    return null;
   }
-} catch (e) {}`.trim();
+}
+function writeRecord(record) {
+  memoryRecord = record;
+  try {
+    window.localStorage.setItem(LANDING_STORAGE_KEY, JSON.stringify(record));
+  } catch {
+  }
+}
+function captureFromUrl(url) {
+  try {
+    const resolved = new URL(url ?? window.location.href, window.location.origin);
+    return getTrackingQueryValues(resolved.searchParams);
+  } catch {
+    return {};
+  }
+}
+function getOrCaptureLandingParams(sessionId, url) {
+  if (typeof window === "undefined") return {};
+  const stored = readStoredRecord();
+  if (stored && stored.session_id === sessionId) {
+    memoryRecord = stored;
+    return stored.params;
+  }
+  if (memoryRecord && memoryRecord.session_id === sessionId) {
+    return memoryRecord.params;
+  }
+  const record = { session_id: sessionId, params: captureFromUrl(url) };
+  writeRecord(record);
+  return record.params;
+}
+function buildLandingPayloadFields(sessionId, override) {
+  const params = override ?? (typeof window === "undefined" ? null : getOrCaptureLandingParams(sessionId));
+  if (params === null) return {};
+  return {
+    landing_gclid: params.gclid ?? null,
+    landing_fbclid: params.fbclid ?? null,
+    landing_utm_source: params.utm_source ?? null,
+    landing_utm_medium: params.utm_medium ?? null,
+    landing_utm_campaign: params.utm_campaign ?? null,
+    landing_utm_term: params.utm_term ?? null,
+    landing_utm_content: params.utm_content ?? null
+  };
 }
 
 // ../tracking-core/src/payloads.ts
@@ -403,6 +515,9 @@ function createTrackingSessionUpsertPayload(trackingParams, input, context) {
     utm_campaign: trackingParams.utm_campaign,
     utm_term: trackingParams.utm_term,
     utm_content: trackingParams.utm_content,
+    // Omitted entirely when the landing isn't observable (SSR, no override) —
+    // present-as-null would wrongly tell the backend "landed with no params".
+    ...buildLandingPayloadFields(input.sessionId, input.landingParams),
     first_page: input.firstPage ?? null,
     consent_state: input.consentState ?? null,
     context
@@ -424,8 +539,6 @@ function createTrackingEventCreatePayload(trackingParams, input, context) {
 
 // ../tracking-core/src/resources/conversion-firing.ts
 var DEDUP_PREFIX = "_aranova_conv_";
-var MAX_PENDING = 100;
-var pendingQueue = [];
 function dedupKey(input) {
   return `${DEDUP_PREFIX}${input.transactionId ?? ""}:${input.sendTo}`;
 }
@@ -449,23 +562,9 @@ function fireOnce(input) {
   if (fireGtagConversion(input)) markFired(input);
 }
 function fireConversionWithConsent(input) {
-  const state = getConsentState();
-  if (state === "denied") return;
-  if (state === "pending") {
-    if (pendingQueue.length >= MAX_PENDING) pendingQueue.shift();
-    pendingQueue.push(input);
-    return;
-  }
+  if (getConsentState() === "denied") return;
   fireOnce(input);
 }
-function flushPendingConversions() {
-  if (getConsentState() !== "granted") return;
-  while (pendingQueue.length > 0) {
-    const input = pendingQueue.shift();
-    if (input) fireOnce(input);
-  }
-}
-if (typeof window !== "undefined") onConsentGranted(flushPendingConversions);
 
 // ../tracking-core/src/resources/conversion-config.ts
 function isStringMap(value) {
@@ -973,7 +1072,13 @@ function readTrackingParams() {
 }
 function consentSnapshot() {
   try {
-    return { state: getConsentState() };
+    const choice = getConsentChoice();
+    return {
+      state: choice.state,
+      source: choice.source,
+      updated_at: choice.updatedAt,
+      expires_at: choice.expiresAt
+    };
   } catch {
     return null;
   }
@@ -1046,6 +1151,7 @@ function createTrackingClient(config) {
       initialParams = captureTrackingParamsFromLocation();
     } catch {
     }
+    getOrCaptureLandingParams(sessionId);
     try {
       captureFbc();
     } catch {
@@ -1095,6 +1201,11 @@ function createTrackingClient(config) {
       utm_campaign: params.utm_campaign,
       utm_term: params.utm_term,
       utm_content: params.utm_content,
+      // Landing params for the CURRENT session id — captured on the spot when
+      // the session just rotated (the current URL is the rotated session's
+      // landing), reused from the stored record otherwise. Keys are omitted
+      // entirely when the landing isn't observable (SSR).
+      ...buildLandingPayloadFields(sessionId),
       first_page: firstPage,
       consent_state: consentSnapshot(),
       context
@@ -1162,6 +1273,7 @@ function createTrackingClient(config) {
   return {
     trackEvent,
     flush,
+    flushBeacon: flushOnUnload,
     getSessionId: () => sessionId,
     getVisitorId: () => visitorId,
     destroy: () => {
@@ -1186,9 +1298,17 @@ var ctaClickMetadataSchema = import_zod2.z.object({
     path: import_zod2.z.string()
   }).strict(),
   section: import_zod2.z.string().nullable().optional(),
-  destination_url: import_zod2.z.string().nullable().optional()
+  destination_url: import_zod2.z.string().nullable().optional(),
+  // Set by auto-capture (and available to manual callers): the link target
+  // and a short element descriptor (tag#id) for tying clicks to specific UI.
+  href: import_zod2.z.string().nullable().optional(),
+  element: import_zod2.z.string().nullable().optional()
+}).strict();
+var ctaClickConfigSchema = import_zod2.z.object({
+  autoCapture: import_zod2.z.object({
+    selector: import_zod2.z.string().optional()
+  }).strict().optional()
 }).strict();
-var ctaClickConfigSchema = import_zod2.z.object({}).strict();
 
 // ../tracking-core/src/events/sdk-heartbeat.ts
 var import_zod3 = require("zod");
@@ -1264,31 +1384,44 @@ var multiPageSessionConfigSchema = import_zod6.z.object({
   pageThreshold: import_zod6.z.number().int().min(2)
 }).strict();
 
-// ../tracking-core/src/events/phone-click.ts
+// ../tracking-core/src/events/page-exit.ts
 var import_zod7 = require("zod");
-var phoneClickMetadataSchema = import_zod7.z.object({
-  phone_number: import_zod7.z.string(),
+var pageExitMetadataSchema = import_zod7.z.object({
+  dwell_ms: import_zod7.z.number().int().min(0),
+  // 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(),
   page: import_zod7.z.object({
     path: import_zod7.z.string()
-  }).strict(),
-  section: import_zod7.z.string().nullable().optional()
+  }).strict()
 }).strict();
-var phoneClickConfigSchema = import_zod7.z.object({}).strict();
+var pageExitConfigSchema = import_zod7.z.object({}).strict();
 
-// ../tracking-core/src/events/scroll-depth.ts
+// ../tracking-core/src/events/phone-click.ts
 var import_zod8 = require("zod");
-var scrollDepthMetadataSchema = import_zod8.z.object({
-  depth_percent: import_zod8.z.number().int().min(1).max(100),
+var phoneClickMetadataSchema = import_zod8.z.object({
+  phone_number: import_zod8.z.string(),
   page: import_zod8.z.object({
     path: import_zod8.z.string()
+  }).strict(),
+  section: import_zod8.z.string().nullable().optional()
+}).strict();
+var phoneClickConfigSchema = import_zod8.z.object({}).strict();
+
+// ../tracking-core/src/events/scroll-depth.ts
+var import_zod9 = require("zod");
+var scrollDepthMetadataSchema = import_zod9.z.object({
+  depth_percent: import_zod9.z.number().int().min(1).max(100),
+  page: import_zod9.z.object({
+    path: import_zod9.z.string()
   }).strict()
 }).strict();
-var scrollDepthConfigSchema = import_zod8.z.object({
-  thresholds: import_zod8.z.array(import_zod8.z.number().int().min(1).max(100)).min(1)
+var scrollDepthConfigSchema = import_zod9.z.object({
+  thresholds: import_zod9.z.array(import_zod9.z.number().int().min(1).max(100)).min(1)
 }).strict();
 
 // ../tracking-core/src/events/specific-page-visit.ts
-var import_zod9 = require("zod");
+var import_zod10 = require("zod");
 var SPECIFIC_PAGE_NAMES = [
   "contact_page",
   "about_page",
@@ -1299,18 +1432,18 @@ var SPECIFIC_PAGE_NAMES = [
   "faq_page",
   "testimonials_page"
 ];
-var specificPageNameSchema = import_zod9.z.enum(SPECIFIC_PAGE_NAMES);
-var specificPageVisitMetadataSchema = import_zod9.z.object({
+var specificPageNameSchema = import_zod10.z.enum(SPECIFIC_PAGE_NAMES);
+var specificPageVisitMetadataSchema = import_zod10.z.object({
   page_name: specificPageNameSchema,
-  page: import_zod9.z.object({
-    path: import_zod9.z.string()
+  page: import_zod10.z.object({
+    path: import_zod10.z.string()
   }).strict()
 }).strict();
-var specificPageVisitConfigSchema = import_zod9.z.object({
-  pages: import_zod9.z.array(
-    import_zod9.z.object({
+var specificPageVisitConfigSchema = import_zod10.z.object({
+  pages: import_zod10.z.array(
+    import_zod10.z.object({
       name: specificPageNameSchema,
-      pathPattern: import_zod9.z.custom((value) => value instanceof RegExp, {
+      pathPattern: import_zod10.z.custom((value) => value instanceof RegExp, {
         message: "pathPattern must be a RegExp"
       })
     }).strict()
@@ -1318,15 +1451,15 @@ var specificPageVisitConfigSchema = import_zod9.z.object({
 }).strict();
 
 // ../tracking-core/src/events/time-on-site.ts
-var import_zod10 = require("zod");
-var timeOnSiteMetadataSchema = import_zod10.z.object({
-  duration_ms: import_zod10.z.number().int().nonnegative(),
-  page: import_zod10.z.object({
-    path: import_zod10.z.string()
+var import_zod11 = require("zod");
+var timeOnSiteMetadataSchema = import_zod11.z.object({
+  duration_ms: import_zod11.z.number().int().nonnegative(),
+  page: import_zod11.z.object({
+    path: import_zod11.z.string()
   }).strict()
 }).strict();
-var timeOnSiteConfigSchema = import_zod10.z.object({
-  thresholdSeconds: import_zod10.z.number().int().positive()
+var timeOnSiteConfigSchema = import_zod11.z.object({
+  thresholdSeconds: import_zod11.z.number().int().positive()
 }).strict();
 
 // ../tracking-core/src/events/registry.ts
@@ -1368,6 +1501,11 @@ var EVENT_REGISTRY = {
     metadataSchema: sdkHeartbeatMetadataSchema,
     configSchema: sdkHeartbeatConfigSchema
   },
+  page_exit: {
+    kind: "automatic",
+    metadataSchema: pageExitMetadataSchema,
+    configSchema: pageExitConfigSchema
+  },
   // --- manual triggers ---
   form_submit: {
     kind: "manual",
@@ -1611,6 +1749,163 @@ function attachFormStart(client, config) {
   };
 }
 
+// ../tracking-core/src/triggers/page-exit.ts
+function attachPageExit(client) {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return () => {
+    };
+  }
+  let currentPath2 = window.location.pathname;
+  let activeSince = document.visibilityState === "visible" ? Date.now() : null;
+  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);
+  }
+  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);
+      }
+    });
+  }
+  function settledDwellMs() {
+    let total = accumulatedMs;
+    if (activeSince !== null) {
+      total += Date.now() - activeSince;
+    }
+    return Math.max(0, Math.round(total));
+  }
+  function emitSegment(path, flush) {
+    const dwell = settledDwellMs();
+    if (dwell === 0) return;
+    client.trackEvent({
+      eventType: "page_exit",
+      metadata: {
+        dwell_ms: dwell,
+        max_scroll_percent: maxScrollPercent,
+        page: { path }
+      },
+      pageUrl: window.location.href,
+      occurredAt: null
+    });
+    if (flush) {
+      client.flushBeacon();
+    }
+    accumulatedMs = 0;
+    activeSince = document.visibilityState === "visible" ? Date.now() : null;
+  }
+  function onNavigate() {
+    const newPath = window.location.pathname;
+    if (newPath === currentPath2) return;
+    emitSegment(currentPath2, false);
+    currentPath2 = newPath;
+    maxScrollPercent = null;
+    accumulatedMs = 0;
+    activeSince = document.visibilityState === "visible" ? Date.now() : null;
+  }
+  function onVisibilityChange() {
+    if (document.visibilityState === "hidden") {
+      emitSegment(currentPath2, true);
+    } else {
+      activeSince = Date.now();
+    }
+  }
+  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);
+  window.addEventListener("scroll", onScroll, { passive: true });
+  document.addEventListener("visibilitychange", onVisibilityChange);
+  window.addEventListener("pagehide", onPageHide);
+  return () => {
+    if (rafId !== null) cancelAnimationFrame(rafId);
+    history.pushState = originalPushState;
+    history.replaceState = originalReplaceState;
+    window.removeEventListener("popstate", onNavigate);
+    window.removeEventListener("scroll", onScroll);
+    document.removeEventListener("visibilitychange", onVisibilityChange);
+    window.removeEventListener("pagehide", onPageHide);
+  };
+}
+
+// ../tracking-core/src/triggers/cta-click-capture.ts
+var DEFAULT_CTA_SELECTOR = "[data-aranova-cta]";
+var CTA_NAME_MAX_LENGTH = 120;
+function describeElement(el) {
+  const tag = el.tagName.toLowerCase();
+  return el.id ? `${tag}#${el.id}` : tag;
+}
+function resolveCtaName(el) {
+  const explicit = el.getAttribute("data-aranova-cta");
+  if (explicit && explicit.trim().length > 0) return explicit.trim();
+  const text = (el.textContent ?? "").trim().replace(/\s+/g, " ");
+  if (text.length > 0) return text.slice(0, CTA_NAME_MAX_LENGTH);
+  return describeElement(el);
+}
+function attachCtaClickCapture(client, config) {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return () => {
+    };
+  }
+  const autoCapture = config.autoCapture;
+  if (!autoCapture) {
+    return () => {
+    };
+  }
+  const selector = autoCapture.selector ?? DEFAULT_CTA_SELECTOR;
+  function onClick(event) {
+    const target = event.target;
+    if (!(target instanceof Element)) return;
+    let matched = null;
+    try {
+      matched = target.closest(selector);
+    } catch {
+      return;
+    }
+    if (matched === null) return;
+    const href = matched instanceof HTMLAnchorElement ? matched.href || null : matched.getAttribute("href");
+    client.trackEvent({
+      eventType: "cta_click",
+      metadata: {
+        cta_name: resolveCtaName(matched),
+        page: { path: window.location.pathname },
+        section: matched.getAttribute("data-aranova-section"),
+        destination_url: href,
+        href,
+        element: describeElement(matched)
+      },
+      pageUrl: window.location.href,
+      occurredAt: null
+    });
+  }
+  document.addEventListener("click", onClick, true);
+  return () => {
+    document.removeEventListener("click", onClick, true);
+  };
+}
+
 // ../tracking-core/src/resources/sales/errors.ts
 var AranovaApiError = class extends Error {
   constructor(message, options) {
@@ -1817,42 +2112,42 @@ function createSalesClient(config) {
 }
 
 // ../tracking-core/src/resources/sales/schema.ts
-var import_zod11 = require("zod");
+var import_zod12 = require("zod");
 var SUPPORTED_CURRENCIES = ["USD", "CAD"];
 var TRACKING_ENVIRONMENTS = ["production", "development"];
-var currencySchema = import_zod11.z.enum(SUPPORTED_CURRENCIES);
-var centsSchema = import_zod11.z.number().int().nonnegative();
-var quantitySchema = import_zod11.z.string().regex(/^\d+(\.\d{1,3})?$/);
-var metadataSchema = import_zod11.z.record(import_zod11.z.unknown());
-var saleItemSchema = import_zod11.z.object({
-  external_item_id: import_zod11.z.string().nullable().optional(),
-  name: import_zod11.z.string().nullable().optional(),
-  category: import_zod11.z.string().nullable().optional(),
+var currencySchema = import_zod12.z.enum(SUPPORTED_CURRENCIES);
+var centsSchema = import_zod12.z.number().int().nonnegative();
+var quantitySchema = import_zod12.z.string().regex(/^\d+(\.\d{1,3})?$/);
+var metadataSchema = import_zod12.z.record(import_zod12.z.unknown());
+var saleItemSchema = import_zod12.z.object({
+  external_item_id: import_zod12.z.string().nullable().optional(),
+  name: import_zod12.z.string().nullable().optional(),
+  category: import_zod12.z.string().nullable().optional(),
   quantity: quantitySchema,
   unit_price_cents: centsSchema,
   // Non-negativity validated on the wire — same contract as the other cents
   // fields — and backstopped by the DB CHECK.
   unit_cost_cents: centsSchema.nullable().optional()
 }).strict();
-var saleServiceSchema = import_zod11.z.object({
-  service: import_zod11.z.string(),
+var saleServiceSchema = import_zod12.z.object({
+  service: import_zod12.z.string(),
   amount_cents: centsSchema
 }).strict();
-var customerNameSchema = import_zod11.z.string().max(200);
-var customerPhoneSchema = import_zod11.z.string().max(64);
-var customerEmailSchema = import_zod11.z.string().max(320).email();
+var customerNameSchema = import_zod12.z.string().max(200);
+var customerPhoneSchema = import_zod12.z.string().max(64);
+var customerEmailSchema = import_zod12.z.string().max(320).email();
 function refineServiceXor(val, ctx, { requireAmount }) {
   if (val.services != null) {
     if (val.service != null) {
       ctx.addIssue({
-        code: import_zod11.z.ZodIssueCode.custom,
+        code: import_zod12.z.ZodIssueCode.custom,
         message: "pass either `service` or `services`, not both",
         path: ["services"]
       });
     }
     if (val.services.length === 0) {
       ctx.addIssue({
-        code: import_zod11.z.ZodIssueCode.custom,
+        code: import_zod12.z.ZodIssueCode.custom,
         message: "`services` must not be empty",
         path: ["services"]
       });
@@ -1860,7 +2155,7 @@ function refineServiceXor(val, ctx, { requireAmount }) {
     const keys = val.services.map((s) => s.service);
     if (new Set(keys).size !== keys.length) {
       ctx.addIssue({
-        code: import_zod11.z.ZodIssueCode.custom,
+        code: import_zod12.z.ZodIssueCode.custom,
         message: "`services` must not list the same service more than once",
         path: ["services"]
       });
@@ -1869,7 +2164,7 @@ function refineServiceXor(val, ctx, { requireAmount }) {
       const sum = val.services.reduce((acc, s) => acc + s.amount_cents, 0);
       if (val.amount_total_cents !== sum) {
         ctx.addIssue({
-          code: import_zod11.z.ZodIssueCode.custom,
+          code: import_zod12.z.ZodIssueCode.custom,
           message: "amount_total_cents must equal the sum of the services amounts (omit it to derive it automatically)",
           path: ["amount_total_cents"]
         });
@@ -1877,37 +2172,37 @@ function refineServiceXor(val, ctx, { requireAmount }) {
     }
   } else if (requireAmount && val.amount_total_cents == null) {
     ctx.addIssue({
-      code: import_zod11.z.ZodIssueCode.custom,
+      code: import_zod12.z.ZodIssueCode.custom,
       message: "amount_total_cents is required unless `services` is provided",
       path: ["amount_total_cents"]
     });
   }
 }
-var saleCreateSchema = import_zod11.z.object({
-  external_id: import_zod11.z.string().nullable().optional(),
-  description: import_zod11.z.string().nullable().optional(),
-  service: import_zod11.z.string().nullable().optional(),
-  services: import_zod11.z.array(saleServiceSchema).nullable().optional(),
+var saleCreateSchema = import_zod12.z.object({
+  external_id: import_zod12.z.string().nullable().optional(),
+  description: import_zod12.z.string().nullable().optional(),
+  service: import_zod12.z.string().nullable().optional(),
+  services: import_zod12.z.array(saleServiceSchema).nullable().optional(),
   currency: currencySchema,
   // Optional only because the plural `services` form derives it from the sum
   // (see refineServiceXor); the singular/serviceless path still requires it.
   amount_total_cents: centsSchema.nullable().optional(),
-  occurred_at: import_zod11.z.string().datetime(),
-  environment: import_zod11.z.enum(TRACKING_ENVIRONMENTS).default("production"),
-  items: import_zod11.z.array(saleItemSchema).default([]),
+  occurred_at: import_zod12.z.string().datetime(),
+  environment: import_zod12.z.enum(TRACKING_ENVIRONMENTS).default("production"),
+  items: import_zod12.z.array(saleItemSchema).default([]),
   metadata: metadataSchema.nullable().optional(),
   customer_name: customerNameSchema.nullable().optional(),
   customer_phone: customerPhoneSchema.nullable().optional(),
   customer_email: customerEmailSchema.nullable().optional()
 }).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: true }));
-var saleUpdateSchema = import_zod11.z.object({
-  description: import_zod11.z.string().nullable().optional(),
-  service: import_zod11.z.string().nullable().optional(),
-  services: import_zod11.z.array(saleServiceSchema).nullable().optional(),
+var saleUpdateSchema = import_zod12.z.object({
+  description: import_zod12.z.string().nullable().optional(),
+  service: import_zod12.z.string().nullable().optional(),
+  services: import_zod12.z.array(saleServiceSchema).nullable().optional(),
   currency: currencySchema.optional(),
   amount_total_cents: centsSchema.optional(),
-  occurred_at: import_zod11.z.string().datetime().optional(),
-  items: import_zod11.z.array(saleItemSchema).optional(),
+  occurred_at: import_zod12.z.string().datetime().optional(),
+  items: import_zod12.z.array(saleItemSchema).optional(),
   metadata: metadataSchema.nullable().optional(),
   customer_name: customerNameSchema.nullable().optional(),
   customer_phone: customerPhoneSchema.nullable().optional(),
@@ -1997,36 +2292,68 @@ function useTrackingParams() {
   }, []);
   return trackingParams;
 }
-function useConsentState() {
-  return useConsent().state;
-}
-function useConsent() {
-  const [state, setState] = (0, import_react.useState)("pending");
+var DEFAULT_CHOICE2 = {
+  state: "granted",
+  source: "default",
+  updatedAt: null,
+  expiresAt: null
+};
+function useCookiePreferences(options) {
+  const [choice, setChoice] = (0, import_react.useState)(DEFAULT_CHOICE2);
+  const ttlDays = options?.declineTtlDays;
   (0, import_react.useEffect)(() => {
-    setState(getConsentState());
+    const sync = () => setChoice(getConsentChoice());
+    sync();
     const handleStorage = (event) => {
-      if (event.key === CONSENT_STATE_KEY) setState(getConsentState());
+      if (event.key === null || event.key === CONSENT_STATE_KEY || event.key === CONSENT_EXPIRES_AT_KEY || event.key === CONSENT_TIMESTAMP_KEY)
+        sync();
     };
     window.addEventListener("storage", handleStorage);
-    return () => window.removeEventListener("storage", handleStorage);
-  }, []);
-  const accept = (0, import_react.useCallback)(() => {
-    setConsentState("granted");
-    setState("granted");
+    const unsubscribe = onConsentChange(sync);
+    return () => {
+      window.removeEventListener("storage", handleStorage);
+      unsubscribe();
+    };
   }, []);
-  const decline = (0, import_react.useCallback)(() => {
-    setConsentState("denied");
-    setState("denied");
+  const optOutAction = (0, import_react.useCallback)(() => {
+    optOut(ttlDays != null ? { declineTtlDays: ttlDays } : void 0);
+  }, [ttlDays]);
+  const optInAction = (0, import_react.useCallback)(() => {
+    optIn();
   }, []);
   const reset = (0, import_react.useCallback)(() => {
     resetConsent();
-    setState("pending");
   }, []);
+  return {
+    state: choice.state,
+    source: choice.source,
+    isDefault: choice.source === "default",
+    isGranted: choice.state === "granted",
+    isDenied: choice.state === "denied",
+    updatedAt: choice.updatedAt,
+    expiresAt: choice.expiresAt,
+    optOut: optOutAction,
+    optIn: optInAction,
+    reset
+  };
+}
+function useConsentState() {
+  return useConsent().state;
+}
+function useConsent() {
+  const {
+    state,
+    isGranted,
+    isDenied,
+    optIn: accept,
+    optOut: decline,
+    reset
+  } = useCookiePreferences();
   return {
     state,
-    isPending: state === "pending",
-    isGranted: state === "granted",
-    isDenied: state === "denied",
+    isPending: false,
+    isGranted,
+    isDenied,
     accept,
     decline,
     reset
@@ -2242,13 +2569,11 @@ function AdPlatformTracking({
           strategy: "afterInteractive"
         }
       ),
-      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_script.default, { id: "gtag-init", strategy: "afterInteractive", children: gtagInitScript }),
-      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_script.default, { id: "consent-restore", strategy: "afterInteractive", children: createConsentRestoreScript() })
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_script.default, { id: "gtag-init", strategy: "afterInteractive", children: gtagInitScript })
     ] }) : null,
     metaAll.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_jsx_runtime2.Fragment, { children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_script.default, { id: "meta-pixel-base", strategy: "afterInteractive", children: createMetaConsentDefaultScript() }),
-      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_script.default, { id: "meta-pixel-init", strategy: "afterInteractive", children: metaInitScript }),
-      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_script.default, { id: "meta-pixel-consent-restore", strategy: "afterInteractive", children: createMetaConsentRestoreScript() })
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_script.default, { id: "meta-pixel-init", strategy: "afterInteractive", children: metaInitScript })
     ] }) : null
   ] });
 }
@@ -2271,8 +2596,7 @@ function GoogleAdsTracking(props) {
         strategy: "afterInteractive"
       }
     ),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_script2.default, { id: "gtag-init", strategy: "afterInteractive", children: initScript }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_script2.default, { id: "consent-restore", strategy: "afterInteractive", children: createConsentRestoreScript() })
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_script2.default, { id: "gtag-init", strategy: "afterInteractive", children: initScript })
   ] });
 }
 
@@ -2280,7 +2604,7 @@ function GoogleAdsTracking(props) {
 var import_navigation = require("next/navigation");
 
 // package.json
-var version = "0.14.2";
+var version = "0.16.0";
 
 // src/factory.tsx
 var import_react4 = require("react");
@@ -2561,6 +2885,7 @@ function createTracking(options) {
         debug
       });
       const detectorClient = wrapClient(rawClient);
+      detachers.push(attachPageExit(detectorClient));
       const scrollDepth = triggers.automatic.scroll_depth;
       if (scrollDepth) {
         detachers.push(attachScrollDepth(detectorClient, scrollDepth));
@@ -2569,6 +2894,10 @@ function createTracking(options) {
       if (formStart) {
         detachers.push(attachFormStart(detectorClient, formStart));
       }
+      const ctaClick = triggers.manual?.cta_click;
+      if (ctaClick) {
+        detachers.push(attachCtaClickCapture(detectorClient, ctaClick));
+      }
       return () => {
         for (let i = detachers.length - 1; i >= 0; i--) {
           detachers[i]();
@@ -2593,6 +2922,7 @@ function createTracking(options) {
   AdPlatformTracking,
   AranovaApiError,
   ConsentBanner,
+  DEFAULT_DECLINE_TTL_DAYS,
   DEFAULT_PHONE_COUNTRY,
   GoogleAdsTracking,
   NAMED_RANGES,
@@ -2612,7 +2942,11 @@ function createTracking(options) {
   formatPhone,
   formatPhoneAsTyped,
   fromMinor,
+  getConsentChoice,
   getConsentState,
+  onConsentChange,
+  optIn,
+  optOut,
   parsePhone,
   phoneField,
   resetConsent,
@@ -2627,6 +2961,7 @@ function createTracking(options) {
   toMinor,
   useConsent,
   useConsentState,
+  useCookiePreferences,
   useGclid,
   usePhoneConfig,
   usePhoneField,