@virex-tech/paywallo-sdk 2.5.1 → 2.5.2

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.2") {
+      return "2.5.2";
     }
   } catch {
   }
@@ -3177,9 +3241,146 @@ var init_NotificationsManager = __esm({
 var init_notifications = __esm({
   "src/domains/notifications/index.ts"() {
     "use strict";
-    init_NativePushBridge();
-    init_NotificationsError();
-    init_NotificationsManager();
+    init_NativePushBridge();
+    init_NotificationsError();
+    init_NotificationsManager();
+  }
+});
+
+// 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();
   }
 });
 
@@ -6413,143 +6614,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 +6686,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 +6708,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 +7564,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 +7579,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 +9000,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 +9711,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 +9755,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 +9780,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 +9829,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 +9847,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 +9893,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 +9928,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 +9947,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 +9967,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 +9980,7 @@ function useSubscription() {
       setIsLoading(false);
     }
   }, []);
-  (0, import_react21.useEffect)(() => {
+  (0, import_react22.useEffect)(() => {
     void subscriptionManager.getSubscriptionStatus().then((s) => {
       setStatus(s);
       setIsLoading(false);
@@ -9879,39 +10007,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 +10014,7 @@ init_PaywalloClient();
 init_NativeStorage();
 init_SecureStorage();
 init_campaign();
+init_identity();
 init_paywall();
 init_paywall();
 init_paywall();
@@ -9930,7 +10026,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 +10095,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 +10134,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 +10188,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 +10229,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:
@@ -10137,16 +10266,18 @@ function buildCallbacks() {
       log2("onPurchase", { productId, identifier });
       void trackPaywallEvent("purchased", identifier, ts, { product_id: productId });
     }
-    // onSuperwallEvent removed — transaction sale events are sourced exclusively
-    // from server-side webhooks (Apple/Google/Superwall/RevenueCat).
+    // onSuperwallEvent (transactionComplete → transaction track) removed —
+    // sale/transaction events are sourced exclusively from server-side webhooks
+    // (Apple/Google/Superwall/RevenueCat), the single source of truth for revenue.
   };
 }
 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 +10288,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 +10297,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 +10311,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 +10889,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 +10902,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 +10923,9 @@ function PaywalloProvider({ children, config }) {
     void bootstrap();
     return () => {
       mounted = false;
+      unsubscribeAttribution();
+      stopSuperwallAutoBridge();
+      cancelSuperwallAttributeRetry();
     };
   }, [preloadCampaign]);
   const getPaywallConfig = (0, import_react28.useCallback)(async (p) => {