@virex-tech/paywallo-sdk 2.5.1 → 2.5.2

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.2") {
+      return "2.5.2";
     }
   } catch {
   }
@@ -3153,17 +3217,154 @@ var init_NotificationsManager = __esm({
         this.currentToken = null;
       }
     };
-    notificationsManager = new NotificationsManager();
+    notificationsManager = new NotificationsManager();
+  }
+});
+
+// src/domains/notifications/index.ts
+var init_notifications = __esm({
+  "src/domains/notifications/index.ts"() {
+    "use strict";
+    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/notifications/index.ts
-var init_notifications = __esm({
-  "src/domains/notifications/index.ts"() {
+// src/domains/onboarding/index.ts
+var init_onboarding = __esm({
+  "src/domains/onboarding/index.ts"() {
     "use strict";
-    init_NativePushBridge();
-    init_NotificationsError();
-    init_NotificationsManager();
+    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: 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 +6708,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 +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;
@@ -8904,11 +8999,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 +9631,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 +9679,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 +9700,7 @@ function usePlans() {
       setIsLoading(false);
     }
   }, []);
-  const refresh = useCallback11(() => {
+  const refresh = useCallback12(() => {
     return fetchPlans(true);
   }, [fetchPlans]);
   useEffect10(() => {
@@ -9582,7 +9710,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 +9753,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 +9772,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 +9813,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 +9848,7 @@ function usePurchase() {
       return { status: "failed", error: purchaseError };
     }
   }, []);
-  const restore = useCallback13(async () => {
+  const restore = useCallback14(async () => {
     setState("restoring");
     setError(null);
     try {
@@ -9739,14 +9867,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 +9887,7 @@ function useSubscription() {
       setIsLoading(false);
     }
   }, []);
-  const restore = useCallback14(async () => {
+  const restore = useCallback15(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -9799,39 +9927,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 +9934,7 @@ init_PaywalloClient();
 init_NativeStorage();
 init_SecureStorage();
 init_campaign();
+init_identity();
 init_paywall();
 init_paywall();
 init_paywall();
@@ -9850,7 +9946,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 +10015,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 +10054,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 +10108,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 +10149,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:
@@ -10057,16 +10186,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() {
@@ -10077,6 +10208,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 +10217,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 +10231,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 +10809,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 +10822,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 +10843,9 @@ function PaywalloProvider({ children, config }) {
     void bootstrap();
     return () => {
       mounted = false;
+      unsubscribeAttribution();
+      stopSuperwallAutoBridge();
+      cancelSuperwallAttributeRetry();
     };
   }, [preloadCampaign]);
   const getPaywallConfig = useCallback20(async (p) => {