@virex-tech/paywallo-sdk 2.5.1 → 2.5.3

package/dist/index.mjs

@@ -271,8 +271,8 @@ var init_ClientError = __esm({
 
 // src/utils/NativeDeviceInfo.ts
 import { Platform } from "react-native";
-import * as Device from "expo-device";
 import * as Application from "expo-application";
+import * as Device from "expo-device";
 import * as Localization from "expo-localization";
 function assertExpoModules() {
   if (!Device || Device.osName === void 0) {
@@ -952,7 +952,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");
@@ -1375,6 +1377,7 @@ var init_AttributionTracker = __esm({
       constructor(debug = false) {
         this.cache = null;
         this.captureInProgress = false;
+        this.listeners = /* @__PURE__ */ new Set();
         this.storage = new SecureStorage(debug);
       }
       /**
@@ -1414,10 +1417,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()`).
@@ -1511,6 +1535,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
 import { NativeModules as NativeModules2 } from "react-native";
 var TIMEOUT_MS, NativeBridge, MetaBridge, metaBridge;
@@ -1609,68 +1695,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
 import { Platform as Platform3 } from "react-native";
 var REFERRER_TIMEOUT_MS, InstallReferrerManager, installReferrerManager;
@@ -1678,8 +1702,8 @@ var init_InstallReferrerManager = __esm({
   "src/domains/identity/InstallReferrerManager.ts"() {
     "use strict";
     init_NativeDeviceInfo();
-    init_MetaBridge();
     init_deferredAppLink();
+    init_MetaBridge();
     REFERRER_TIMEOUT_MS = 5e3;
     InstallReferrerManager = class {
       async getReferrer() {
@@ -1780,7 +1804,17 @@ var init_InstallReferrerManager = __esm({
 
 // src/domains/identity/InstallTracker.ts
 import { Dimensions, PixelRatio, Platform as Platform4 } from "react-native";
-var 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 InstallTracker, DEFERRED_ATTRIBUTION_FIELDS;
 var init_InstallTracker = __esm({
   "src/domains/identity/InstallTracker.ts"() {
     "use strict";
@@ -1945,7 +1979,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({
@@ -1967,12 +2001,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"
+    ];
   }
 });
 
@@ -2547,8 +2611,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 {
   }
@@ -3167,99 +3231,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)) {
@@ -3905,17 +4106,292 @@ var init_PaywallWebView = __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/NativeStoreKit.ts
+var NativeStoreKit_exports = {};
+__export(NativeStoreKit_exports, {
+  NativeStoreKit: () => NativeStoreKit,
+  nativeStoreKit: () => nativeStoreKit
+});
+import { NativeEventEmitter as NativeEventEmitter3, NativeModules as NativeModules6, Platform as Platform11 } from "react-native";
+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: Platform11.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 TRANSACTION_UPDATE_EVENT, PaywalloStoreKitNative, nativeStoreKit, NativeStoreKit;
+var init_NativeStoreKit = __esm({
+  "src/domains/iap/NativeStoreKit.ts"() {
+    "use strict";
+    init_PaywalloClient();
+    init_uuid();
+    init_IdentityManager();
+    init_PurchaseError();
+    TRANSACTION_UPDATE_EVENT = "PaywalloTransactionUpdate";
+    PaywalloStoreKitNative = NativeModules6.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 = NativeEventEmitter3;
+          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),
@@ -3940,19 +4416,69 @@ var init_IAPTransactionEmitter = __esm({
           });
           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);
+          if (this.getDebug()) console.log("[Paywallo PURCHASE] checkout_started emission failed", err);
+        }
+      }
+      /**
+       * 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);
         }
       }
       /**
-       * No-op. Native transaction update listener removed — sale events are sourced
-       * exclusively from server-side webhooks (Apple/Google/Superwall/RevenueCat).
+       * 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");
       }
     };
   }
@@ -4841,58 +5367,8 @@ 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
-import { Platform as Platform11 } from "react-native";
+import { Platform as Platform12 } from "react-native";
 var IAPValidator;
 var init_IAPValidator = __esm({
   "src/domains/iap/IAPValidator.ts"() {
@@ -4922,7 +5398,7 @@ var init_IAPValidator = __esm({
       async validateWithServer(purchase, productId, options) {
         const apiClient = this.getApiClientFn();
         const product = this.getProductFromCache(productId);
-        const platform = Platform11.OS;
+        const platform = Platform12.OS;
         const distinctId = PaywalloClient.getDistinctId();
         return this.validateWithRetry(
           () => apiClient.validatePurchase(
@@ -4957,7 +5433,7 @@ var init_IAPValidator = __esm({
         try {
           const apiClient = this.getApiClientFn();
           const product = this.getProductFromCache(productId);
-          const platform = Platform11.OS;
+          const platform = Platform12.OS;
           const distinctId = PaywalloClient.getDistinctId();
           const appKey = apiClient.getAppKey();
           const body = {
@@ -4976,210 +5452,16 @@ var init_IAPValidator = __esm({
             "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
-});
-import { NativeEventEmitter as NativeEventEmitter3, NativeModules as NativeModules6, Platform as Platform12 } from "react-native";
-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: Platform12.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 TRANSACTION_UPDATE_EVENT, PaywalloStoreKitNative, nativeStoreKit, NativeStoreKit;
-var init_NativeStoreKit = __esm({
-  "src/domains/iap/NativeStoreKit.ts"() {
-    "use strict";
-    init_PaywalloClient();
-    init_uuid();
-    init_IdentityManager();
-    init_PurchaseError();
-    TRANSACTION_UPDATE_EVENT = "PaywalloTransactionUpdate";
-    PaywalloStoreKitNative = NativeModules6.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 = NativeEventEmitter3;
-          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() };
+            { "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;
   }
 });
 
@@ -5283,8 +5565,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()) {
@@ -5313,6 +5595,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") {
@@ -6413,143 +6699,6 @@ var init_session = __esm({
   }
 });
 
-// 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");
-      }
-      /** 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/analytics/AnalyticsError.ts
 var AnalyticsError, ANALYTICS_ERROR_CODES;
 var init_AnalyticsError = __esm({
@@ -6622,7 +6771,21 @@ var init_schemas = __esm({
       // `closed`-specific
       closed_at: z.string().optional(),
       duration_s: z.number().nonnegative().optional(),
-      close_reason: 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: z.enum([
+        "dismiss",
+        "cta",
+        "purchase",
+        "error",
+        "timeout",
+        "purchased",
+        "dismissed",
+        "restored"
+      ]).optional(),
       scroll_depth: z.number().min(0).max(1).optional(),
       // `purchased`-specific (mínimo — transaction canônica leva detalhes)
       product_id: z.string().optional()
@@ -6630,21 +6793,33 @@ var init_schemas = __esm({
     transactionEventSchema = z.object({
       type: z.enum([
         "completed",
+        "trial_started",
         "failed",
         "refunded",
         "renewed",
         "canceled",
         "expired"
       ]),
-      tx_id: 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: z.string().min(1).optional(),
+      tx_id: z.string().min(1).optional(),
       amount: z.number().optional(),
+      // Full (post-trial) price carried on trial_started for analytics, since
+      // `amount` is 0 for a free trial.
+      full_price: z.number().nonnegative().optional(),
       currency: z.string().length(3).optional(),
       product_id: z.string().optional(),
       subscription_id: z.string().optional(),
       paywall_id: z.string().optional(),
       variant_id: z.string().optional(),
       reason: 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 = z.object({
       type: z.enum(["step", "complete", "drop"]),
       step_index: 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;
@@ -8904,11 +9084,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();
@@ -9536,8 +9716,41 @@ function usePlanPurchase() {
   };
 }
 
+// src/hooks/usePaywalloScreenTracking.ts
+init_PaywalloClient();
+import { useCallback as useCallback11, useRef as useRef8 } from "react";
+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 = useRef8(null);
+  return useCallback11((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
-import { useCallback as useCallback11, useEffect as useEffect10, useState as useState10 } from "react";
+import { useCallback as useCallback12, useEffect as useEffect10, useState as useState10 } from "react";
 async function getPlanService() {
   try {
     const mod = await Promise.resolve().then(() => (init_PlanService(), PlanService_exports));
@@ -9551,7 +9764,7 @@ function usePlans() {
   const [currentPlan, setCurrentPlan] = useState10(null);
   const [isLoading, setIsLoading] = useState10(true);
   const [error, setError] = useState10(null);
-  const fetchPlans = useCallback11(async (forceRefresh = false) => {
+  const fetchPlans = useCallback12(async (forceRefresh = false) => {
     setIsLoading(true);
     setError(null);
     try {
@@ -9572,7 +9785,7 @@ function usePlans() {
       setIsLoading(false);
     }
   }, []);
-  const refresh = useCallback11(() => {
+  const refresh = useCallback12(() => {
     return fetchPlans(true);
   }, [fetchPlans]);
   useEffect10(() => {
@@ -9582,7 +9795,7 @@ function usePlans() {
 }
 
 // src/hooks/useProducts.ts
-import { useCallback as useCallback12, useEffect as useEffect11, useState as useState11 } from "react";
+import { useCallback as useCallback13, useEffect as useEffect11, useState as useState11 } from "react";
 
 // src/utils/productMappers.ts
 function mapToIAPProduct(product) {
@@ -9625,7 +9838,7 @@ function useProducts(initialProductIds) {
   const [formattedProducts, setFormattedProducts] = useState11([]);
   const [isLoading, setIsLoading] = useState11(false);
   const [error, setError] = useState11(null);
-  const loadProducts = useCallback12(async (productIds) => {
+  const loadProducts = useCallback13(async (productIds) => {
     setIsLoading(true);
     setError(null);
     try {
@@ -9644,19 +9857,19 @@ function useProducts(initialProductIds) {
       void loadProducts(initialProductIds);
     }
   }, []);
-  const getProduct = useCallback12(
+  const getProduct = useCallback13(
     (productId) => {
       return products.find((p) => p.productId === productId);
     },
     [products]
   );
-  const getFormattedProduct = useCallback12(
+  const getFormattedProduct = useCallback13(
     (productId) => {
       return formattedProducts.find((p) => p.productId === productId);
     },
     [formattedProducts]
   );
-  const getPriceInfo = useCallback12(
+  const getPriceInfo = useCallback13(
     (productId) => {
       const p = formattedProducts.find((fp) => fp.productId === productId);
       if (!p) return void 0;
@@ -9685,14 +9898,14 @@ function useProducts(initialProductIds) {
 }
 
 // src/hooks/usePurchase.ts
-import { useCallback as useCallback13, useState as useState12 } from "react";
+import { useCallback as useCallback14, useState as useState12 } from "react";
 function toIAPPurchase(p) {
   return { productId: p.productId, transactionId: p.transactionId, transactionDate: p.transactionDate, transactionReceipt: p.receipt };
 }
 function usePurchase() {
   const [state, setState] = useState12("idle");
   const [error, setError] = useState12(null);
-  const purchase = useCallback13(async (productId) => {
+  const purchase = useCallback14(async (productId) => {
     setState("purchasing");
     setError(null);
     try {
@@ -9720,7 +9933,7 @@ function usePurchase() {
       return { status: "failed", error: purchaseError };
     }
   }, []);
-  const restore = useCallback13(async () => {
+  const restore = useCallback14(async () => {
     setState("restoring");
     setError(null);
     try {
@@ -9739,14 +9952,14 @@ function usePurchase() {
 }
 
 // src/hooks/useSubscription.ts
-import { useCallback as useCallback14, useEffect as useEffect12, useState as useState13 } from "react";
+import { useCallback as useCallback15, useEffect as useEffect12, useState as useState13 } from "react";
 init_SubscriptionManager();
 var EMPTY_ENTITLEMENTS = [];
 function useSubscription() {
   const [status, setStatus] = useState13(null);
   const [isLoading, setIsLoading] = useState13(true);
   const [error, setError] = useState13(null);
-  const refresh = useCallback14(async () => {
+  const refresh = useCallback15(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -9759,7 +9972,7 @@ function useSubscription() {
       setIsLoading(false);
     }
   }, []);
-  const restore = useCallback14(async () => {
+  const restore = useCallback15(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -9799,39 +10012,6 @@ function useSubscription() {
   };
 }
 
-// src/hooks/usePaywalloScreenTracking.ts
-init_PaywalloClient();
-import { useCallback as useCallback15, useRef as useRef8 } from "react";
-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 = useRef8(null);
-  return useCallback15((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
 import { useCallback as useCallback20, useEffect as useEffect14, useLayoutEffect, useMemo as useMemo3, useRef as useRef12, useState as useState17 } from "react";
 import { Animated as Animated4, Dimensions as Dimensions5, Easing as Easing2, StyleSheet as StyleSheet5 } from "react-native";
@@ -9839,6 +10019,7 @@ init_PaywalloClient();
 init_NativeStorage();
 init_SecureStorage();
 init_campaign();
+init_identity();
 init_paywall();
 init_paywall();
 init_paywall();
@@ -9850,7 +10031,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);
@@ -9917,28 +10100,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;
@@ -9947,6 +10139,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();
@@ -9979,6 +10193,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) {
@@ -10019,8 +10234,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:
@@ -10056,17 +10270,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() {
@@ -10077,6 +10340,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;
@@ -10085,6 +10349,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 {
@@ -10094,7 +10363,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
@@ -10661,6 +10941,9 @@ function PaywalloProvider({ children, config }) {
   const configRef = useRef12(config);
   useEffect14(() => {
     let mounted = true;
+    const unsubscribeAttribution = attributionTracker.onCapture(() => {
+      void pushAttributionToSuperwall(configRef.current.debug);
+    });
     const bootstrap = async () => {
       if (!PaywalloClient.isReady()) {
         initLocalization({ detectDevice: true });
@@ -10671,11 +10954,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) {
@@ -10693,6 +10975,9 @@ function PaywalloProvider({ children, config }) {
     void bootstrap();
     return () => {
       mounted = false;
+      unsubscribeAttribution();
+      stopSuperwallAutoBridge();
+      cancelSuperwallAttributeRetry();
     };
   }, [preloadCampaign]);
   const getPaywallConfig = useCallback20(async (p) => {