@aranova/tracking-next 0.14.2 → 0.15.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 getConsentState() {
+  return getConsentChoice().state;
 }
-function setConsentState(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;
+  }
+}
+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;
   }
-} catch (e) {}`.trim();
+  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
@@ -1997,36 +2108,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 +2385,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 +2412,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 +2420,7 @@ function GoogleAdsTracking(props) {
 var import_navigation = require("next/navigation");
 
 // package.json
-var version = "0.14.2";
+var version = "0.15.0";
 
 // src/factory.tsx
 var import_react4 = require("react");
@@ -2593,6 +2733,7 @@ function createTracking(options) {
   AdPlatformTracking,
   AranovaApiError,
   ConsentBanner,
+  DEFAULT_DECLINE_TTL_DAYS,
   DEFAULT_PHONE_COUNTRY,
   GoogleAdsTracking,
   NAMED_RANGES,
@@ -2612,7 +2753,11 @@ function createTracking(options) {
   formatPhone,
   formatPhoneAsTyped,
   fromMinor,
+  getConsentChoice,
   getConsentState,
+  onConsentChange,
+  optIn,
+  optOut,
   parsePhone,
   phoneField,
   resetConsent,
@@ -2627,6 +2772,7 @@ function createTracking(options) {
   toMinor,
   useConsent,
   useConsentState,
+  useCookiePreferences,
   useGclid,
   usePhoneConfig,
   usePhoneField,