@aranova/tracking-react 0.14.1 → 0.15.0

package/dist/index.js

@@ -23,6 +23,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,
@@ -42,7 +43,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,
@@ -57,6 +62,7 @@ __export(src_exports, {
   toMinor: () => toMinor,
   useConsent: () => useConsent,
   useConsentState: () => useConsentState,
+  useCookiePreferences: () => useCookiePreferences,
   useGclid: () => useGclid,
   usePhoneConfig: () => usePhoneConfig,
   usePhoneField: () => usePhoneField,
@@ -73,13 +79,30 @@ var import_react = require("react");
 // ../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,
@@ -88,47 +111,74 @@ 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 {
   }
-}
-function restoreStoredConsent() {
-  const consentState = getConsentState();
-  if (consentState === "granted" || consentState === "denied") setConsentState(consentState);
-  return consentState;
+  pushConsentToPlatforms("granted");
+  notifyConsentChanged(DEFAULT_CHOICE);
 }
 
 // ../tracking-core/src/tracking.ts
@@ -272,13 +322,11 @@ function fireGtagConversion(input) {
 }
 function applyDefaultConsentState() {
   const gtag = ensureGtagFunction();
-  gtag("consent", "default", {
-    ad_storage: "denied",
-    ad_user_data: "denied",
-    ad_personalization: "denied",
-    analytics_storage: "denied",
-    wait_for_update: 500
-  });
+  gtag(
+    "consent",
+    "default",
+    buildConsentPayload(getConsentState() === "denied" ? "denied" : "granted")
+  );
 }
 function loadGtagScript(gtagId) {
   if (typeof document === "undefined") return;
@@ -304,7 +352,6 @@ function bootstrapGoogleAdsTracking(gtagId) {
   applyDefaultConsentState();
   loadGtagScript(gtagId);
   initializeGtag(gtagId);
-  restoreStoredConsent();
 }
 function bootstrapMultipleGtags(gtagIds) {
   if (typeof window === "undefined" || typeof document === "undefined") return;
@@ -319,7 +366,6 @@ function bootstrapMultipleGtags(gtagIds) {
   for (const id of ids) {
     gtag("config", id);
   }
-  restoreStoredConsent();
 }
 
 // ../tracking-core/src/fbq.ts
@@ -379,7 +425,7 @@ function ensureFbqFunction() {
   return fbq;
 }
 function applyDefaultMetaConsentState() {
-  ensureFbqFunction()("consent", "revoke");
+  ensureFbqFunction()("consent", getConsentState() === "denied" ? "revoke" : "grant");
 }
 function loadFbeventsScript() {
   if (typeof document === "undefined") return;
@@ -399,19 +445,12 @@ function initializeMetaPixel(pixelId) {
   fbq("init", pixelId);
   fbq("track", "PageView");
 }
-function restoreMetaConsentState() {
-  if (typeof window === "undefined") return;
-  const state = getConsentState();
-  if (state === "granted") window.fbq?.("consent", "grant");
-  else if (state === "denied") window.fbq?.("consent", "revoke");
-}
 function bootstrapMetaPixel(pixelId) {
   if (typeof window === "undefined" || typeof document === "undefined") return;
   if (!isValidMetaPixelId(pixelId)) return;
   applyDefaultMetaConsentState();
   loadFbeventsScript();
   initializeMetaPixel(pixelId);
-  restoreMetaConsentState();
   captureFbc();
 }
 function bootstrapMultiplePixels(pixelIds) {
@@ -427,10 +466,75 @@ function bootstrapMultiplePixels(pixelIds) {
     fbq("init", id);
   }
   fbq("track", "PageView");
-  restoreMetaConsentState();
   captureFbc();
 }
 
+// ../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;
+  }
+}
+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
 function createTrackingClientContext(surface, input = {}) {
   return {
@@ -457,6 +561,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
@@ -478,8 +585,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}`;
 }
@@ -503,23 +608,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) {
@@ -1065,7 +1156,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;
   }
@@ -1138,6 +1235,7 @@ function createTrackingClient(config) {
       initialParams = captureTrackingParamsFromLocation();
     } catch {
     }
+    getOrCaptureLandingParams(sessionId);
     try {
       captureFbc();
     } catch {
@@ -1187,6 +1285,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
@@ -2220,36 +2323,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
@@ -2490,7 +2625,7 @@ function GoogleAdsTracking(props) {
 var import_react6 = require("react");
 
 // package.json
-var version = "0.14.1";
+var version = "0.15.0";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react5 = require("react");
@@ -2715,6 +2850,7 @@ function createTracking(options) {
   AdPlatformTracking,
   AranovaApiError,
   ConsentBanner,
+  DEFAULT_DECLINE_TTL_DAYS,
   DEFAULT_PHONE_COUNTRY,
   GoogleAdsTracking,
   NAMED_RANGES,
@@ -2734,7 +2870,11 @@ function createTracking(options) {
   formatPhone,
   formatPhoneAsTyped,
   fromMinor,
+  getConsentChoice,
   getConsentState,
+  onConsentChange,
+  optIn,
+  optOut,
   parsePhone,
   phoneField,
   resetConsent,
@@ -2749,6 +2889,7 @@ function createTracking(options) {
   toMinor,
   useConsent,
   useConsentState,
+  useCookiePreferences,
   useGclid,
   usePhoneConfig,
   usePhoneField,