@virex-tech/paywallo-sdk 2.5.1 → 2.5.3

package/dist/index.js

@@ -348,13 +348,13 @@ function getCachedDeviceInfo() {
     return null;
   }
 }
-var import_react_native2, Device, Application, Localization, _debug2, cachedDeviceInfo, nativeDeviceInfo;
+var import_react_native2, Application, Device, Localization, _debug2, cachedDeviceInfo, nativeDeviceInfo;
 var init_NativeDeviceInfo = __esm({
   "src/utils/NativeDeviceInfo.ts"() {
     "use strict";
     import_react_native2 = require("react-native");
-    Device = __toESM(require("expo-device"));
     Application = __toESM(require("expo-application"));
+    Device = __toESM(require("expo-device"));
     Localization = __toESM(require("expo-localization"));
     init_ClientError();
     _debug2 = false;
@@ -968,7 +968,9 @@ var init_AdvertisingIdManager = __esm({
         return this.cached;
       }
       async collect(requestATT = false) {
-        if (this.cached) return this.cached;
+        if (this.cached && !(requestATT && this.cached.attStatus === "undetermined")) {
+          return this.cached;
+        }
         const fallback = { idfv: null, idfa: null, gaid: null, attStatus: "unavailable" };
         try {
           const tracking = await import("expo-tracking-transparency");
@@ -1391,6 +1393,7 @@ var init_AttributionTracker = __esm({
       constructor(debug = false) {
         this.cache = null;
         this.captureInProgress = false;
+        this.listeners = /* @__PURE__ */ new Set();
         this.storage = new SecureStorage(debug);
       }
       /**
@@ -1430,10 +1433,31 @@ var init_AttributionTracker = __esm({
           };
           await this.storage.set(ATTRIBUTION_STORAGE_KEY, JSON.stringify(capture));
           this.cache = capture;
+          this.notifyListeners(capture);
         } finally {
           this.captureInProgress = false;
         }
       }
+      /**
+       * Subscribes to the first real attribution write (first-write-wins — no-op
+       * captures never fire). Useful for late enrichment consumers (e.g. re-push
+       * of Superwall attributes when a warm deep link / deferred match lands after
+       * init). Returns an unsubscribe function.
+       */
+      onCapture(listener) {
+        this.listeners.add(listener);
+        return () => {
+          this.listeners.delete(listener);
+        };
+      }
+      notifyListeners(capture) {
+        for (const listener of this.listeners) {
+          try {
+            listener(capture);
+          } catch {
+          }
+        }
+      }
       /**
        * Returns the persisted attribution capture, or `null` if none exists.
        * Synchronous — reads from in-memory cache (populated via `loadFromStorage()`).
@@ -1527,6 +1551,68 @@ var init_InstallIdempotency = __esm({
   }
 });
 
+// src/domains/identity/deferredAppLink.ts
+function parseQuery(s) {
+  const result = {};
+  for (const pair of s.split("&")) {
+    const eqIndex = pair.indexOf("=");
+    if (eqIndex === -1) continue;
+    try {
+      const key = decodeURIComponent(pair.slice(0, eqIndex).replace(/\+/g, " "));
+      const value = decodeURIComponent(pair.slice(eqIndex + 1).replace(/\+/g, " "));
+      if (key) result[key] = value;
+    } catch {
+    }
+  }
+  return result;
+}
+function parseDeferredAppLink(url) {
+  if (!url || url.trim() === "") return null;
+  const raw = url.slice(0, 2048);
+  const cleanRaw = raw.split("#")[0];
+  const qIndex = cleanRaw.indexOf("?");
+  if (qIndex === -1) return null;
+  const topParams = parseQuery(cleanRaw.slice(qIndex + 1));
+  let fbclid = nz(topParams["fbclid"]);
+  let utmSource = nz(topParams["utm_source"]);
+  let utmMedium = nz(topParams["utm_medium"]);
+  let utmCampaign = nz(topParams["utm_campaign"]);
+  let ttclid = nz(topParams["ttclid"]);
+  let trackingId = nz(topParams["tracking_id"]);
+  let targetUrl = null;
+  if (topParams["target_url"]) {
+    try {
+      targetUrl = decodeURIComponent(topParams["target_url"]);
+    } catch {
+      targetUrl = topParams["target_url"];
+    }
+  }
+  if (!fbclid && targetUrl) {
+    const cleanTargetUrl = targetUrl.split("#")[0];
+    const innerQ = cleanTargetUrl.indexOf("?");
+    if (innerQ !== -1) {
+      const inner = parseQuery(cleanTargetUrl.slice(innerQ + 1));
+      fbclid = fbclid ?? nz(inner["fbclid"]);
+      utmSource = utmSource ?? nz(inner["utm_source"]);
+      utmMedium = utmMedium ?? nz(inner["utm_medium"]);
+      utmCampaign = utmCampaign ?? nz(inner["utm_campaign"]);
+      ttclid = ttclid ?? nz(inner["ttclid"]);
+      trackingId = trackingId ?? nz(inner["tracking_id"]);
+    }
+  }
+  if (!fbclid && !ttclid && !trackingId && !utmSource && !utmMedium && !utmCampaign) {
+    return null;
+  }
+  return { fbclid, utmSource, utmMedium, utmCampaign, ttclid, trackingId, targetUrl, raw };
+}
+var nz;
+var init_deferredAppLink = __esm({
+  "src/domains/identity/deferredAppLink.ts"() {
+    "use strict";
+    nz = (v) => typeof v === "string" && v.trim().length > 0 ? v : null;
+  }
+});
+
 // src/domains/identity/MetaBridge.ts
 var import_react_native5, TIMEOUT_MS, NativeBridge, MetaBridge, metaBridge;
 var init_MetaBridge = __esm({
@@ -1625,68 +1711,6 @@ var init_MetaBridge = __esm({
   }
 });
 
-// src/domains/identity/deferredAppLink.ts
-function parseQuery(s) {
-  const result = {};
-  for (const pair of s.split("&")) {
-    const eqIndex = pair.indexOf("=");
-    if (eqIndex === -1) continue;
-    try {
-      const key = decodeURIComponent(pair.slice(0, eqIndex).replace(/\+/g, " "));
-      const value = decodeURIComponent(pair.slice(eqIndex + 1).replace(/\+/g, " "));
-      if (key) result[key] = value;
-    } catch {
-    }
-  }
-  return result;
-}
-function parseDeferredAppLink(url) {
-  if (!url || url.trim() === "") return null;
-  const raw = url.slice(0, 2048);
-  const cleanRaw = raw.split("#")[0];
-  const qIndex = cleanRaw.indexOf("?");
-  if (qIndex === -1) return null;
-  const topParams = parseQuery(cleanRaw.slice(qIndex + 1));
-  let fbclid = nz(topParams["fbclid"]);
-  let utmSource = nz(topParams["utm_source"]);
-  let utmMedium = nz(topParams["utm_medium"]);
-  let utmCampaign = nz(topParams["utm_campaign"]);
-  let ttclid = nz(topParams["ttclid"]);
-  let trackingId = nz(topParams["tracking_id"]);
-  let targetUrl = null;
-  if (topParams["target_url"]) {
-    try {
-      targetUrl = decodeURIComponent(topParams["target_url"]);
-    } catch {
-      targetUrl = topParams["target_url"];
-    }
-  }
-  if (!fbclid && targetUrl) {
-    const cleanTargetUrl = targetUrl.split("#")[0];
-    const innerQ = cleanTargetUrl.indexOf("?");
-    if (innerQ !== -1) {
-      const inner = parseQuery(cleanTargetUrl.slice(innerQ + 1));
-      fbclid = fbclid ?? nz(inner["fbclid"]);
-      utmSource = utmSource ?? nz(inner["utm_source"]);
-      utmMedium = utmMedium ?? nz(inner["utm_medium"]);
-      utmCampaign = utmCampaign ?? nz(inner["utm_campaign"]);
-      ttclid = ttclid ?? nz(inner["ttclid"]);
-      trackingId = trackingId ?? nz(inner["tracking_id"]);
-    }
-  }
-  if (!fbclid && !ttclid && !trackingId && !utmSource && !utmMedium && !utmCampaign) {
-    return null;
-  }
-  return { fbclid, utmSource, utmMedium, utmCampaign, ttclid, trackingId, targetUrl, raw };
-}
-var nz;
-var init_deferredAppLink = __esm({
-  "src/domains/identity/deferredAppLink.ts"() {
-    "use strict";
-    nz = (v) => typeof v === "string" && v.trim().length > 0 ? v : null;
-  }
-});
-
 // src/domains/identity/InstallReferrerManager.ts
 var import_react_native6, REFERRER_TIMEOUT_MS, InstallReferrerManager, installReferrerManager;
 var init_InstallReferrerManager = __esm({
@@ -1694,8 +1718,8 @@ var init_InstallReferrerManager = __esm({
     "use strict";
     import_react_native6 = require("react-native");
     init_NativeDeviceInfo();
-    init_MetaBridge();
     init_deferredAppLink();
+    init_MetaBridge();
     REFERRER_TIMEOUT_MS = 5e3;
     InstallReferrerManager = class {
       async getReferrer() {
@@ -1795,7 +1819,17 @@ var init_InstallReferrerManager = __esm({
 });
 
 // src/domains/identity/InstallTracker.ts
-var import_react_native7, InstallTracker;
+function extractDeferredAttribution(raw) {
+  if (raw === null || typeof raw !== "object") return null;
+  const source = raw;
+  const out = {};
+  for (const field of DEFERRED_ATTRIBUTION_FIELDS) {
+    const value = source[field];
+    if (typeof value === "string" && value !== "") out[field] = value;
+  }
+  return Object.keys(out).length > 0 ? out : null;
+}
+var import_react_native7, InstallTracker, DEFERRED_ATTRIBUTION_FIELDS;
 var init_InstallTracker = __esm({
   "src/domains/identity/InstallTracker.ts"() {
     "use strict";
@@ -1961,7 +1995,7 @@ var init_InstallTracker = __esm({
           const baseUrl = apiClient.getBaseUrl();
           const appKey = apiClient.getAppKey();
           const referrer = await installReferrerManager.getReferrer();
-          await fetch(`${baseUrl}/sdk/attribution/deferred-match/${appKey}`, {
+          const response = await fetch(`${baseUrl}/sdk/attribution/deferred-match/${appKey}`, {
             method: "POST",
             headers: { "Content-Type": "application/json", "X-App-Key": appKey },
             body: JSON.stringify({
@@ -1983,12 +2017,42 @@ var init_InstallTracker = __esm({
           });
           await storage.set(INSTALL_KEYS.DEFERRED_MATCH_DONE, "1").catch(() => {
           });
+          await this.applyDeferredMatchResponse(response);
         } catch {
         } finally {
           clearTimeout(timer);
         }
       }
+      async applyDeferredMatchResponse(response) {
+        try {
+          const body = await response.json();
+          if (body === null || typeof body !== "object") return;
+          const outer = body;
+          const source = typeof outer.data === "object" && outer.data !== null ? outer.data : body;
+          if (source.matched !== true) return;
+          const attribution = extractDeferredAttribution(source.attribution);
+          if (!attribution) return;
+          await attributionTracker.capture({
+            ...attribution,
+            installReferrerSource: "deferred_match"
+          });
+        } catch {
+        }
+      }
     };
+    DEFERRED_ATTRIBUTION_FIELDS = [
+      "fbclid",
+      "gclid",
+      "ttclid",
+      "utmSource",
+      "utmMedium",
+      "utmCampaign",
+      "utmContent",
+      "utmTerm",
+      "tiktokCampaignId",
+      "tiktokAdgroupId",
+      "tiktokAdId"
+    ];
   }
 });
 
@@ -2563,8 +2627,8 @@ var init_NotificationHandlerSetup = __esm({
 // src/core/version.ts
 function resolveVersion() {
   try {
-    if ("2.5.1") {
-      return "2.5.1";
+    if ("2.5.3") {
+      return "2.5.3";
     }
   } catch {
   }
@@ -3183,99 +3247,236 @@ var init_notifications = __esm({
   }
 });
 
-// src/domains/paywall/paywallCloseReason.ts
-function toCanonicalReason(reason) {
-  if (reason in CLOSE_REASON_MAP) return CLOSE_REASON_MAP[reason];
-  return reason;
-}
-var CLOSE_REASON_MAP;
-var init_paywallCloseReason = __esm({
-  "src/domains/paywall/paywallCloseReason.ts"() {
+// src/domains/onboarding/OnboardingError.ts
+var OnboardingError, ONBOARDING_ERROR_CODES;
+var init_OnboardingError = __esm({
+  "src/domains/onboarding/OnboardingError.ts"() {
     "use strict";
-    CLOSE_REASON_MAP = {
-      dismissed: "dismiss",
-      purchased: "purchase",
-      backgrounded: "dismiss",
-      timeout: "timeout"
+    init_PaywalloError();
+    OnboardingError = class extends PaywalloError {
+      constructor(code, message) {
+        super("onboarding", code, message);
+        this.name = "OnboardingError";
+      }
+    };
+    ONBOARDING_ERROR_CODES = {
+      NOT_INITIALIZED: "ONBOARDING_NOT_INITIALIZED",
+      INVALID_STEP_NAME: "ONBOARDING_INVALID_STEP_NAME"
     };
   }
 });
 
-// src/domains/paywall/emitPaywallClosed.ts
-async function emitPaywallClosed(opts) {
-  try {
-    const api = PaywalloClient.getApiClient();
-    if (!api) return;
-    const sessionId = PaywalloClient.getSessionId();
-    const closedAt = /* @__PURE__ */ new Date();
-    const durationS = Math.max(0, Math.round((closedAt.getTime() - opts.presentedAt) / 1e3));
-    await api.trackEvent("paywall", PaywalloClient.getDistinctId(), {
-      type: "closed",
-      paywall_id: opts.paywallId,
-      placement: opts.placement,
-      closed_at: closedAt.toISOString(),
-      duration_s: durationS,
-      close_reason: toCanonicalReason(opts.reason),
-      ...opts.variantId && { variant_id: opts.variantId },
-      ...opts.variantKey && { variant_key: opts.variantKey },
-      ...opts.campaignId && { campaign_id: opts.campaignId },
-      ...typeof opts.scrollDepth === "number" && { scroll_depth: opts.scrollDepth },
-      ...sessionId && { sessionId }
-    });
-  } catch (err) {
-    if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] emitPaywallClosed failed", err);
-  }
-}
-var init_emitPaywallClosed = __esm({
-  "src/domains/paywall/emitPaywallClosed.ts"() {
-    "use strict";
-    init_PaywalloClient();
-    init_paywallCloseReason();
-  }
-});
-
-// src/domains/paywall/extractFirstPageBackground.ts
-function extractFirstPageBackground(craftData) {
-  if (!craftData) return DEFAULT_BACKGROUND;
-  try {
-    const data = JSON.parse(craftData);
-    const nodes = { ...data.nodes, ...data.sharedNodes };
-    const rootId = data.rootId;
-    if (!rootId || !nodes[rootId]) return DEFAULT_BACKGROUND;
-    const firstPageId = nodes[rootId].children?.[0];
-    if (!firstPageId) return DEFAULT_BACKGROUND;
-    const bg = nodes[firstPageId]?.props?.backgroundColor;
-    return typeof bg === "string" && bg.length > 0 && bg !== "transparent" ? bg : DEFAULT_BACKGROUND;
-  } catch {
-    return DEFAULT_BACKGROUND;
-  }
-}
-function isColorDark(color) {
-  const hex = color.replace("#", "").trim();
-  const normalized = hex.length === 3 ? hex.split("").map((c) => c + c).join("") : hex;
-  if (normalized.length !== 6) return false;
-  const r = parseInt(normalized.slice(0, 2), 16);
-  const g = parseInt(normalized.slice(2, 4), 16);
-  const b = parseInt(normalized.slice(4, 6), 16);
-  if (Number.isNaN(r) || Number.isNaN(g) || Number.isNaN(b)) return false;
-  const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
-  return luminance < 0.5;
-}
-var DEFAULT_BACKGROUND;
-var init_extractFirstPageBackground = __esm({
-  "src/domains/paywall/extractFirstPageBackground.ts"() {
+// src/domains/onboarding/OnboardingManager.ts
+var OnboardingManager, onboardingManager;
+var init_OnboardingManager = __esm({
+  "src/domains/onboarding/OnboardingManager.ts"() {
     "use strict";
-    DEFAULT_BACKGROUND = "#FFFFFF";
-  }
-});
-
-// src/domains/paywall/parseWebViewMessage.ts
-function deriveMessageId(message) {
-  if (message.id) return message.id;
-  const payloadKey = message.payload?.productId ?? message.payload?.url ?? (message.payload?.timestamp != null ? String(message.payload.timestamp) : "");
-  return `${message.type}:${payloadKey}`;
-}
-function parseWebViewMessage(raw) {
+    init_OnboardingError();
+    OnboardingManager = class {
+      constructor() {
+        this.pipeline = null;
+        this.debug = false;
+        this.lastStep = null;
+        this.finished = false;
+      }
+      /**
+       * Injects runtime dependencies. Called by PaywalloClient during init.
+       */
+      injectDeps(config) {
+        this.pipeline = config.pipeline;
+        this.debug = config.debug ?? false;
+      }
+      /**
+       * Tracks an onboarding step view.
+       * Saves the step name internally for implicit drop detection on the backend.
+       *
+       * @param stepName - Unique name for this onboarding step.
+       * @param order - Optional explicit display order (accepts decimals, e.g. 2.1 for A/B variants).
+       */
+      async step(stepName, order) {
+        this.assertConfig();
+        this.validateStepName(stepName, "step");
+        this.lastStep = stepName;
+        const stepPayload = { step_name: stepName };
+        if (order !== void 0 && Number.isFinite(order) && order >= 0) {
+          stepPayload.order = order;
+        }
+        const payload = {
+          family: "onboarding",
+          type: "step",
+          ...stepPayload
+        };
+        return this.emit("onboarding", payload, "step");
+      }
+      /**
+       * Tracks successful completion of the onboarding flow.
+       * Marks the flow as finished.
+       */
+      async complete() {
+        this.assertConfig();
+        this.finished = true;
+        return this.emit("onboarding", { family: "onboarding", type: "complete" }, "complete");
+      }
+      /**
+       * Tracks an explicit drop (abandonment) at the given step.
+       * Marks the flow as finished.
+       *
+       * @param stepName - The step name where the user dropped off.
+       */
+      async drop(stepName) {
+        this.assertConfig();
+        this.validateStepName(stepName, "drop");
+        this.finished = true;
+        const payload = {
+          family: "onboarding",
+          type: "drop",
+          ...{ step_name: stepName }
+        };
+        return this.emit("onboarding", payload, "drop");
+      }
+      /** Returns the last step name seen, or null if no step was tracked yet. */
+      getLastStep() {
+        return this.lastStep;
+      }
+      /** Returns whether the flow has been marked as finished (complete or drop). */
+      isFinished() {
+        return this.finished;
+      }
+      async emit(eventName, properties, logLabel) {
+        const pipeline = this.pipeline;
+        const distinctId = pipeline.getDistinctId();
+        if (!distinctId) {
+          if (this.debug) console.log(`[Paywallo:Onboarding] skipped (no distinctId): ${logLabel}`);
+          return;
+        }
+        await pipeline.trackEvent(eventName, distinctId, properties);
+        if (this.debug) {
+          console.log(`[Paywallo:Onboarding] event emitted: ${eventName}.${logLabel}`, properties);
+        }
+      }
+      assertConfig() {
+        if (!this.pipeline) {
+          throw new OnboardingError(
+            ONBOARDING_ERROR_CODES.NOT_INITIALIZED,
+            "OnboardingManager not initialized. Call Paywallo.init() first."
+          );
+        }
+      }
+      validateStepName(stepName, method) {
+        if (typeof stepName !== "string" || stepName.trim().length === 0) {
+          throw new OnboardingError(
+            ONBOARDING_ERROR_CODES.INVALID_STEP_NAME,
+            `OnboardingManager.${method}(): stepName must be a non-empty string.`
+          );
+        }
+      }
+    };
+    onboardingManager = new OnboardingManager();
+  }
+});
+
+// src/domains/onboarding/index.ts
+var init_onboarding = __esm({
+  "src/domains/onboarding/index.ts"() {
+    "use strict";
+    init_OnboardingError();
+    init_OnboardingManager();
+  }
+});
+
+// src/domains/paywall/paywallCloseReason.ts
+function toCanonicalReason(reason) {
+  if (reason in CLOSE_REASON_MAP) return CLOSE_REASON_MAP[reason];
+  return reason;
+}
+var CLOSE_REASON_MAP;
+var init_paywallCloseReason = __esm({
+  "src/domains/paywall/paywallCloseReason.ts"() {
+    "use strict";
+    CLOSE_REASON_MAP = {
+      dismissed: "dismiss",
+      purchased: "purchase",
+      backgrounded: "dismiss",
+      timeout: "timeout"
+    };
+  }
+});
+
+// src/domains/paywall/emitPaywallClosed.ts
+async function emitPaywallClosed(opts) {
+  try {
+    const api = PaywalloClient.getApiClient();
+    if (!api) return;
+    const sessionId = PaywalloClient.getSessionId();
+    const closedAt = /* @__PURE__ */ new Date();
+    const durationS = Math.max(0, Math.round((closedAt.getTime() - opts.presentedAt) / 1e3));
+    await api.trackEvent("paywall", PaywalloClient.getDistinctId(), {
+      type: "closed",
+      paywall_id: opts.paywallId,
+      placement: opts.placement,
+      closed_at: closedAt.toISOString(),
+      duration_s: durationS,
+      close_reason: toCanonicalReason(opts.reason),
+      ...opts.variantId && { variant_id: opts.variantId },
+      ...opts.variantKey && { variant_key: opts.variantKey },
+      ...opts.campaignId && { campaign_id: opts.campaignId },
+      ...typeof opts.scrollDepth === "number" && { scroll_depth: opts.scrollDepth },
+      ...sessionId && { sessionId }
+    });
+  } catch (err) {
+    if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] emitPaywallClosed failed", err);
+  }
+}
+var init_emitPaywallClosed = __esm({
+  "src/domains/paywall/emitPaywallClosed.ts"() {
+    "use strict";
+    init_PaywalloClient();
+    init_paywallCloseReason();
+  }
+});
+
+// src/domains/paywall/extractFirstPageBackground.ts
+function extractFirstPageBackground(craftData) {
+  if (!craftData) return DEFAULT_BACKGROUND;
+  try {
+    const data = JSON.parse(craftData);
+    const nodes = { ...data.nodes, ...data.sharedNodes };
+    const rootId = data.rootId;
+    if (!rootId || !nodes[rootId]) return DEFAULT_BACKGROUND;
+    const firstPageId = nodes[rootId].children?.[0];
+    if (!firstPageId) return DEFAULT_BACKGROUND;
+    const bg = nodes[firstPageId]?.props?.backgroundColor;
+    return typeof bg === "string" && bg.length > 0 && bg !== "transparent" ? bg : DEFAULT_BACKGROUND;
+  } catch {
+    return DEFAULT_BACKGROUND;
+  }
+}
+function isColorDark(color) {
+  const hex = color.replace("#", "").trim();
+  const normalized = hex.length === 3 ? hex.split("").map((c) => c + c).join("") : hex;
+  if (normalized.length !== 6) return false;
+  const r = parseInt(normalized.slice(0, 2), 16);
+  const g = parseInt(normalized.slice(2, 4), 16);
+  const b = parseInt(normalized.slice(4, 6), 16);
+  if (Number.isNaN(r) || Number.isNaN(g) || Number.isNaN(b)) return false;
+  const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
+  return luminance < 0.5;
+}
+var DEFAULT_BACKGROUND;
+var init_extractFirstPageBackground = __esm({
+  "src/domains/paywall/extractFirstPageBackground.ts"() {
+    "use strict";
+    DEFAULT_BACKGROUND = "#FFFFFF";
+  }
+});
+
+// src/domains/paywall/parseWebViewMessage.ts
+function deriveMessageId(message) {
+  if (message.id) return message.id;
+  const payloadKey = message.payload?.productId ?? message.payload?.url ?? (message.payload?.timestamp != null ? String(message.payload.timestamp) : "");
+  return `${message.type}:${payloadKey}`;
+}
+function parseWebViewMessage(raw) {
   try {
     const parsed = JSON.parse(raw);
     if (typeof parsed?.type !== "string" || !ALLOWED_MESSAGE_TYPES.has(parsed.type)) {
@@ -3910,54 +4111,379 @@ var init_PaywallWebView = __esm({
   }
 });
 
-// src/domains/iap/IAPTransactionEmitter.ts
-var IAPTransactionEmitter;
-var init_IAPTransactionEmitter = __esm({
-  "src/domains/iap/IAPTransactionEmitter.ts"() {
+// src/domains/iap/PurchaseError.ts
+function createPurchaseError(code, message) {
+  return new PurchaseError(
+    PURCHASE_ERROR_CODES[code],
+    message ?? DEFAULT_MESSAGES[code] ?? "Unknown purchase error",
+    code === "USER_CANCELLED"
+  );
+}
+var PurchaseError, PURCHASE_ERROR_CODES, DEFAULT_MESSAGES;
+var init_PurchaseError = __esm({
+  "src/domains/iap/PurchaseError.ts"() {
     "use strict";
-    init_PaywalloClient();
-    IAPTransactionEmitter = class {
-      constructor(getProductFromCache, getApiClientFn, getDebug) {
-        this.getProductFromCache = getProductFromCache;
-        this.getApiClientFn = getApiClientFn;
-        this.getDebug = getDebug;
+    init_PaywalloError();
+    PurchaseError = class extends PaywalloError {
+      constructor(code, message, userCancelled = false, httpStatus) {
+        super("purchase", code, message);
+        this.name = "PurchaseError";
+        this.userCancelled = userCancelled;
+        this.httpStatus = httpStatus;
       }
-      /**
-       * Emits `checkout_started` quando o usuário inicia a compra (toca em comprar),
-       * antes do StoreKit/Billing abrir — conta mesmo que a sheet nativa seja cancelada.
-       * Vira InitiateCheckout no Meta/TikTok. Fire-and-forget — uma falha de tracking
-       * nunca pode travar a compra.
-       */
-      async emitCheckoutStarted(productId) {
-        try {
-          const apiClient = this.getApiClientFn();
-          if (!apiClient) return;
-          const distinctId = PaywalloClient.getDistinctId();
-          if (!distinctId) return;
-          const product = this.getProductFromCache(productId);
-          const properties = {
-            product_id: productId,
-            amount: product?.priceValue ?? 0,
-            currency: product?.currency ?? "USD"
-          };
-          await apiClient.trackEvent("checkout_started", distinctId, properties, void 0, {
-            priority: "critical"
-          });
-          if (this.getDebug()) console.log("[Paywallo PURCHASE] emitted checkout_started", productId);
+    };
+    PURCHASE_ERROR_CODES = {
+      NOT_INITIALIZED: "PURCHASE_NOT_INITIALIZED",
+      PRODUCT_NOT_FOUND: "PRODUCT_NOT_FOUND",
+      PURCHASE_FAILED: "PURCHASE_FAILED",
+      RESTORE_FAILED: "RESTORE_FAILED",
+      VALIDATION_FAILED: "VALIDATION_FAILED",
+      USER_CANCELLED: "USER_CANCELLED",
+      NETWORK_ERROR: "PURCHASE_NETWORK_ERROR",
+      STORE_ERROR: "PURCHASE_STORE_ERROR",
+      PENDING_PURCHASE: "PURCHASE_PENDING",
+      DEFERRED_PURCHASE: "PURCHASE_DEFERRED",
+      STORE_NOT_AVAILABLE: "PURCHASE_STORE_NOT_AVAILABLE"
+    };
+    DEFAULT_MESSAGES = {
+      NOT_INITIALIZED: "Purchase controller not initialized. Call init() first.",
+      PRODUCT_NOT_FOUND: "Product not found in store.",
+      PURCHASE_FAILED: "Purchase failed. Please try again.",
+      RESTORE_FAILED: "Failed to restore purchases. Please try again.",
+      VALIDATION_FAILED: "Failed to validate purchase with server.",
+      USER_CANCELLED: "Purchase was cancelled.",
+      NETWORK_ERROR: "Network error. Please check your connection.",
+      STORE_ERROR: "Store error. Please try again later.",
+      PENDING_PURCHASE: "Purchase is pending approval.",
+      DEFERRED_PURCHASE: "Purchase is deferred (e.g., parental approval required).",
+      STORE_NOT_AVAILABLE: "In-app purchases are not available on this device."
+    };
+  }
+});
+
+// src/domains/iap/NativeStoreKit.ts
+var NativeStoreKit_exports = {};
+__export(NativeStoreKit_exports, {
+  NativeStoreKit: () => NativeStoreKit,
+  nativeStoreKit: () => nativeStoreKit
+});
+function isAvailable3() {
+  return PaywalloStoreKitNative != null;
+}
+function mapNativeProduct(native) {
+  const product = {
+    productId: native.productId,
+    title: native.title,
+    description: native.description,
+    price: native.price,
+    priceValue: native.priceValue,
+    currency: native.currency ?? "USD",
+    localizedPrice: native.localizedPrice,
+    type: mapProductType(native.type),
+    subscriptionPeriod: native.subscriptionPeriod,
+    introductoryPrice: native.introductoryPrice,
+    introductoryPriceValue: native.introductoryPriceValue,
+    freeTrialPeriod: native.freeTrialPeriod
+  };
+  if (native.subscriptionPeriod) {
+    const prices = calculatePerPeriodPrices(native.priceValue, native.subscriptionPeriod);
+    product.pricePerMonth = prices.perMonth;
+    product.pricePerWeek = prices.perWeek;
+    product.pricePerDay = prices.perDay;
+  }
+  return product;
+}
+function mapProductType(type) {
+  switch (type) {
+    case "subscription":
+    case "autoRenewable":
+      return "subscription";
+    case "consumable":
+      return "consumable";
+    default:
+      return "non_consumable";
+  }
+}
+function calculatePerPeriodPrices(priceValue, period) {
+  const totalDays = periodToDays(period);
+  if (totalDays <= 0) return {};
+  const perDay = priceValue / totalDays;
+  const perWeek = perDay * 7;
+  const perMonth = perDay * 30;
+  return {
+    perDay: perDay.toFixed(2),
+    perWeek: perWeek.toFixed(2),
+    perMonth: perMonth.toFixed(2)
+  };
+}
+function periodToDays(period) {
+  const match = period.match(/^P(\d+)([DWMY])$/);
+  if (!match) return 0;
+  const value = parseInt(match[1], 10);
+  switch (match[2]) {
+    case "D":
+      return value;
+    case "W":
+      return value * 7;
+    case "M":
+      return value * 30;
+    case "Y":
+      return value * 365;
+    default:
+      return 0;
+  }
+}
+function mapNativePurchase(native) {
+  return {
+    productId: native.productId,
+    transactionId: native.transactionId,
+    transactionDate: native.transactionDate,
+    receipt: native.receipt,
+    platform: import_react_native16.Platform.OS
+  };
+}
+function normalizeTransactionUpdate(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const r = raw;
+  const type = r.type;
+  if (type !== "renewed" && type !== "refunded" && type !== "canceled") return null;
+  const transactionId = typeof r.transactionId === "string" ? r.transactionId : null;
+  const productId = typeof r.productId === "string" ? r.productId : null;
+  if (!transactionId) return null;
+  const update = {
+    type,
+    transactionId,
+    productId: productId ?? ""
+  };
+  if (typeof r.amount === "number") update.amount = r.amount;
+  if (typeof r.currency === "string") update.currency = r.currency;
+  return update;
+}
+var import_react_native16, TRANSACTION_UPDATE_EVENT, PaywalloStoreKitNative, nativeStoreKit, NativeStoreKit;
+var init_NativeStoreKit = __esm({
+  "src/domains/iap/NativeStoreKit.ts"() {
+    "use strict";
+    import_react_native16 = require("react-native");
+    init_PaywalloClient();
+    init_uuid();
+    init_IdentityManager();
+    init_PurchaseError();
+    TRANSACTION_UPDATE_EVENT = "PaywalloTransactionUpdate";
+    PaywalloStoreKitNative = import_react_native16.NativeModules.PaywalloStoreKit ?? null;
+    nativeStoreKit = {
+      isAvailable: isAvailable3,
+      async getProducts(productIds) {
+        if (!PaywalloStoreKitNative) {
+          return [];
+        }
+        const nativeProducts = await PaywalloStoreKitNative.getProducts(productIds);
+        return nativeProducts.map(mapNativeProduct);
+      },
+      async purchase(productId) {
+        if (!PaywalloStoreKitNative) {
+          throw new PurchaseError(
+            PURCHASE_ERROR_CODES.STORE_NOT_AVAILABLE,
+            "StoreKit native module not available"
+          );
+        }
+        const distinctId = identityManager.getDistinctId();
+        const rawUuid = distinctId?.startsWith("$paywallo_anon:") ? distinctId.slice("$paywallo_anon:".length) : distinctId;
+        const appAccountToken = isValidUUIDv4(rawUuid) ? rawUuid : null;
+        if (distinctId && appAccountToken === null) {
+          if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] distinctId is not a valid UUID v4 \u2014 passing null to appAccountToken:", distinctId);
+        }
+        try {
+          const result = await PaywalloStoreKitNative.purchase(productId, appAccountToken);
+          if (!result || result.pending) {
+            return null;
+          }
+          return mapNativePurchase(result);
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          if (message.toLowerCase().includes("cancel")) {
+            throw new PurchaseError(PURCHASE_ERROR_CODES.USER_CANCELLED, message, true);
+          }
+          throw new PurchaseError(PURCHASE_ERROR_CODES.PURCHASE_FAILED, message);
+        }
+      },
+      async finishTransaction(transactionId) {
+        if (!PaywalloStoreKitNative) return;
+        try {
+          await PaywalloStoreKitNative.finishTransaction(transactionId);
+        } catch (err) {
+          console.error("[Paywallo] finishTransaction native error", err);
+        }
+      },
+      async getActiveTransactions() {
+        if (!PaywalloStoreKitNative) return [];
+        try {
+          const results = await PaywalloStoreKitNative.getActiveTransactions();
+          return results.map(mapNativePurchase);
+        } catch (err) {
+          console.error("[Paywallo] getActiveTransactions failed", err);
+          return [];
+        }
+      },
+      /**
+       * Subscribes to native transaction update events (renewals, refunds,
+       * cancellations) from StoreKit 2 (`Transaction.updates`) on iOS or
+       * `PurchasesUpdatedListener` + refund diff on Android.
+       *
+       * Returns a subscription with a `remove()` method. The caller is
+       * responsible for cleanup (typically on `Paywallo.reset()`).
+       *
+       * Returns `null` when the native module isn't available (non-mobile env,
+       * native module not linked) — callers should treat null as a no-op.
+       */
+      subscribeToTransactionUpdates(listener) {
+        if (!PaywalloStoreKitNative) return null;
+        try {
+          const EmitterCtor = import_react_native16.NativeEventEmitter;
+          const emitter = new EmitterCtor(PaywalloStoreKitNative);
+          const sub = emitter.addListener(TRANSACTION_UPDATE_EVENT, (payload) => {
+            const update = normalizeTransactionUpdate(payload);
+            if (update) listener(update);
+          });
+          return { remove: () => sub.remove() };
+        } catch (err) {
+          if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] subscribeToTransactionUpdates failed", err);
+          return null;
+        }
+      }
+    };
+    NativeStoreKit = nativeStoreKit;
+  }
+});
+
+// src/domains/iap/IAPTransactionEmitter.ts
+var IAPTransactionEmitter;
+var init_IAPTransactionEmitter = __esm({
+  "src/domains/iap/IAPTransactionEmitter.ts"() {
+    "use strict";
+    init_PaywalloClient();
+    init_NativeStoreKit();
+    IAPTransactionEmitter = class {
+      constructor(getProductFromCache, getApiClientFn, getDebug) {
+        this.getProductFromCache = getProductFromCache;
+        this.getApiClientFn = getApiClientFn;
+        this.getDebug = getDebug;
+        this.transactionUpdateSubscription = null;
+      }
+      /**
+       * Emits `transaction {type: "completed"}` after a server-validated purchase.
+       * Fire-and-forget — a tracking failure must never poison the purchase flow.
+       */
+      async emitTransactionCompleted(purchase, productId, options) {
+        try {
+          const apiClient = this.getApiClientFn();
+          if (!apiClient) return;
+          const distinctId = PaywalloClient.getDistinctId();
+          if (!distinctId) return;
+          const product = this.getProductFromCache(productId);
+          const properties = {
+            type: "completed",
+            tx_id: purchase.transactionId,
+            product_id: purchase.productId
+          };
+          if (product?.priceValue !== void 0 && product.priceValue > 0) {
+            properties.amount = product.priceValue;
+          }
+          if (product?.currency) {
+            properties.currency = product.currency;
+          }
+          if (options?.paywallId) properties.paywall_id = options.paywallId;
+          if (options?.variantId) properties.variant_id = options.variantId;
+          await apiClient.trackEvent("transaction", distinctId, properties, void 0, { priority: "critical" });
+        } catch (err) {
+          if (this.getDebug()) console.log("[Paywallo PURCHASE] transaction event emission failed", err);
+        }
+      }
+      /**
+       * Emits `checkout_started` quando o usuário inicia a compra (toca em comprar),
+       * antes do StoreKit/Billing abrir — conta mesmo que a sheet nativa seja cancelada.
+       * Vira InitiateCheckout no Meta/TikTok. Fire-and-forget — uma falha de tracking
+       * nunca pode travar a compra.
+       */
+      async emitCheckoutStarted(productId) {
+        try {
+          const apiClient = this.getApiClientFn();
+          if (!apiClient) return;
+          const distinctId = PaywalloClient.getDistinctId();
+          if (!distinctId) return;
+          const product = this.getProductFromCache(productId);
+          const properties = {
+            product_id: productId,
+            amount: product?.priceValue ?? 0,
+            currency: product?.currency ?? "USD"
+          };
+          await apiClient.trackEvent("checkout_started", distinctId, properties, void 0, {
+            priority: "critical"
+          });
+          if (this.getDebug()) console.log("[Paywallo PURCHASE] emitted checkout_started", productId);
         } catch (err) {
           if (this.getDebug()) console.log("[Paywallo PURCHASE] checkout_started emission failed", err);
         }
       }
       /**
-       * No-op. Native transaction update listener removed — sale events are sourced
-       * exclusively from server-side webhooks (Apple/Google/Superwall/RevenueCat).
+       * Forwards a native transaction update to the EventBatcher.
+       * Public so tests can exercise the wiring without a fake NativeEventEmitter.
+       */
+      async emitTransactionUpdate(update) {
+        try {
+          const apiClient = this.getApiClientFn() ?? PaywalloClient.getApiClient();
+          if (!apiClient) {
+            if (this.getDebug()) console.log("[Paywallo IAP] transaction update dropped (no apiClient)", update.type);
+            return;
+          }
+          const distinctId = PaywalloClient.getDistinctId();
+          if (!distinctId) {
+            if (this.getDebug()) console.log("[Paywallo IAP] transaction update dropped (no distinctId)", update.type);
+            return;
+          }
+          const properties = {
+            type: update.type,
+            tx_id: update.transactionId,
+            product_id: update.productId
+          };
+          if (update.type !== "canceled") {
+            const cached2 = this.getProductFromCache(update.productId);
+            const amount = update.amount ?? cached2?.priceValue;
+            const currency = update.currency ?? cached2?.currency;
+            if (typeof amount === "number" && amount > 0) properties.amount = amount;
+            if (currency) properties.currency = currency;
+          }
+          await apiClient.trackEvent("transaction", distinctId, properties, void 0, { priority: "critical" });
+          if (this.getDebug()) console.log(`[Paywallo IAP] emitted transaction {${update.type}}`, update.transactionId);
+        } catch (err) {
+          if (this.getDebug()) console.log("[Paywallo IAP] transaction update emission failed", err);
+        }
+      }
+      /**
+       * Starts listening to native Transaction.updates. Idempotent.
        */
       startListener() {
+        if (this.transactionUpdateSubscription) return;
+        this.transactionUpdateSubscription = nativeStoreKit.subscribeToTransactionUpdates(
+          (update) => {
+            void this.emitTransactionUpdate(update);
+          }
+        );
+        if (this.getDebug() && this.transactionUpdateSubscription) {
+          console.log("[Paywallo IAP] transaction update listener started");
+        }
       }
       /**
-       * No-op. See startListener.
+       * Removes the native listener. Safe to call multiple times.
        */
       stopListener() {
+        if (!this.transactionUpdateSubscription) return;
+        try {
+          this.transactionUpdateSubscription.remove();
+        } catch (err) {
+          if (this.getDebug()) console.log("[Paywallo IAP] transaction listener removal failed", err);
+        }
+        this.transactionUpdateSubscription = null;
+        if (this.getDebug()) console.log("[Paywallo IAP] transaction update listener stopped");
       }
     };
   }
@@ -4445,11 +4971,11 @@ var init_types2 = __esm({
 });
 
 // src/core/network/NetworkMonitor.ts
-var import_react_native16, NetworkMonitorClass, networkMonitor;
+var import_react_native17, NetworkMonitorClass, networkMonitor;
 var init_NetworkMonitor = __esm({
   "src/core/network/NetworkMonitor.ts"() {
     "use strict";
-    import_react_native16 = require("react-native");
+    import_react_native17 = require("react-native");
     init_types2();
     NetworkMonitorClass = class {
       constructor() {
@@ -4478,7 +5004,7 @@ var init_NetworkMonitor = __esm({
         }, this.config.checkInterval);
       }
       setupAppStateListener() {
-        this.appStateSubscription = import_react_native16.AppState.addEventListener("change", (state) => {
+        this.appStateSubscription = import_react_native17.AppState.addEventListener("change", (state) => {
           if (state === "active") {
             if (!this.checkIntervalId) {
               this.checkIntervalId = setInterval(() => {
@@ -4846,62 +5372,12 @@ var init_queue = __esm({
   }
 });
 
-// src/domains/iap/PurchaseError.ts
-function createPurchaseError(code, message) {
-  return new PurchaseError(
-    PURCHASE_ERROR_CODES[code],
-    message ?? DEFAULT_MESSAGES[code] ?? "Unknown purchase error",
-    code === "USER_CANCELLED"
-  );
-}
-var PurchaseError, PURCHASE_ERROR_CODES, DEFAULT_MESSAGES;
-var init_PurchaseError = __esm({
-  "src/domains/iap/PurchaseError.ts"() {
-    "use strict";
-    init_PaywalloError();
-    PurchaseError = class extends PaywalloError {
-      constructor(code, message, userCancelled = false, httpStatus) {
-        super("purchase", code, message);
-        this.name = "PurchaseError";
-        this.userCancelled = userCancelled;
-        this.httpStatus = httpStatus;
-      }
-    };
-    PURCHASE_ERROR_CODES = {
-      NOT_INITIALIZED: "PURCHASE_NOT_INITIALIZED",
-      PRODUCT_NOT_FOUND: "PRODUCT_NOT_FOUND",
-      PURCHASE_FAILED: "PURCHASE_FAILED",
-      RESTORE_FAILED: "RESTORE_FAILED",
-      VALIDATION_FAILED: "VALIDATION_FAILED",
-      USER_CANCELLED: "USER_CANCELLED",
-      NETWORK_ERROR: "PURCHASE_NETWORK_ERROR",
-      STORE_ERROR: "PURCHASE_STORE_ERROR",
-      PENDING_PURCHASE: "PURCHASE_PENDING",
-      DEFERRED_PURCHASE: "PURCHASE_DEFERRED",
-      STORE_NOT_AVAILABLE: "PURCHASE_STORE_NOT_AVAILABLE"
-    };
-    DEFAULT_MESSAGES = {
-      NOT_INITIALIZED: "Purchase controller not initialized. Call init() first.",
-      PRODUCT_NOT_FOUND: "Product not found in store.",
-      PURCHASE_FAILED: "Purchase failed. Please try again.",
-      RESTORE_FAILED: "Failed to restore purchases. Please try again.",
-      VALIDATION_FAILED: "Failed to validate purchase with server.",
-      USER_CANCELLED: "Purchase was cancelled.",
-      NETWORK_ERROR: "Network error. Please check your connection.",
-      STORE_ERROR: "Store error. Please try again later.",
-      PENDING_PURCHASE: "Purchase is pending approval.",
-      DEFERRED_PURCHASE: "Purchase is deferred (e.g., parental approval required).",
-      STORE_NOT_AVAILABLE: "In-app purchases are not available on this device."
-    };
-  }
-});
-
 // src/domains/iap/IAPValidator.ts
-var import_react_native17, IAPValidator;
+var import_react_native18, IAPValidator;
 var init_IAPValidator = __esm({
   "src/domains/iap/IAPValidator.ts"() {
     "use strict";
-    import_react_native17 = require("react-native");
+    import_react_native18 = require("react-native");
     init_PaywalloClient();
     init_queue();
     init_PurchaseError();
@@ -4927,7 +5403,7 @@ var init_IAPValidator = __esm({
       async validateWithServer(purchase, productId, options) {
         const apiClient = this.getApiClientFn();
         const product = this.getProductFromCache(productId);
-        const platform = import_react_native17.Platform.OS;
+        const platform = import_react_native18.Platform.OS;
         const distinctId = PaywalloClient.getDistinctId();
         return this.validateWithRetry(
           () => apiClient.validatePurchase(
@@ -4948,243 +5424,49 @@ var init_IAPValidator = __esm({
        * Bucketizes a validation failure into `server4xx` (permanent) vs `network` (transient).
        */
       classifyValidationError(error) {
-        if (error instanceof PurchaseError && typeof error.httpStatus === "number") {
-          const status = error.httpStatus;
-          if (status >= 400 && status < 500) return "server4xx";
-        }
-        return "network";
-      }
-      /**
-       * Pushes the validation payload into the offline queue for durable retry.
-       * The StoreKit transaction is intentionally left un-finished.
-       */
-      async enqueueValidationRetry(purchase, productId, options) {
-        try {
-          const apiClient = this.getApiClientFn();
-          const product = this.getProductFromCache(productId);
-          const platform = import_react_native17.Platform.OS;
-          const distinctId = PaywalloClient.getDistinctId();
-          const appKey = apiClient.getAppKey();
-          const body = {
-            platform,
-            receipt_data: purchase.receipt,
-            product_id: purchase.productId,
-            transaction_id: purchase.transactionId,
-            price_local: product?.priceValue ?? 0,
-            currency: product?.currency ?? "USD",
-            country: this.getDeviceCountry(),
-            distinct_id: distinctId
-          };
-          if (options?.paywallPlacement !== void 0) body.paywall_placement = options.paywallPlacement;
-          if (options?.variantKey !== void 0) body.variant_key = options.variantKey;
-          await offlineQueue.enqueue(
-            "POST",
-            "/sdk/purchases/validate",
-            body,
-            { "X-App-Key": appKey },
-            `validate:${purchase.transactionId}`,
-            "critical"
-          );
-          if (this.getDebug()) console.log("[Paywallo PURCHASE] validation retry enqueued", purchase.transactionId);
-        } catch (err) {
-          console.error("[Paywallo PURCHASE] failed to enqueue validation retry", err);
-        }
-      }
-    };
-  }
-});
-
-// src/domains/iap/NativeStoreKit.ts
-var NativeStoreKit_exports = {};
-__export(NativeStoreKit_exports, {
-  NativeStoreKit: () => NativeStoreKit,
-  nativeStoreKit: () => nativeStoreKit
-});
-function isAvailable3() {
-  return PaywalloStoreKitNative != null;
-}
-function mapNativeProduct(native) {
-  const product = {
-    productId: native.productId,
-    title: native.title,
-    description: native.description,
-    price: native.price,
-    priceValue: native.priceValue,
-    currency: native.currency ?? "USD",
-    localizedPrice: native.localizedPrice,
-    type: mapProductType(native.type),
-    subscriptionPeriod: native.subscriptionPeriod,
-    introductoryPrice: native.introductoryPrice,
-    introductoryPriceValue: native.introductoryPriceValue,
-    freeTrialPeriod: native.freeTrialPeriod
-  };
-  if (native.subscriptionPeriod) {
-    const prices = calculatePerPeriodPrices(native.priceValue, native.subscriptionPeriod);
-    product.pricePerMonth = prices.perMonth;
-    product.pricePerWeek = prices.perWeek;
-    product.pricePerDay = prices.perDay;
-  }
-  return product;
-}
-function mapProductType(type) {
-  switch (type) {
-    case "subscription":
-    case "autoRenewable":
-      return "subscription";
-    case "consumable":
-      return "consumable";
-    default:
-      return "non_consumable";
-  }
-}
-function calculatePerPeriodPrices(priceValue, period) {
-  const totalDays = periodToDays(period);
-  if (totalDays <= 0) return {};
-  const perDay = priceValue / totalDays;
-  const perWeek = perDay * 7;
-  const perMonth = perDay * 30;
-  return {
-    perDay: perDay.toFixed(2),
-    perWeek: perWeek.toFixed(2),
-    perMonth: perMonth.toFixed(2)
-  };
-}
-function periodToDays(period) {
-  const match = period.match(/^P(\d+)([DWMY])$/);
-  if (!match) return 0;
-  const value = parseInt(match[1], 10);
-  switch (match[2]) {
-    case "D":
-      return value;
-    case "W":
-      return value * 7;
-    case "M":
-      return value * 30;
-    case "Y":
-      return value * 365;
-    default:
-      return 0;
-  }
-}
-function mapNativePurchase(native) {
-  return {
-    productId: native.productId,
-    transactionId: native.transactionId,
-    transactionDate: native.transactionDate,
-    receipt: native.receipt,
-    platform: import_react_native18.Platform.OS
-  };
-}
-function normalizeTransactionUpdate(raw) {
-  if (!raw || typeof raw !== "object") return null;
-  const r = raw;
-  const type = r.type;
-  if (type !== "renewed" && type !== "refunded" && type !== "canceled") return null;
-  const transactionId = typeof r.transactionId === "string" ? r.transactionId : null;
-  const productId = typeof r.productId === "string" ? r.productId : null;
-  if (!transactionId) return null;
-  const update = {
-    type,
-    transactionId,
-    productId: productId ?? ""
-  };
-  if (typeof r.amount === "number") update.amount = r.amount;
-  if (typeof r.currency === "string") update.currency = r.currency;
-  return update;
-}
-var import_react_native18, TRANSACTION_UPDATE_EVENT, PaywalloStoreKitNative, nativeStoreKit, NativeStoreKit;
-var init_NativeStoreKit = __esm({
-  "src/domains/iap/NativeStoreKit.ts"() {
-    "use strict";
-    import_react_native18 = require("react-native");
-    init_PaywalloClient();
-    init_uuid();
-    init_IdentityManager();
-    init_PurchaseError();
-    TRANSACTION_UPDATE_EVENT = "PaywalloTransactionUpdate";
-    PaywalloStoreKitNative = import_react_native18.NativeModules.PaywalloStoreKit ?? null;
-    nativeStoreKit = {
-      isAvailable: isAvailable3,
-      async getProducts(productIds) {
-        if (!PaywalloStoreKitNative) {
-          return [];
-        }
-        const nativeProducts = await PaywalloStoreKitNative.getProducts(productIds);
-        return nativeProducts.map(mapNativeProduct);
-      },
-      async purchase(productId) {
-        if (!PaywalloStoreKitNative) {
-          throw new PurchaseError(
-            PURCHASE_ERROR_CODES.STORE_NOT_AVAILABLE,
-            "StoreKit native module not available"
-          );
-        }
-        const distinctId = identityManager.getDistinctId();
-        const rawUuid = distinctId?.startsWith("$paywallo_anon:") ? distinctId.slice("$paywallo_anon:".length) : distinctId;
-        const appAccountToken = isValidUUIDv4(rawUuid) ? rawUuid : null;
-        if (distinctId && appAccountToken === null) {
-          if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] distinctId is not a valid UUID v4 \u2014 passing null to appAccountToken:", distinctId);
-        }
-        try {
-          const result = await PaywalloStoreKitNative.purchase(productId, appAccountToken);
-          if (!result || result.pending) {
-            return null;
-          }
-          return mapNativePurchase(result);
-        } catch (err) {
-          const message = err instanceof Error ? err.message : String(err);
-          if (message.toLowerCase().includes("cancel")) {
-            throw new PurchaseError(PURCHASE_ERROR_CODES.USER_CANCELLED, message, true);
-          }
-          throw new PurchaseError(PURCHASE_ERROR_CODES.PURCHASE_FAILED, message);
-        }
-      },
-      async finishTransaction(transactionId) {
-        if (!PaywalloStoreKitNative) return;
-        try {
-          await PaywalloStoreKitNative.finishTransaction(transactionId);
-        } catch (err) {
-          console.error("[Paywallo] finishTransaction native error", err);
-        }
-      },
-      async getActiveTransactions() {
-        if (!PaywalloStoreKitNative) return [];
-        try {
-          const results = await PaywalloStoreKitNative.getActiveTransactions();
-          return results.map(mapNativePurchase);
-        } catch (err) {
-          console.error("[Paywallo] getActiveTransactions failed", err);
-          return [];
+        if (error instanceof PurchaseError && typeof error.httpStatus === "number") {
+          const status = error.httpStatus;
+          if (status >= 400 && status < 500) return "server4xx";
         }
-      },
+        return "network";
+      }
       /**
-       * Subscribes to native transaction update events (renewals, refunds,
-       * cancellations) from StoreKit 2 (`Transaction.updates`) on iOS or
-       * `PurchasesUpdatedListener` + refund diff on Android.
-       *
-       * Returns a subscription with a `remove()` method. The caller is
-       * responsible for cleanup (typically on `Paywallo.reset()`).
-       *
-       * Returns `null` when the native module isn't available (non-mobile env,
-       * native module not linked) — callers should treat null as a no-op.
+       * Pushes the validation payload into the offline queue for durable retry.
+       * The StoreKit transaction is intentionally left un-finished.
        */
-      subscribeToTransactionUpdates(listener) {
-        if (!PaywalloStoreKitNative) return null;
+      async enqueueValidationRetry(purchase, productId, options) {
         try {
-          const EmitterCtor = import_react_native18.NativeEventEmitter;
-          const emitter = new EmitterCtor(PaywalloStoreKitNative);
-          const sub = emitter.addListener(TRANSACTION_UPDATE_EVENT, (payload) => {
-            const update = normalizeTransactionUpdate(payload);
-            if (update) listener(update);
-          });
-          return { remove: () => sub.remove() };
+          const apiClient = this.getApiClientFn();
+          const product = this.getProductFromCache(productId);
+          const platform = import_react_native18.Platform.OS;
+          const distinctId = PaywalloClient.getDistinctId();
+          const appKey = apiClient.getAppKey();
+          const body = {
+            platform,
+            receipt_data: purchase.receipt,
+            product_id: purchase.productId,
+            transaction_id: purchase.transactionId,
+            price_local: product?.priceValue ?? 0,
+            currency: product?.currency ?? "USD",
+            country: this.getDeviceCountry(),
+            distinct_id: distinctId
+          };
+          if (options?.paywallPlacement !== void 0) body.paywall_placement = options.paywallPlacement;
+          if (options?.variantKey !== void 0) body.variant_key = options.variantKey;
+          await offlineQueue.enqueue(
+            "POST",
+            "/sdk/purchases/validate",
+            body,
+            { "X-App-Key": appKey },
+            `validate:${purchase.transactionId}`,
+            "critical"
+          );
+          if (this.getDebug()) console.log("[Paywallo PURCHASE] validation retry enqueued", purchase.transactionId);
         } catch (err) {
-          if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] subscribeToTransactionUpdates failed", err);
-          return null;
+          console.error("[Paywallo PURCHASE] failed to enqueue validation retry", err);
         }
       }
     };
-    NativeStoreKit = nativeStoreKit;
   }
 });
 
@@ -5288,8 +5570,8 @@ var init_IAPService = __esm({
       stopTransactionListener() {
         this.emitter.stopListener();
       }
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
-      async emitTransactionUpdate(_update) {
+      async emitTransactionUpdate(update) {
+        return this.emitter.emitTransactionUpdate(update);
       }
       async purchase(productId, options) {
         if (!nativeStoreKit.isAvailable()) {
@@ -5318,6 +5600,10 @@ var init_IAPService = __esm({
             if (this.debug) console.log(`[Paywallo PURCHASE] ${productId} server validated`);
             await this.finishTransaction(purchase.transactionId);
             if (this.debug) console.log(`[Paywallo PURCHASE] ${productId} finished`);
+            await this.emitter.emitTransactionCompleted(purchase, productId, {
+              paywallId: options?.paywallId,
+              variantId: options?.variantId
+            });
           }).catch(async (err) => {
             const kind = this.validator.classifyValidationError(err);
             if (kind === "server4xx") {
@@ -6299,254 +6585,117 @@ var init_PlanService = __esm({
               (p) => p.identifier === cached2.data.currentIdentifier
             );
             return current ?? null;
-          }
-        }
-        if (!this.cache.get()) {
-          try {
-            const stored = await secureStorage.get(ALL_PLANS_CACHE_KEY);
-            if (stored) {
-              const parsed = JSON.parse(stored);
-              this.cache.set(parsed);
-            }
-          } catch {
-          }
-        }
-        const memCached = this.cache.get();
-        if (memCached) {
-          void this.fetchAllPlans();
-          const current = memCached.data.plans.find(
-            (p) => p.identifier === memCached.data.currentIdentifier
-          );
-          return current ?? null;
-        }
-        return this.fetchCurrentPlan();
-      }
-      async getAllPlans(forceRefresh = false) {
-        if (!forceRefresh) {
-          const cached2 = this.cache.get();
-          if (cached2 && !cached2.isStale) return cached2.data;
-        }
-        if (!this.cache.get()) {
-          try {
-            const stored = await secureStorage.get(ALL_PLANS_CACHE_KEY);
-            if (stored) {
-              const parsed = JSON.parse(stored);
-              this.cache.set(parsed);
-            }
-          } catch {
-          }
-        }
-        const memCached = this.cache.get();
-        if (memCached) {
-          void this.fetchAllPlans();
-          return memCached.data;
-        }
-        return this.fetchAllPlans();
-      }
-      invalidateCache() {
-        this.cache.invalidate();
-        secureStorage.remove(PLAN_CACHE_KEY).catch(() => void 0);
-        secureStorage.remove(ALL_PLANS_CACHE_KEY).catch(() => void 0);
-      }
-      getApiClient() {
-        if (!this.config) {
-          throw new PlanError(PLAN_ERROR_CODES.NOT_INITIALIZED, "PlanService not initialized. Call Paywallo.init() first");
-        }
-        return this.config.apiClient;
-      }
-      async fetchCurrentPlan() {
-        try {
-          const res = await this.getApiClient().get("/sdk/plans");
-          if (!res.ok) {
-            this.log("fetchCurrentPlan failed", res.status);
-            return null;
-          }
-          const raw = res.data.data.plan;
-          return raw ? mapPlan(raw) : null;
-        } catch (err) {
-          this.log("fetchCurrentPlan error", err);
-          return null;
-        }
-      }
-      async fetchAllPlans() {
-        try {
-          const res = await this.getApiClient().get("/sdk/plans/all");
-          if (!res.ok) {
-            this.log("fetchAllPlans failed", res.status);
-            return { plans: [], currentIdentifier: null };
-          }
-          const result = {
-            plans: res.data.data.plans.map(mapPlan),
-            currentIdentifier: res.data.data.current_identifier
-          };
-          this.cache.set(result);
-          secureStorage.set(ALL_PLANS_CACHE_KEY, JSON.stringify(result)).catch(() => void 0);
-          return result;
-        } catch (err) {
-          this.log("fetchAllPlans error", err);
-          return { plans: [], currentIdentifier: null };
-        }
-      }
-      log(...args) {
-        if (this.config?.debug) console.log("[Paywallo Plans]", ...args);
-      }
-    };
-    planService = new PlanService();
-  }
-});
-
-// src/domains/plan/index.ts
-var init_plan = __esm({
-  "src/domains/plan/index.ts"() {
-    "use strict";
-    init_PlanCache();
-    init_PlanService();
-  }
-});
-
-// src/domains/session/index.ts
-var init_session = __esm({
-  "src/domains/session/index.ts"() {
-    "use strict";
-    init_SessionError();
-    init_SessionManager();
-  }
-});
-
-// src/domains/onboarding/OnboardingError.ts
-var OnboardingError, ONBOARDING_ERROR_CODES;
-var init_OnboardingError = __esm({
-  "src/domains/onboarding/OnboardingError.ts"() {
-    "use strict";
-    init_PaywalloError();
-    OnboardingError = class extends PaywalloError {
-      constructor(code, message) {
-        super("onboarding", code, message);
-        this.name = "OnboardingError";
-      }
-    };
-    ONBOARDING_ERROR_CODES = {
-      NOT_INITIALIZED: "ONBOARDING_NOT_INITIALIZED",
-      INVALID_STEP_NAME: "ONBOARDING_INVALID_STEP_NAME"
-    };
-  }
-});
-
-// src/domains/onboarding/OnboardingManager.ts
-var OnboardingManager, onboardingManager;
-var init_OnboardingManager = __esm({
-  "src/domains/onboarding/OnboardingManager.ts"() {
-    "use strict";
-    init_OnboardingError();
-    OnboardingManager = class {
-      constructor() {
-        this.pipeline = null;
-        this.debug = false;
-        this.lastStep = null;
-        this.finished = false;
-      }
-      /**
-       * Injects runtime dependencies. Called by PaywalloClient during init.
-       */
-      injectDeps(config) {
-        this.pipeline = config.pipeline;
-        this.debug = config.debug ?? false;
-      }
-      /**
-       * Tracks an onboarding step view.
-       * Saves the step name internally for implicit drop detection on the backend.
-       *
-       * @param stepName - Unique name for this onboarding step.
-       * @param order - Optional explicit display order (accepts decimals, e.g. 2.1 for A/B variants).
-       */
-      async step(stepName, order) {
-        this.assertConfig();
-        this.validateStepName(stepName, "step");
-        this.lastStep = stepName;
-        const stepPayload = { step_name: stepName };
-        if (order !== void 0 && Number.isFinite(order) && order >= 0) {
-          stepPayload.order = order;
-        }
-        const payload = {
-          family: "onboarding",
-          type: "step",
-          ...stepPayload
-        };
-        return this.emit("onboarding", payload, "step");
-      }
-      /**
-       * Tracks successful completion of the onboarding flow.
-       * Marks the flow as finished.
-       */
-      async complete() {
-        this.assertConfig();
-        this.finished = true;
-        return this.emit("onboarding", { family: "onboarding", type: "complete" }, "complete");
-      }
-      /**
-       * Tracks an explicit drop (abandonment) at the given step.
-       * Marks the flow as finished.
-       *
-       * @param stepName - The step name where the user dropped off.
-       */
-      async drop(stepName) {
-        this.assertConfig();
-        this.validateStepName(stepName, "drop");
-        this.finished = true;
-        const payload = {
-          family: "onboarding",
-          type: "drop",
-          ...{ step_name: stepName }
-        };
-        return this.emit("onboarding", payload, "drop");
+          }
+        }
+        if (!this.cache.get()) {
+          try {
+            const stored = await secureStorage.get(ALL_PLANS_CACHE_KEY);
+            if (stored) {
+              const parsed = JSON.parse(stored);
+              this.cache.set(parsed);
+            }
+          } catch {
+          }
+        }
+        const memCached = this.cache.get();
+        if (memCached) {
+          void this.fetchAllPlans();
+          const current = memCached.data.plans.find(
+            (p) => p.identifier === memCached.data.currentIdentifier
+          );
+          return current ?? null;
+        }
+        return this.fetchCurrentPlan();
       }
-      /** Returns the last step name seen, or null if no step was tracked yet. */
-      getLastStep() {
-        return this.lastStep;
+      async getAllPlans(forceRefresh = false) {
+        if (!forceRefresh) {
+          const cached2 = this.cache.get();
+          if (cached2 && !cached2.isStale) return cached2.data;
+        }
+        if (!this.cache.get()) {
+          try {
+            const stored = await secureStorage.get(ALL_PLANS_CACHE_KEY);
+            if (stored) {
+              const parsed = JSON.parse(stored);
+              this.cache.set(parsed);
+            }
+          } catch {
+          }
+        }
+        const memCached = this.cache.get();
+        if (memCached) {
+          void this.fetchAllPlans();
+          return memCached.data;
+        }
+        return this.fetchAllPlans();
       }
-      /** Returns whether the flow has been marked as finished (complete or drop). */
-      isFinished() {
-        return this.finished;
+      invalidateCache() {
+        this.cache.invalidate();
+        secureStorage.remove(PLAN_CACHE_KEY).catch(() => void 0);
+        secureStorage.remove(ALL_PLANS_CACHE_KEY).catch(() => void 0);
       }
-      async emit(eventName, properties, logLabel) {
-        const pipeline = this.pipeline;
-        const distinctId = pipeline.getDistinctId();
-        if (!distinctId) {
-          if (this.debug) console.log(`[Paywallo:Onboarding] skipped (no distinctId): ${logLabel}`);
-          return;
-        }
-        await pipeline.trackEvent(eventName, distinctId, properties);
-        if (this.debug) {
-          console.log(`[Paywallo:Onboarding] event emitted: ${eventName}.${logLabel}`, properties);
+      getApiClient() {
+        if (!this.config) {
+          throw new PlanError(PLAN_ERROR_CODES.NOT_INITIALIZED, "PlanService not initialized. Call Paywallo.init() first");
         }
+        return this.config.apiClient;
       }
-      assertConfig() {
-        if (!this.pipeline) {
-          throw new OnboardingError(
-            ONBOARDING_ERROR_CODES.NOT_INITIALIZED,
-            "OnboardingManager not initialized. Call Paywallo.init() first."
-          );
+      async fetchCurrentPlan() {
+        try {
+          const res = await this.getApiClient().get("/sdk/plans");
+          if (!res.ok) {
+            this.log("fetchCurrentPlan failed", res.status);
+            return null;
+          }
+          const raw = res.data.data.plan;
+          return raw ? mapPlan(raw) : null;
+        } catch (err) {
+          this.log("fetchCurrentPlan error", err);
+          return null;
         }
       }
-      validateStepName(stepName, method) {
-        if (typeof stepName !== "string" || stepName.trim().length === 0) {
-          throw new OnboardingError(
-            ONBOARDING_ERROR_CODES.INVALID_STEP_NAME,
-            `OnboardingManager.${method}(): stepName must be a non-empty string.`
-          );
+      async fetchAllPlans() {
+        try {
+          const res = await this.getApiClient().get("/sdk/plans/all");
+          if (!res.ok) {
+            this.log("fetchAllPlans failed", res.status);
+            return { plans: [], currentIdentifier: null };
+          }
+          const result = {
+            plans: res.data.data.plans.map(mapPlan),
+            currentIdentifier: res.data.data.current_identifier
+          };
+          this.cache.set(result);
+          secureStorage.set(ALL_PLANS_CACHE_KEY, JSON.stringify(result)).catch(() => void 0);
+          return result;
+        } catch (err) {
+          this.log("fetchAllPlans error", err);
+          return { plans: [], currentIdentifier: null };
         }
       }
+      log(...args) {
+        if (this.config?.debug) console.log("[Paywallo Plans]", ...args);
+      }
     };
-    onboardingManager = new OnboardingManager();
+    planService = new PlanService();
   }
 });
 
-// src/domains/onboarding/index.ts
-var init_onboarding = __esm({
-  "src/domains/onboarding/index.ts"() {
+// src/domains/plan/index.ts
+var init_plan = __esm({
+  "src/domains/plan/index.ts"() {
     "use strict";
-    init_OnboardingError();
-    init_OnboardingManager();
+    init_PlanCache();
+    init_PlanService();
+  }
+});
+
+// src/domains/session/index.ts
+var init_session = __esm({
+  "src/domains/session/index.ts"() {
+    "use strict";
+    init_SessionError();
+    init_SessionManager();
   }
 });
 
@@ -6622,7 +6771,21 @@ var init_schemas = __esm({
       // `closed`-specific
       closed_at: import_zod.z.string().optional(),
       duration_s: import_zod.z.number().nonnegative().optional(),
-      close_reason: import_zod.z.enum(["dismiss", "cta", "purchase", "error", "timeout"]).optional(),
+      // Two emitter dialects coexist: the canonical emitters
+      // (`emitPaywallClosed`/heartbeat) send "dismiss"/"cta"/"purchase"/"error"/
+      // "timeout"; the SuperwallAutoBridge forwards the server-enum values
+      // "purchased"/"dismissed"/"restored" straight through. The server accepts
+      // both — the schema must too, or every bridge close fails debug validation.
+      close_reason: import_zod.z.enum([
+        "dismiss",
+        "cta",
+        "purchase",
+        "error",
+        "timeout",
+        "purchased",
+        "dismissed",
+        "restored"
+      ]).optional(),
       scroll_depth: import_zod.z.number().min(0).max(1).optional(),
       // `purchased`-specific (mínimo — transaction canônica leva detalhes)
       product_id: import_zod.z.string().optional()
@@ -6630,21 +6793,33 @@ var init_schemas = __esm({
     transactionEventSchema = import_zod.z.object({
       type: import_zod.z.enum([
         "completed",
+        "trial_started",
         "failed",
         "refunded",
         "renewed",
         "canceled",
         "expired"
       ]),
-      tx_id: import_zod.z.string().min(1),
+      // Server contract key is `transaction_id` (what IngestTranslator reads and
+      // the SuperwallAutoBridge emits); `tx_id` is the legacy key still emitted
+      // by IAPTransactionEmitter — the server accepts both. At least one is
+      // required (enforced by the refine below).
+      transaction_id: import_zod.z.string().min(1).optional(),
+      tx_id: import_zod.z.string().min(1).optional(),
       amount: import_zod.z.number().optional(),
+      // Full (post-trial) price carried on trial_started for analytics, since
+      // `amount` is 0 for a free trial.
+      full_price: import_zod.z.number().nonnegative().optional(),
       currency: import_zod.z.string().length(3).optional(),
       product_id: import_zod.z.string().optional(),
       subscription_id: import_zod.z.string().optional(),
       paywall_id: import_zod.z.string().optional(),
       variant_id: import_zod.z.string().optional(),
       reason: import_zod.z.string().optional()
-    }).strict();
+    }).strict().refine((v) => v.transaction_id !== void 0 || v.tx_id !== void 0, {
+      message: "transaction requires transaction_id (or legacy tx_id)",
+      path: ["transaction_id"]
+    });
     onboardingEventSchema = import_zod.z.object({
       type: import_zod.z.enum(["step", "complete", "drop"]),
       step_index: import_zod.z.number().int().nonnegative().optional(),
@@ -7474,8 +7649,13 @@ var init_ApiClientFlags = __esm({
 });
 
 // src/core/ApiClientQueue.ts
+function isServerError(res) {
+  if (typeof res !== "object" || res === null) return false;
+  const r = res;
+  return r.ok === false && typeof r.status === "number" && r.status >= 500;
+}
 async function postWithQueue(deps, url, payload, label, priority) {
-  if (deps.isOfflineQueueEnabled() && !networkMonitor.isOnline()) {
+  const enqueue = async () => {
     await offlineQueue.enqueue(
       "POST",
       url,
@@ -7484,22 +7664,22 @@ async function postWithQueue(deps, url, payload, label, priority) {
       void 0,
       priority
     );
+  };
+  if (deps.isOfflineQueueEnabled() && !networkMonitor.isOnline()) {
+    await enqueue();
     if (deps.isDebug()) console.log("[Paywallo:ApiClient] Queued for offline:", label, priority ?? "normal");
     return;
   }
   try {
-    await deps.post(url, payload);
+    const res = await deps.post(url, payload);
+    if (isServerError(res) && deps.isOfflineQueueEnabled()) {
+      if (deps.isDebug()) console.log("[Paywallo:ApiClient] Server error, queued for retry:", label, priority ?? "normal");
+      await enqueue();
+    }
   } catch (error) {
     if (deps.isDebug()) console.log("[Paywallo:ApiClient] Request failed:", label, error);
     if (deps.isOfflineQueueEnabled()) {
-      await offlineQueue.enqueue(
-        "POST",
-        url,
-        payload,
-        { "X-App-Key": deps.getAppKey() },
-        void 0,
-        priority
-      );
+      await enqueue();
       return;
     }
     throw error;
@@ -8905,11 +9085,11 @@ var init_PaywalloClient = __esm({
     init_campaign();
     init_identity();
     init_notifications();
+    init_onboarding();
     init_paywall();
     init_plan();
     init_session();
     init_ClientError();
-    init_onboarding();
     init_network();
     init_PaywalloAnalytics();
     init_PaywalloFlags();
@@ -9616,8 +9796,41 @@ function usePlanPurchase() {
   };
 }
 
-// src/hooks/usePlans.ts
+// src/hooks/usePaywalloScreenTracking.ts
 var import_react18 = require("react");
+init_PaywalloClient();
+function isNavState(value) {
+  return typeof value === "object" && value !== null && "routes" in value && "index" in value && Array.isArray(value.routes) && typeof value.index === "number";
+}
+function getActiveRouteName(state) {
+  try {
+    if (!isNavState(state)) return null;
+    const route = state.routes[state.index];
+    if (!route) return null;
+    if (isNavState(route.state)) {
+      return getActiveRouteName(route.state);
+    }
+    return typeof route.name === "string" ? route.name : null;
+  } catch {
+    return null;
+  }
+}
+function usePaywalloScreenTracking() {
+  const lastScreenRef = (0, import_react18.useRef)(null);
+  return (0, import_react18.useCallback)((state) => {
+    if (!PaywalloClient.isReady()) return;
+    const screenName = getActiveRouteName(state);
+    if (!screenName || screenName === lastScreenRef.current) return;
+    lastScreenRef.current = screenName;
+    void PaywalloClient.track("screen_view", {
+      properties: { screen_name: screenName }
+    }).catch(() => {
+    });
+  }, []);
+}
+
+// src/hooks/usePlans.ts
+var import_react19 = require("react");
 async function getPlanService() {
   try {
     const mod = await Promise.resolve().then(() => (init_PlanService(), PlanService_exports));
@@ -9627,11 +9840,11 @@ async function getPlanService() {
   }
 }
 function usePlans() {
-  const [allPlans, setAllPlans] = (0, import_react18.useState)([]);
-  const [currentPlan, setCurrentPlan] = (0, import_react18.useState)(null);
-  const [isLoading, setIsLoading] = (0, import_react18.useState)(true);
-  const [error, setError] = (0, import_react18.useState)(null);
-  const fetchPlans = (0, import_react18.useCallback)(async (forceRefresh = false) => {
+  const [allPlans, setAllPlans] = (0, import_react19.useState)([]);
+  const [currentPlan, setCurrentPlan] = (0, import_react19.useState)(null);
+  const [isLoading, setIsLoading] = (0, import_react19.useState)(true);
+  const [error, setError] = (0, import_react19.useState)(null);
+  const fetchPlans = (0, import_react19.useCallback)(async (forceRefresh = false) => {
     setIsLoading(true);
     setError(null);
     try {
@@ -9652,17 +9865,17 @@ function usePlans() {
       setIsLoading(false);
     }
   }, []);
-  const refresh = (0, import_react18.useCallback)(() => {
+  const refresh = (0, import_react19.useCallback)(() => {
     return fetchPlans(true);
   }, [fetchPlans]);
-  (0, import_react18.useEffect)(() => {
+  (0, import_react19.useEffect)(() => {
     void fetchPlans(false);
   }, [fetchPlans]);
   return { currentPlan, allPlans, isLoading, error, refresh };
 }
 
 // src/hooks/useProducts.ts
-var import_react19 = require("react");
+var import_react20 = require("react");
 
 // src/utils/productMappers.ts
 function mapToIAPProduct(product) {
@@ -9701,11 +9914,11 @@ function mapToFormattedProduct(product) {
 
 // src/hooks/useProducts.ts
 function useProducts(initialProductIds) {
-  const [products, setProducts] = (0, import_react19.useState)([]);
-  const [formattedProducts, setFormattedProducts] = (0, import_react19.useState)([]);
-  const [isLoading, setIsLoading] = (0, import_react19.useState)(false);
-  const [error, setError] = (0, import_react19.useState)(null);
-  const loadProducts = (0, import_react19.useCallback)(async (productIds) => {
+  const [products, setProducts] = (0, import_react20.useState)([]);
+  const [formattedProducts, setFormattedProducts] = (0, import_react20.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react20.useState)(false);
+  const [error, setError] = (0, import_react20.useState)(null);
+  const loadProducts = (0, import_react20.useCallback)(async (productIds) => {
     setIsLoading(true);
     setError(null);
     try {
@@ -9719,24 +9932,24 @@ function useProducts(initialProductIds) {
       setIsLoading(false);
     }
   }, []);
-  (0, import_react19.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     if (initialProductIds && initialProductIds.length > 0) {
       void loadProducts(initialProductIds);
     }
   }, []);
-  const getProduct = (0, import_react19.useCallback)(
+  const getProduct = (0, import_react20.useCallback)(
     (productId) => {
       return products.find((p) => p.productId === productId);
     },
     [products]
   );
-  const getFormattedProduct = (0, import_react19.useCallback)(
+  const getFormattedProduct = (0, import_react20.useCallback)(
     (productId) => {
       return formattedProducts.find((p) => p.productId === productId);
     },
     [formattedProducts]
   );
-  const getPriceInfo = (0, import_react19.useCallback)(
+  const getPriceInfo = (0, import_react20.useCallback)(
     (productId) => {
       const p = formattedProducts.find((fp) => fp.productId === productId);
       if (!p) return void 0;
@@ -9765,14 +9978,14 @@ function useProducts(initialProductIds) {
 }
 
 // src/hooks/usePurchase.ts
-var import_react20 = require("react");
+var import_react21 = require("react");
 function toIAPPurchase(p) {
   return { productId: p.productId, transactionId: p.transactionId, transactionDate: p.transactionDate, transactionReceipt: p.receipt };
 }
 function usePurchase() {
-  const [state, setState] = (0, import_react20.useState)("idle");
-  const [error, setError] = (0, import_react20.useState)(null);
-  const purchase = (0, import_react20.useCallback)(async (productId) => {
+  const [state, setState] = (0, import_react21.useState)("idle");
+  const [error, setError] = (0, import_react21.useState)(null);
+  const purchase = (0, import_react21.useCallback)(async (productId) => {
     setState("purchasing");
     setError(null);
     try {
@@ -9800,7 +10013,7 @@ function usePurchase() {
       return { status: "failed", error: purchaseError };
     }
   }, []);
-  const restore = (0, import_react20.useCallback)(async () => {
+  const restore = (0, import_react21.useCallback)(async () => {
     setState("restoring");
     setError(null);
     try {
@@ -9819,14 +10032,14 @@ function usePurchase() {
 }
 
 // src/hooks/useSubscription.ts
-var import_react21 = require("react");
+var import_react22 = require("react");
 init_SubscriptionManager();
 var EMPTY_ENTITLEMENTS = [];
 function useSubscription() {
-  const [status, setStatus] = (0, import_react21.useState)(null);
-  const [isLoading, setIsLoading] = (0, import_react21.useState)(true);
-  const [error, setError] = (0, import_react21.useState)(null);
-  const refresh = (0, import_react21.useCallback)(async () => {
+  const [status, setStatus] = (0, import_react22.useState)(null);
+  const [isLoading, setIsLoading] = (0, import_react22.useState)(true);
+  const [error, setError] = (0, import_react22.useState)(null);
+  const refresh = (0, import_react22.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -9839,7 +10052,7 @@ function useSubscription() {
       setIsLoading(false);
     }
   }, []);
-  const restore = (0, import_react21.useCallback)(async () => {
+  const restore = (0, import_react22.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -9852,7 +10065,7 @@ function useSubscription() {
       setIsLoading(false);
     }
   }, []);
-  (0, import_react21.useEffect)(() => {
+  (0, import_react22.useEffect)(() => {
     void subscriptionManager.getSubscriptionStatus().then((s) => {
       setStatus(s);
       setIsLoading(false);
@@ -9879,39 +10092,6 @@ function useSubscription() {
   };
 }
 
-// src/hooks/usePaywalloScreenTracking.ts
-var import_react22 = require("react");
-init_PaywalloClient();
-function isNavState(value) {
-  return typeof value === "object" && value !== null && "routes" in value && "index" in value && Array.isArray(value.routes) && typeof value.index === "number";
-}
-function getActiveRouteName(state) {
-  try {
-    if (!isNavState(state)) return null;
-    const route = state.routes[state.index];
-    if (!route) return null;
-    if (isNavState(route.state)) {
-      return getActiveRouteName(route.state);
-    }
-    return typeof route.name === "string" ? route.name : null;
-  } catch {
-    return null;
-  }
-}
-function usePaywalloScreenTracking() {
-  const lastScreenRef = (0, import_react22.useRef)(null);
-  return (0, import_react22.useCallback)((state) => {
-    if (!PaywalloClient.isReady()) return;
-    const screenName = getActiveRouteName(state);
-    if (!screenName || screenName === lastScreenRef.current) return;
-    lastScreenRef.current = screenName;
-    void PaywalloClient.track("screen_view", {
-      properties: { screen_name: screenName }
-    }).catch(() => {
-    });
-  }, []);
-}
-
 // src/PaywalloProvider.tsx
 var import_react28 = require("react");
 var import_react_native29 = require("react-native");
@@ -9919,6 +10099,7 @@ init_PaywalloClient();
 init_NativeStorage();
 init_SecureStorage();
 init_campaign();
+init_identity();
 init_paywall();
 init_paywall();
 init_paywall();
@@ -9930,7 +10111,9 @@ init_paywall();
 init_identity();
 var CONFIG_POLL_INTERVAL_MS = 250;
 var CONFIG_POLL_MAX_ATTEMPTS = 40;
+var CONFIG_RETRY_DELAYS_MS = [3e4, 6e4, 12e4];
 var lastSignature = null;
+var retryTimer = null;
 function log(debug, msg, data) {
   if (!debug) return;
   if (data !== void 0) console.log(`[Paywallo:SuperwallAttr] ${msg}`, data);
@@ -9997,28 +10180,37 @@ async function waitForConfigured(mod, debug) {
       status = String(await mod.getConfigurationStatus());
     } catch (err) {
       log(debug, "getConfigurationStatus error", { err: String(err) });
-      return false;
+      return "failed";
     }
-    if (status === "CONFIGURED") return true;
+    if (status === "CONFIGURED") return "configured";
     if (status === "FAILED") {
       log(debug, "Superwall configuration FAILED \u2014 skipping attribute push");
-      return false;
+      return "failed";
     }
     await delay(CONFIG_POLL_INTERVAL_MS);
   }
   log(debug, "Superwall not configured within timeout \u2014 skipping attribute push");
-  return false;
+  return "timeout";
 }
 async function pushAttributionToSuperwall(debug = false) {
+  clearRetryTimer();
+  await attemptPush(debug, 0);
+}
+async function attemptPush(debug, retryIndex) {
+  const native = await resolveSuperwallNativeModule(debug);
+  if (!native) return;
+  const waited = await waitForConfigured(native, debug);
+  if (waited === "timeout") {
+    scheduleRetry(debug, retryIndex);
+    return;
+  }
+  if (waited !== "configured") return;
   const attrs = buildSuperwallAttributes(attributionTracker.get());
   const signature = JSON.stringify(attrs);
   if (signature === lastSignature) {
     log(debug, "attributes unchanged \u2014 skipping push");
     return;
   }
-  const native = await resolveSuperwallNativeModule(debug);
-  if (!native) return;
-  if (!await waitForConfigured(native, debug)) return;
   try {
     await native.setUserAttributes(attrs);
     lastSignature = signature;
@@ -10027,6 +10219,28 @@ async function pushAttributionToSuperwall(debug = false) {
     log(debug, "setUserAttributes error", { err: String(err) });
   }
 }
+function scheduleRetry(debug, retryIndex) {
+  const delayMs = CONFIG_RETRY_DELAYS_MS[retryIndex];
+  if (delayMs === void 0) {
+    log(debug, "Superwall never configured \u2014 giving up attribute push");
+    return;
+  }
+  clearRetryTimer();
+  log(debug, "scheduling attribute push retry", { retryIndex, delayMs });
+  retryTimer = setTimeout(() => {
+    retryTimer = null;
+    void attemptPush(debug, retryIndex + 1);
+  }, delayMs);
+}
+function clearRetryTimer() {
+  if (retryTimer !== null) {
+    clearTimeout(retryTimer);
+    retryTimer = null;
+  }
+}
+function cancelSuperwallAttributeRetry() {
+  clearRetryTimer();
+}
 
 // src/domains/paywall/SuperwallAutoBridge.ts
 init_PaywalloClient();
@@ -10059,6 +10273,7 @@ function buildDeterministicEventId(parts) {
 
 // src/domains/paywall/SuperwallAutoBridge.ts
 var bridgeStarted = false;
+var startInProgress = false;
 var unsubscribe = null;
 var debugEnabled = false;
 function log2(msg, data) {
@@ -10099,8 +10314,7 @@ function mapDismissToCloseReason(resultType) {
     case "purchased":
       return "purchased";
     case "restored":
-      return "purchased";
-    // restore counts as a purchase outcome for funnel
+      return "restored";
     case "declined":
       return "dismissed";
     default:
@@ -10136,17 +10350,66 @@ function buildCallbacks() {
       const identifier = "paywallIdentifier" in safe && typeof safe.paywallIdentifier === "string" ? safe.paywallIdentifier : productId;
       log2("onPurchase", { productId, identifier });
       void trackPaywallEvent("purchased", identifier, ts, { product_id: productId });
+    },
+    // Global Superwall event listener — used specifically for `transactionComplete`
+    // which is the only event that exposes the full product (currency/price) +
+    // transaction (storeTransactionId) shape needed to create a server-side
+    // `transactions` row. Other events are skipped (paywallOpen/Dismiss already
+    // handled above with their typed callbacks).
+    onSuperwallEvent: (info) => {
+      const ev = info?.event;
+      if (!ev || ev.event !== "transactionComplete") return;
+      const ts = Date.now();
+      const product = ev.product;
+      const transaction = ev.transaction;
+      if (!product) {
+        log2("transactionComplete missing product \u2014 skipping transaction track");
+        return;
+      }
+      const productId = product.productIdentifier ?? product.id ?? "unknown";
+      const currency = product.currencyCode ?? "USD";
+      const price = product.price ?? 0;
+      const transactionId = transaction?.purchaseToken ?? transaction?.storeTransactionId ?? transaction?.originalTransactionIdentifier ?? `${productId}_${String(ts)}`;
+      const introPrice = product.trialPeriodPrice ?? 0;
+      const isTrial = product.hasFreeTrial === true && introPrice <= 0;
+      const isPaidIntro = introPrice > 0;
+      const paywallIdentifier = ev.paywallInfo?.identifier;
+      log2("onSuperwallEvent: transactionComplete", { productId, currency, price, introPrice, transactionId, isTrial });
+      void (async () => {
+        try {
+          await PaywalloClient.track("transaction", {
+            priority: "critical",
+            properties: {
+              type: isTrial ? "trial_started" : "completed",
+              // Server's IngestTranslator looks for `transaction_id`/`product_id`
+              // /`amount`/`currency`/`paywall_id` keys. A free trial MUST carry
+              // amount=0 (no revenue at start); a paid intro offer carries its
+              // intro amount (real revenue); a normal purchase carries `price`.
+              // `full_price` carries the recurring full price so the server can
+              // value the eventual conversion (free trial) or keep the headline
+              // price alongside the discounted intro amount (paid intro).
+              transaction_id: transactionId,
+              product_id: productId,
+              amount: isTrial ? 0 : isPaidIntro ? introPrice : price,
+              currency,
+              ...isTrial || isPaidIntro ? { full_price: price } : {},
+              ...paywallIdentifier ? { paywall_id: paywallIdentifier } : {}
+            }
+          });
+        } catch (err) {
+          log2("transactionComplete track error", { err: String(err) });
+        }
+      })();
     }
-    // onSuperwallEvent removed — transaction sale events are sourced exclusively
-    // from server-side webhooks (Apple/Google/Superwall/RevenueCat).
   };
 }
 function startSuperwallAutoBridge(debug = false) {
   debugEnabled = debug;
-  if (bridgeStarted) {
-    log2("already started, skipping");
+  if (bridgeStarted || startInProgress) {
+    log2("already started or starting, skipping");
     return;
   }
+  startInProgress = true;
   void detectAndStart();
 }
 async function detectAndStart() {
@@ -10157,6 +10420,7 @@ async function detectAndStart() {
       const internal = await import("expo-superwall/build/src/internal/superwallEventBridge");
       if (typeof internal.subscribeToSuperwallEvents !== "function") {
         log2("expo-superwall subscribeToSuperwallEvents not found \u2014 bridge inactive");
+        startInProgress = false;
         return;
       }
       subscribeFn = internal.subscribeToSuperwallEvents;
@@ -10165,6 +10429,11 @@ async function detectAndStart() {
     }
   } catch {
     log2("expo-superwall not installed \u2014 bridge inactive");
+    startInProgress = false;
+    return;
+  }
+  if (!startInProgress) {
+    log2("start cancelled by stop \u2014 bridge inactive");
     return;
   }
   try {
@@ -10174,7 +10443,18 @@ async function detectAndStart() {
     log2("bridge started");
   } catch (err) {
     log2("subscribe failed", { err: String(err) });
+  } finally {
+    startInProgress = false;
+  }
+}
+function stopSuperwallAutoBridge() {
+  if (unsubscribe) {
+    unsubscribe();
+    unsubscribe = null;
   }
+  bridgeStarted = false;
+  startInProgress = false;
+  log2("bridge stopped");
 }
 
 // src/PaywalloProvider.tsx
@@ -10741,6 +11021,9 @@ function PaywalloProvider({ children, config }) {
   const configRef = (0, import_react28.useRef)(config);
   (0, import_react28.useEffect)(() => {
     let mounted = true;
+    const unsubscribeAttribution = attributionTracker.onCapture(() => {
+      void pushAttributionToSuperwall(configRef.current.debug);
+    });
     const bootstrap = async () => {
       if (!PaywalloClient.isReady()) {
         initLocalization({ detectDevice: true });
@@ -10751,11 +11034,10 @@ function PaywalloProvider({ children, config }) {
           setInitError(err instanceof Error ? err : new ClientError(CLIENT_ERROR_CODES.NOT_INITIALIZED, String(err)));
           return;
         }
-        if (!mounted) return;
-        startSuperwallAutoBridge(configRef.current.debug);
-        void pushAttributionToSuperwall(configRef.current.debug);
       }
       if (!mounted) return;
+      startSuperwallAutoBridge(configRef.current.debug);
+      void pushAttributionToSuperwall(configRef.current.debug);
       setDistinctId(PaywalloClient.getDistinctId());
       setIsInitialized(true);
       if (!autoPreloadTriggeredRef.current) {
@@ -10773,6 +11055,9 @@ function PaywalloProvider({ children, config }) {
     void bootstrap();
     return () => {
       mounted = false;
+      unsubscribeAttribution();
+      stopSuperwallAutoBridge();
+      cancelSuperwallAttributeRetry();
     };
   }, [preloadCampaign]);
   const getPaywallConfig = (0, import_react28.useCallback)(async (p) => {