@shoppexio/storefront 1.0.77 → 1.0.78

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.0.78
+
+- `captureAffiliateFromUrl()` honours the shop's attribution mode (ADR-0067). Under `FIRST_CLICK` a held, unexpired attribution wins and a newer `?ref=` no longer replaces it; the landing is still reported so click statistics stay complete. `LAST_CLICK` is unchanged and remains the default.
+- The attribution window is no longer fixed at 30 days: `/attribution` returns `attribution_mode` and `attribution_window_days`, and a newly stored referral uses the shop's (or its tier's) window.
+- New export `getStoredAffiliate()`, returning `{ code, mode }` for the held attribution, or `null`.
+- `setAffiliateCode(code, ttlDays, mode?)` accepts the mode to persist. Existing two-argument calls are unaffected.
+- The `shoppex:affiliate_code:v1` storage key is unchanged and entries written by earlier versions keep working: an entry without a mode reads as `LAST_CLICK`, the behaviour it was written under. No attribution is lost on upgrade.
+- Note: first-click is enforced in the browser, like the window itself. It is an attribution rule, not fraud protection.
+
 ## 1.0.77
 
 - Headless customer replacement requests now require `lineItemId` in the SDK types, matching the live API. Pass the invoice position UUID; omitted or null IDs are not valid. The read-only `replacementEligibility` query still allows omitting its line ID.

package/dist/index.cjs

@@ -19285,6 +19285,9 @@ var SESSION_STORAGE_KEY = "shoppex:affiliate_session:v1";
 var DEFAULT_TTL_DAYS = 30;
 var FALLBACK_SESSION_KEY_LENGTH = 24;
 var SESSION_KEY_ALPHABET = "abcdefghijklmnopqrstuvwxyz0123456789";
+function normalizeMode(value) {
+  return value === "FIRST_CLICK" ? "FIRST_CLICK" : "LAST_CLICK";
+}
 function nowMs() {
   return Date.now();
 }
@@ -19302,7 +19305,7 @@ function safeRead() {
     if (!raw) return null;
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed.code !== "string" || typeof parsed.expiresAt !== "number") return null;
-    return parsed;
+    return parsed.mode === void 0 ? parsed : { ...parsed, mode: normalizeMode(parsed.mode) };
   } catch {
     return null;
   }
@@ -19314,15 +19317,32 @@ function safeWrite(value) {
   } catch {
   }
 }
-function setAffiliateCode(code, ttlDays = DEFAULT_TTL_DAYS) {
+function setAffiliateCode(code, ttlDays = DEFAULT_TTL_DAYS, mode) {
   const normalized = normalizeAffiliateCode(code);
   if (!normalized) {
     clearAffiliateCode();
     return null;
   }
-  safeWrite({ code: normalized, expiresAt: nowMs() + ttlMs(ttlDays) });
+  safeWrite({
+    code: normalized,
+    expiresAt: nowMs() + ttlMs(ttlDays),
+    windowDays: ttlDays,
+    ...mode ? { mode } : {}
+  });
   return normalized;
 }
+function getStoredAffiliate() {
+  const stored = safeRead();
+  if (!stored) return null;
+  if (stored.expiresAt <= nowMs()) {
+    clearAffiliateCode();
+    return null;
+  }
+  const code = normalizeAffiliateCode(stored.code);
+  if (!code) return null;
+  const windowDays = typeof stored.windowDays === "number" && stored.windowDays > 0 ? stored.windowDays : DEFAULT_TTL_DAYS;
+  return { code, mode: normalizeMode(stored.mode), windowDays };
+}
 function clearAffiliateCode() {
   if (typeof window === "undefined") return;
   try {
@@ -19468,7 +19488,11 @@ async function captureAffiliateFromUrl(param = "ref") {
   }
   code = normalizeAffiliateCode(code);
   if (!code) return null;
-  setAffiliateCode(code);
+  const held = getStoredAffiliate();
+  const mayHoldFirstClick = held !== null && held.mode === "FIRST_CLICK" && held.code !== code;
+  if (!mayHoldFirstClick) {
+    setAffiliateCode(code, held?.windowDays ?? DEFAULT_TTL_DAYS, held?.mode);
+  }
   if (isInitialized()) {
     try {
       const config2 = getConfig();
@@ -19477,8 +19501,14 @@ async function captureAffiliateFromUrl(param = "ref") {
         { shop_slug: config2.storeSlug, code },
         { retries: 0 }
       );
+      const serverMode = res.success && res.data?.attribution_mode ? normalizeMode(res.data.attribution_mode) : null;
+      const serverWindow = res.success && typeof res.data?.attribution_window_days === "number" ? res.data.attribution_window_days : DEFAULT_TTL_DAYS;
+      const holdsFirstClick = mayHoldFirstClick && serverMode !== "LAST_CLICK";
+      if (holdsFirstClick) {
+        return held.code;
+      }
       if (res.success && res.data?.accepted && res.data.affiliate_code) {
-        setAffiliateCode(res.data.affiliate_code);
+        setAffiliateCode(res.data.affiliate_code, serverWindow, serverMode ?? void 0);
         return res.data.affiliate_code;
       }
       if (res.success && res.data && res.data.accepted === false) {
@@ -19487,10 +19517,10 @@ async function captureAffiliateFromUrl(param = "ref") {
       }
       return code;
     } catch {
-      return code;
+      return mayHoldFirstClick ? held.code : code;
     }
   }
-  return code;
+  return mayHoldFirstClick ? held.code : code;
 }
 
 // ../sdk/src/utils/cart-line-id.ts
@@ -21575,6 +21605,7 @@ var shoppex = {
   validateAffiliateCode,
   applyAffiliateCode,
   getAffiliateCode,
+  getStoredAffiliate,
   setAffiliateCode,
   clearAffiliateCode,
   trackAffiliateEvent,