@virex-tech/paywallo-sdk 2.4.1 → 2.5.0

package/dist/index.mjs

@@ -246,77 +246,102 @@ var init_StorageMigration = __esm({
   }
 });
 
+// src/errors/ClientError.ts
+var ClientError, CLIENT_ERROR_CODES;
+var init_ClientError = __esm({
+  "src/errors/ClientError.ts"() {
+    "use strict";
+    init_PaywalloError();
+    ClientError = class extends PaywalloError {
+      constructor(code, message) {
+        super("client", code, message);
+        this.name = "ClientError";
+      }
+    };
+    CLIENT_ERROR_CODES = {
+      NOT_INITIALIZED: "CLIENT_NOT_INITIALIZED",
+      MISSING_APP_KEY: "CLIENT_MISSING_APP_KEY",
+      INVALID_EVENT_NAME: "CLIENT_INVALID_EVENT_NAME",
+      PROVIDER_MISSING: "CLIENT_PROVIDER_MISSING",
+      INSECURE_REQUEST: "CLIENT_INSECURE_REQUEST",
+      UNKNOWN: "CLIENT_UNKNOWN"
+    };
+  }
+});
+
 // src/utils/NativeDeviceInfo.ts
-import { NativeModules as NativeModules2 } from "react-native";
+import { Platform } from "react-native";
+import * as Device from "expo-device";
+import * as Application from "expo-application";
+import * as Localization from "expo-localization";
+function assertExpoModules() {
+  if (!Device || Device.osName === void 0) {
+    throw new ClientError(
+      "MISSING_EXPO_DEPS",
+      "Paywallo SDK 3.x requires expo-device, expo-localization and expo-application. Run: npx expo install expo-device expo-localization expo-application"
+    );
+  }
+}
 function setNativeDeviceInfoDebug(debug) {
   _debug2 = debug;
 }
-function isDeviceInfoResult(value) {
-  if (typeof value !== "object" || value === null) return false;
-  const v = value;
-  return typeof v["deviceId"] === "string" && typeof v["model"] === "string" && typeof v["systemVersion"] === "string" && typeof v["appVersion"] === "string" && typeof v["bundleId"] === "string";
-}
-function getNativeModule() {
-  const mod = NativeModules2.PaywalloDevice;
-  if (!mod) {
-    if (!warnedOnce) {
-      warnedOnce = true;
-      if (_debug2) console.log("[Paywallo] NativeModules.PaywalloDevice not found \u2014 falling back to defaults");
-    }
-    return null;
-  }
-  return mod;
+function buildSyncFields(idfv) {
+  const locale = Localization.getLocales()[0] ?? null;
+  const calendar = Localization.getCalendars()[0] ?? null;
+  const androidId = Platform.OS === "android" ? Application.getAndroidId() ?? "unknown" : "unknown";
+  return {
+    deviceId: Platform.OS === "ios" ? idfv ?? "unknown" : androidId,
+    model: Device.modelName ?? "unknown",
+    modelId: Device.modelId ?? Device.modelName ?? "unknown",
+    osName: Device.osName ?? Platform.OS,
+    systemVersion: Device.osVersion ?? "unknown",
+    appVersion: Application.nativeApplicationVersion ?? "unknown",
+    buildNumber: Application.nativeBuildVersion ?? "0",
+    bundleId: Application.applicationId ?? "unknown",
+    brand: Device.brand ?? "unknown",
+    idfv,
+    regionCode: locale?.regionCode ?? null,
+    languageTag: locale?.languageTag ?? null,
+    languageCode: locale?.languageCode ?? null,
+    timeZone: calendar?.timeZone ?? null
+  };
 }
 async function getDeviceInfo() {
   if (cachedDeviceInfo !== null) return cachedDeviceInfo;
-  const mod = getNativeModule();
-  if (!mod) return FALLBACK;
-  const raw = await mod.getDeviceInfo();
-  if (!isDeviceInfoResult(raw)) return FALLBACK;
-  cachedDeviceInfo = raw;
-  return raw;
+  assertExpoModules();
+  const idfv = Platform.OS === "ios" ? await Application.getIosIdForVendorAsync() : null;
+  if (_debug2) console.log("[Paywallo] device info collected, idfv present:", idfv != null);
+  cachedDeviceInfo = buildSyncFields(idfv);
+  return cachedDeviceInfo;
 }
 async function getInstallReferrer() {
-  const mod = getNativeModule();
-  if (!mod) return null;
   try {
-    return await mod.getInstallReferrer();
+    return await Application.getInstallReferrerAsync();
   } catch {
     return null;
   }
 }
 function isAvailable2() {
-  return NativeModules2.PaywalloDevice != null;
+  return typeof Device !== "undefined" && Device.osName !== void 0;
 }
 function clearCache() {
   cachedDeviceInfo = null;
 }
 function getCachedDeviceInfo() {
-  return cachedDeviceInfo;
+  if (cachedDeviceInfo !== null) return cachedDeviceInfo;
+  try {
+    assertExpoModules();
+    return buildSyncFields(null);
+  } catch {
+    return null;
+  }
 }
-var FALLBACK, _debug2, warnedOnce, cachedDeviceInfo, nativeDeviceInfo;
+var _debug2, cachedDeviceInfo, nativeDeviceInfo;
 var init_NativeDeviceInfo = __esm({
   "src/utils/NativeDeviceInfo.ts"() {
     "use strict";
-    FALLBACK = {
-      deviceId: "unknown",
-      model: "unknown",
-      modelId: "unknown",
-      systemVersion: "0.0.0",
-      appVersion: "0.0.0",
-      buildNumber: "0",
-      bundleId: "unknown",
-      brand: "unknown",
-      systemName: "unknown",
-      totalDisk: 0,
-      freeDisk: 0,
-      totalRam: 0,
-      carrier: "unknown",
-      installerPackage: null,
-      idfv: null
-    };
+    init_ClientError();
     _debug2 = false;
-    warnedOnce = false;
     cachedDeviceInfo = null;
     nativeDeviceInfo = {
       getDeviceInfo,
@@ -331,6 +356,7 @@ var init_NativeDeviceInfo = __esm({
 // src/utils/uuid.ts
 var uuid_exports = {};
 __export(uuid_exports, {
+  deterministicUUID: () => deterministicUUID,
   generateUUID: () => generateUUID,
   isValidUUIDv4: () => isValidUUIDv4
 });
@@ -342,6 +368,28 @@ function generateUUID() {
     return v.toString(16);
   });
 }
+function deterministicUUID(seed) {
+  const fnv1a32 = (s, basis) => {
+    let h = basis >>> 0;
+    for (let i = 0; i < s.length; i++) {
+      h = Math.imul(h ^ s.charCodeAt(i), 16777619) >>> 0;
+    }
+    return h;
+  };
+  const B = 2166136261;
+  const h0 = fnv1a32(seed, B);
+  const h1 = fnv1a32(seed, B ^ 252645135);
+  const h2 = fnv1a32(seed, B ^ 4042322160);
+  const h3 = fnv1a32(seed, B ^ 2863311530);
+  const x = (n, len) => (n >>> 0).toString(16).padStart(len, "0").slice(-len);
+  const s1 = x(h0, 8);
+  const s2 = x(h1 >>> 16, 4);
+  const s3 = "4" + x(h1 & 4095, 3);
+  const vb = (8 | h2 >>> 30 & 3).toString(16);
+  const s4 = vb + x(h2 >>> 18 & 4095, 3);
+  const s5 = x(h2 & 65535, 4) + x(h3, 8);
+  return `${s1}-${s2}-${s3}-${s4}-${s5}`;
+}
 function isValidUUIDv4(value) {
   if (!value) return false;
   return UUID_V4_REGEX.test(value);
@@ -609,6 +657,10 @@ var init_IdentityManager = __esm({
         if (!this.initialized) return "";
         return this.distinctId ?? this.anonId ?? "";
       }
+      /** Public stable identifier — returns the same value as `getDistinctId()`. */
+      getId() {
+        return this.getDistinctId();
+      }
       getDeviceId() {
         return this.deviceId;
       }
@@ -880,7 +932,7 @@ var init_campaign = __esm({
 });
 
 // src/domains/identity/AdvertisingIdManager.ts
-import { Platform } from "react-native";
+import { Platform as Platform2 } from "react-native";
 var ZERO_IDFA, AdvertisingIdManager, advertisingIdManager;
 var init_AdvertisingIdManager = __esm({
   "src/domains/identity/AdvertisingIdManager.ts"() {
@@ -904,7 +956,7 @@ var init_AdvertisingIdManager = __esm({
         const fallback = { idfv: null, idfa: null, gaid: null, attStatus: "unavailable" };
         try {
           const tracking = await import("expo-tracking-transparency");
-          if (Platform.OS === "ios") {
+          if (Platform2.OS === "ios") {
             if (!tracking.isAvailable()) {
               const idfv2 = await this.collectIdfv();
               const result2 = { ...fallback, idfv: idfv2 };
@@ -925,7 +977,7 @@ var init_AdvertisingIdManager = __esm({
             if (idfv !== null) this.cached = result;
             return result;
           }
-          if (Platform.OS === "android") {
+          if (Platform2.OS === "android") {
             const rawGaid = tracking.getAdvertisingId();
             const gaid = this.sanitizeId(rawGaid);
             this.cached = { idfv: null, idfa: null, gaid, attStatus: "unavailable" };
@@ -1012,10 +1064,8 @@ async function collectDeviceInfo() {
   const result = await nativeDeviceInfo.getDeviceInfo();
   return {
     appVersion: result.appVersion,
-    deviceModel: result.model,
-    osVersion: result.systemVersion,
-    darwinVersion: result.darwinVersion,
-    webkitVersion: result.webkitVersion
+    deviceModel: result.modelId,
+    osVersion: result.systemVersion
   };
 }
 var init_deviceInfo = __esm({
@@ -1410,6 +1460,12 @@ async function markInstallTracked(storage, installedAt) {
   } catch {
   }
 }
+async function resolveInstallEventId(deviceKey, appKey) {
+  if (deviceKey && deviceKey.trim().length > 0) {
+    return deterministicUUID(`${appKey}:${deviceKey}`);
+  }
+  return getOrCreateInstallEventId();
+}
 async function getOrCreateInstallEventId() {
   const existing = await nativeStorage.get(INSTALL_KEYS.INSTALL_EVENT_ID);
   if (existing) return existing;
@@ -1430,6 +1486,7 @@ var init_InstallIdempotency = __esm({
   "src/domains/identity/InstallIdempotency.ts"() {
     "use strict";
     init_NativeStorage();
+    init_uuid();
     INSTALL_KEYS = {
       /** Primary flag — set AFTER a successful $app_installed dispatch. */
       INSTALL_TRACKED: "@paywallo:install_tracked",
@@ -1454,18 +1511,180 @@ var init_InstallIdempotency = __esm({
   }
 });
 
+// src/domains/identity/MetaBridge.ts
+import { NativeModules as NativeModules2 } from "react-native";
+var TIMEOUT_MS, NativeBridge, MetaBridge, metaBridge;
+var init_MetaBridge = __esm({
+  "src/domains/identity/MetaBridge.ts"() {
+    "use strict";
+    TIMEOUT_MS = 2e3;
+    NativeBridge = NativeModules2.PaywalloFBBridge ?? null;
+    MetaBridge = class {
+      constructor() {
+        this.cachedAnonId = null;
+        this.cachedDeferredLink = null;
+        this.deferredLinkFetched = false;
+        this.debug = false;
+      }
+      setDebug(debug) {
+        this.debug = debug;
+      }
+      /** Sync read of the cached anonymous ID. Returns null until `getAnonymousID()` resolves once. */
+      getCachedAnonymousID() {
+        return this.cachedAnonId;
+      }
+      async getAnonymousID() {
+        if (this.cachedAnonId) return this.cachedAnonId;
+        if (!NativeBridge) return null;
+        try {
+          let timerId;
+          const timeout = new Promise((resolve) => {
+            timerId = setTimeout(() => resolve(null), TIMEOUT_MS);
+          });
+          const result = await Promise.race([NativeBridge.getAnonymousID(), timeout]);
+          clearTimeout(timerId);
+          if (result) this.cachedAnonId = result;
+          return result;
+        } catch {
+          return null;
+        }
+      }
+      async fetchDeferredAppLink() {
+        if (this.deferredLinkFetched) return this.cachedDeferredLink;
+        if (!NativeBridge) return null;
+        if (typeof NativeBridge.fetchDeferredAppLink !== "function") return null;
+        try {
+          let timerId;
+          const timeout = new Promise((resolve) => {
+            timerId = setTimeout(() => resolve(null), TIMEOUT_MS);
+          });
+          const result = await Promise.race([
+            NativeBridge.fetchDeferredAppLink().catch(() => null),
+            timeout
+          ]);
+          clearTimeout(timerId);
+          this.deferredLinkFetched = true;
+          this.cachedDeferredLink = result;
+          return result;
+        } catch {
+          this.deferredLinkFetched = true;
+          this.cachedDeferredLink = null;
+          return null;
+        }
+      }
+      async logEvent(name, params = {}) {
+        if (!NativeBridge) return;
+        try {
+          await NativeBridge.logEvent(name, params);
+        } catch (error) {
+          console.error("[Paywallo:MetaBridge] logEvent failed", { name, error });
+        }
+      }
+      async logPurchase(amount, currency, params = {}) {
+        if (!NativeBridge) return;
+        try {
+          await NativeBridge.logPurchase(amount, currency, params);
+        } catch (error) {
+          console.error("[Paywallo:MetaBridge] logPurchase failed", { amount, currency, error });
+        }
+      }
+      setUserID(userId) {
+        if (!NativeBridge) return;
+        try {
+          NativeBridge.setUserID(userId);
+        } catch (error) {
+          console.error("[Paywallo:MetaBridge] setUserID failed", { error });
+        }
+      }
+      flush() {
+        if (!NativeBridge) return;
+        try {
+          NativeBridge.flush();
+        } catch (error) {
+          console.error("[Paywallo:MetaBridge] flush failed", { error });
+        }
+      }
+    };
+    metaBridge = new MetaBridge();
+  }
+});
+
+// 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 Platform2 } from "react-native";
+import { Platform as Platform3 } from "react-native";
 var REFERRER_TIMEOUT_MS, InstallReferrerManager, installReferrerManager;
 var init_InstallReferrerManager = __esm({
   "src/domains/identity/InstallReferrerManager.ts"() {
     "use strict";
     init_NativeDeviceInfo();
+    init_MetaBridge();
+    init_deferredAppLink();
     REFERRER_TIMEOUT_MS = 5e3;
     InstallReferrerManager = class {
       async getReferrer() {
-        if (Platform2.OS !== "android") {
-          return this.emptyResult();
+        if (Platform3.OS !== "android") {
+          return this.fetchDeferredReferrer();
         }
         let timerId;
         const timeoutPromise = new Promise((resolve) => {
@@ -1476,6 +1695,29 @@ var init_InstallReferrerManager = __esm({
         clearTimeout(timerId);
         return result;
       }
+      async fetchDeferredReferrer() {
+        try {
+          const url = await metaBridge.fetchDeferredAppLink();
+          const parsed = parseDeferredAppLink(url);
+          if (!parsed) return this.emptyResult();
+          return {
+            rawReferrer: parsed.targetUrl ?? parsed.raw,
+            trackingId: parsed.trackingId,
+            fbclid: parsed.fbclid,
+            utmSource: parsed.utmSource,
+            utmMedium: parsed.utmMedium,
+            utmCampaign: parsed.utmCampaign,
+            ttclid: parsed.ttclid,
+            tiktokCampaignId: null,
+            tiktokAdgroupId: null,
+            tiktokAdId: null,
+            installReferrerRaw: parsed.raw,
+            installReferrerSource: "meta_deferred"
+          };
+        } catch {
+          return this.emptyResult();
+        }
+      }
       async fetchReferrer() {
         try {
           const referrer = await nativeDeviceInfo.getInstallReferrer();
@@ -1536,81 +1778,8 @@ var init_InstallReferrerManager = __esm({
   }
 });
 
-// src/domains/identity/MetaBridge.ts
-import { NativeModules as NativeModules3 } from "react-native";
-var TIMEOUT_MS, NativeBridge, MetaBridge, metaBridge;
-var init_MetaBridge = __esm({
-  "src/domains/identity/MetaBridge.ts"() {
-    "use strict";
-    TIMEOUT_MS = 2e3;
-    NativeBridge = NativeModules3.PaywalloFBBridge ?? null;
-    MetaBridge = class {
-      constructor() {
-        this.cachedAnonId = null;
-        this.debug = false;
-      }
-      setDebug(debug) {
-        this.debug = debug;
-      }
-      /** Sync read of the cached anonymous ID. Returns null until `getAnonymousID()` resolves once. */
-      getCachedAnonymousID() {
-        return this.cachedAnonId;
-      }
-      async getAnonymousID() {
-        if (this.cachedAnonId) return this.cachedAnonId;
-        if (!NativeBridge) return null;
-        try {
-          let timerId;
-          const timeout = new Promise((resolve) => {
-            timerId = setTimeout(() => resolve(null), TIMEOUT_MS);
-          });
-          const result = await Promise.race([NativeBridge.getAnonymousID(), timeout]);
-          clearTimeout(timerId);
-          if (result) this.cachedAnonId = result;
-          return result;
-        } catch {
-          return null;
-        }
-      }
-      async logEvent(name, params = {}) {
-        if (!NativeBridge) return;
-        try {
-          await NativeBridge.logEvent(name, params);
-        } catch (error) {
-          console.error("[Paywallo:MetaBridge] logEvent failed", { name, error });
-        }
-      }
-      async logPurchase(amount, currency, params = {}) {
-        if (!NativeBridge) return;
-        try {
-          await NativeBridge.logPurchase(amount, currency, params);
-        } catch (error) {
-          console.error("[Paywallo:MetaBridge] logPurchase failed", { amount, currency, error });
-        }
-      }
-      setUserID(userId) {
-        if (!NativeBridge) return;
-        try {
-          NativeBridge.setUserID(userId);
-        } catch (error) {
-          console.error("[Paywallo:MetaBridge] setUserID failed", { error });
-        }
-      }
-      flush() {
-        if (!NativeBridge) return;
-        try {
-          NativeBridge.flush();
-        } catch (error) {
-          console.error("[Paywallo:MetaBridge] flush failed", { error });
-        }
-      }
-    };
-    metaBridge = new MetaBridge();
-  }
-});
-
 // src/domains/identity/InstallTracker.ts
-import { Dimensions, PixelRatio, Platform as Platform3 } from "react-native";
+import { Dimensions, PixelRatio, Platform as Platform4 } from "react-native";
 var InstallTracker;
 var init_InstallTracker = __esm({
   "src/domains/identity/InstallTracker.ts"() {
@@ -1678,44 +1847,17 @@ var init_InstallTracker = __esm({
           const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone ?? "unknown";
           const info = await nativeDeviceInfo.getDeviceInfo();
           const deviceModel = info.modelId || info.model || "unknown";
-          const osVersion = info.systemVersion || "unknown";
+          const osVersion2 = info.systemVersion || "unknown";
           const appVersion = info.appVersion || "unknown";
           const buildNumber = info.buildNumber || "0";
-          let carrier = "unknown";
-          try {
-            carrier = info.carrier ?? "unknown";
-          } catch {
-          }
-          let totalDisk = 0;
-          try {
-            totalDisk = Number(info.totalDisk) || 0;
-          } catch {
-          }
-          let freeDisk = 0;
-          try {
-            freeDisk = Number(info.freeDisk) || 0;
-          } catch {
-          }
-          let totalRam = 0;
-          try {
-            totalRam = Number(info.totalRam) || 0;
-          } catch {
-          }
-          let brand = "unknown";
-          try {
-            brand = info.brand ?? "unknown";
-          } catch {
-          }
-          let installerPackage = null;
+          let brand2 = "unknown";
           try {
-            if (Platform3.OS === "android") {
-              installerPackage = info.installerPackage ?? null;
-            }
+            brand2 = info.brand ?? "unknown";
           } catch {
           }
           deviceData = {
             deviceModel,
-            osVersion,
+            osVersion: osVersion2,
             appVersion,
             buildNumber,
             ...screenWidth > 0 && { screenWidth },
@@ -1723,21 +1865,20 @@ var init_InstallTracker = __esm({
             ...screenDensity > 0 && { screenDensity },
             timezone,
             locale,
-            ...carrier !== "unknown" && { carrier },
-            ...totalDisk > 0 && { totalDisk },
-            ...freeDisk > 0 && { freeDisk },
-            ...totalRam > 0 && { totalRam },
-            ...brand !== "unknown" && { brand },
-            ...installerPackage && { installerPackage }
+            ...brand2 !== "unknown" && { brand: brand2 },
+            ...info.regionCode && { country: info.regionCode }
           };
         } catch {
         }
-        const [fbAnonId, referrer, adIds, installEventId] = await Promise.all([
+        const [fbAnonId, referrer, adIds] = await Promise.all([
           metaBridge.getAnonymousID(),
           installReferrerManager.getReferrer(),
-          this.advertisingIdManager.collect(requestATT),
-          getOrCreateInstallEventId()
+          this.advertisingIdManager.collect(requestATT)
         ]);
+        const installEventId = await resolveInstallEventId(
+          adIds.idfv ?? adIds.gaid ?? null,
+          apiClient.getAppKey()
+        );
         if (referrer.fbclid || referrer.utmSource || referrer.utmMedium || referrer.utmCampaign || referrer.ttclid || referrer.tiktokCampaignId || referrer.tiktokAdgroupId || referrer.tiktokAdId) {
           attributionTracker.capture({
             ...referrer.fbclid && { fbclid: referrer.fbclid },
@@ -1768,7 +1909,7 @@ var init_InstallTracker = __esm({
         }
         await apiClient.trackEvent("$app_installed", distinctId, {
           installedAt,
-          platform: Platform3.OS,
+          platform: Platform4.OS,
           installEventId,
           ...sessionId && { sessionId },
           ...deviceData,
@@ -1808,7 +1949,7 @@ var init_InstallTracker = __esm({
             method: "POST",
             headers: { "Content-Type": "application/json", "X-App-Key": appKey },
             body: JSON.stringify({
-              platform: Platform3.OS,
+              platform: Platform4.OS,
               ...adIds.idfv && { idfv: adIds.idfv },
               ...adIds.gaid && { gaid: adIds.gaid },
               ...referrer.rawReferrer && { installReferrer: referrer.rawReferrer },
@@ -1818,6 +1959,7 @@ var init_InstallTracker = __esm({
               screenHeight: deviceData.screenHeight,
               timezone: deviceData.timezone,
               language: deviceData.locale,
+              ...deviceData.country && { country: deviceData.country },
               fbAnonId: anonId,
               installTimestamp: new Date(installedAt).toISOString()
             }),
@@ -1938,12 +2080,12 @@ var init_identity = __esm({
 });
 
 // src/domains/notifications/bridges/NativePushBridge.ts
-import { NativeEventEmitter, NativeModules as NativeModules4, Platform as Platform4 } from "react-native";
+import { NativeEventEmitter, NativeModules as NativeModules3, Platform as Platform5 } from "react-native";
 function getPaywalloNotifications() {
-  return NativeModules4.PaywalloNotifications ?? null;
+  return NativeModules3.PaywalloNotifications ?? null;
 }
 function isNativePushAvailable() {
-  return !!NativeModules4.PaywalloNotifications;
+  return !!NativeModules3.PaywalloNotifications;
 }
 function mapStatusToNumber(status) {
   switch (status) {
@@ -1965,7 +2107,7 @@ function mapStatusToNumber(status) {
 }
 function getEmitter() {
   if (_emitter) return _emitter;
-  const nativeMod = NativeModules4.PaywalloNotifications;
+  const nativeMod = NativeModules3.PaywalloNotifications;
   if (!nativeMod) return null;
   _emitter = new NativeEventEmitter(nativeMod);
   return _emitter;
@@ -1986,7 +2128,7 @@ var init_NativePushBridge = __esm({
         }
       }
       async getAPNSToken() {
-        if (Platform4.OS !== "ios") return null;
+        if (Platform5.OS !== "ios") return null;
         return this.getToken();
       }
       async requestPermission(options) {
@@ -2073,7 +2215,7 @@ var DEFAULT_API_URL, DEFAULT_WEB_URL;
 var init_constants = __esm({
   "src/core/constants.ts"() {
     "use strict";
-    DEFAULT_API_URL = "https://panel.lucasqueiroga.shop";
+    DEFAULT_API_URL = "https://incommensurably-unprotrudent-brooklynn.ngrok-free.dev";
     DEFAULT_WEB_URL = "https://paywallo.com.br";
   }
 });
@@ -2220,7 +2362,7 @@ var init_ForegroundHandler = __esm({
 });
 
 // src/domains/notifications/NotificationEventTracker.ts
-import { Platform as Platform5 } from "react-native";
+import { Platform as Platform6 } from "react-native";
 function getTimezone() {
   try {
     return Intl.DateTimeFormat().resolvedOptions().timeZone ?? "UTC";
@@ -2229,7 +2371,7 @@ function getTimezone() {
   }
 }
 function detectPlatform() {
-  return Platform5.OS === "ios" ? "ios" : "android";
+  return Platform6.OS === "ios" ? "ios" : "android";
 }
 var SEEN_MESSAGES_KEY, LEGACY_SEEN_MESSAGES_KEY, SEEN_TTL_MS, MAX_SEEN_SIZE, NOTIFICATION_TYPE_TO_FAMILY, NotificationEventTracker;
 var init_NotificationEventTracker = __esm({
@@ -2405,8 +2547,8 @@ var init_NotificationHandlerSetup = __esm({
 // src/core/version.ts
 function resolveVersion() {
   try {
-    if ("2.4.1") {
-      return "2.4.1";
+    if ("2.5.0") {
+      return "2.5.0";
     }
   } catch {
   }
@@ -2421,7 +2563,7 @@ var init_version = __esm({
 });
 
 // src/domains/notifications/utils.ts
-import { Platform as Platform6 } from "react-native";
+import { Platform as Platform7 } from "react-native";
 function sleep(ms, signal) {
   return new Promise((resolve, reject) => {
     if (signal?.aborted) {
@@ -2449,8 +2591,8 @@ async function getLocale() {
     return clampLocale(raw);
   } catch {
     try {
-      const { getLocales } = __require("expo-localization");
-      const code = getLocales()[0]?.languageCode ?? "en";
+      const { getLocales: getLocales2 } = __require("expo-localization");
+      const code = getLocales2()[0]?.languageCode ?? "en";
       return clampLocale(code);
     } catch {
       return "en";
@@ -2477,7 +2619,7 @@ function mapPermissionStatus(status) {
   }
 }
 function detectPlatform2() {
-  return Platform6.OS === "ios" ? "ios" : "android";
+  return Platform7.OS === "ios" ? "ios" : "android";
 }
 async function getAppVersion() {
   try {
@@ -2654,7 +2796,7 @@ var init_NotificationTokenOps = __esm({
 });
 
 // src/domains/notifications/PermissionManager.ts
-import { Platform as Platform7 } from "react-native";
+import { Platform as Platform8 } from "react-native";
 function mapPermissionStatus2(status) {
   switch (status) {
     case AUTH_STATUS2.AUTHORIZED:
@@ -2668,7 +2810,7 @@ function mapPermissionStatus2(status) {
   }
 }
 function getPlatform() {
-  return Platform7;
+  return Platform8;
 }
 function needsAndroidRuntimePermission(platform) {
   if (platform.OS !== "android") return false;
@@ -3269,7 +3411,7 @@ var init_paywallHeartbeat = __esm({
 });
 
 // src/utils/localization.ts
-import { NativeModules as NativeModules5, Platform as Platform8 } from "react-native";
+import { NativeModules as NativeModules4, Platform as Platform9 } from "react-native";
 function setCurrentLanguage(language) {
   currentLanguage = language;
 }
@@ -3289,11 +3431,11 @@ function getLocalizedString(text) {
 }
 function detectDeviceLanguage() {
   try {
-    if (Platform8.OS === "ios") {
-      const settings = NativeModules5.SettingsManager?.settings;
+    if (Platform9.OS === "ios") {
+      const settings = NativeModules4.SettingsManager?.settings;
       return settings?.AppleLocale ?? settings?.AppleLanguages?.[0] ?? "en-US";
     }
-    return NativeModules5.I18nManager?.localeIdentifier ?? "en-US";
+    return NativeModules4.I18nManager?.localeIdentifier ?? "en-US";
   } catch {
     return "en-US";
   }
@@ -3464,8 +3606,8 @@ import {
   findNodeHandle,
   Linking as Linking2,
   NativeEventEmitter as NativeEventEmitter2,
-  NativeModules as NativeModules6,
-  Platform as Platform9,
+  NativeModules as NativeModules5,
+  Platform as Platform10,
   requireNativeComponent,
   StyleSheet as StyleSheet2,
   UIManager,
@@ -3485,7 +3627,7 @@ function getNativeWebView() {
 }
 function getWebViewEmitter() {
   if (webViewEmitter) return webViewEmitter;
-  const mod = NativeModules6.PaywalloWebViewModule;
+  const mod = NativeModules5.PaywalloWebViewModule;
   if (!mod) return null;
   webViewEmitter = new NativeEventEmitter2(mod);
   return webViewEmitter;
@@ -3578,7 +3720,7 @@ function PaywallWebView({
     }
   }, []);
   const injectScript = useCallback((script) => {
-    if (Platform9.OS === "android") {
+    if (Platform10.OS === "android") {
       const handle = findNodeHandle(webViewRef.current);
       if (handle == null) return;
       UIManager.dispatchViewManagerCommand(handle, "injectJavaScript", [script]);
@@ -3722,7 +3864,7 @@ function PaywallWebView({
     injectScript(buildPurchaseStateScript(isPurchasing));
   }, [isPurchasing, injectScript]);
   useEffect2(() => {
-    if (Platform9.OS !== "android") return;
+    if (Platform10.OS !== "android") return;
     const onBackPress = () => {
       if (!paywallDataSent.current) return false;
       injectScript(buildBackButtonScript());
@@ -3763,269 +3905,25 @@ 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 NativeModules7, Platform as Platform10 } 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: Platform10.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 = NativeModules7.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.
+       * Emits `checkout_started` quando o usuário inicia a compra (toca em comprar),
+       * antes do StoreKit/Billing abrir — conta mesmo que a sheet nativa seja cancelada.
+       * Vira InitiateCheckout no Meta/TikTok. Fire-and-forget — uma falha de tracking
+       * nunca pode travar a compra.
        */
-      async emitTransactionCompleted(purchase, productId, options) {
+      async emitCheckoutStarted(productId) {
         try {
           const apiClient = this.getApiClientFn();
           if (!apiClient) return;
@@ -4033,40 +3931,9 @@ var init_IAPTransactionEmitter = __esm({
           if (!distinctId) return;
           const product = this.getProductFromCache(productId);
           const properties = {
-            type: "completed",
-            tx_id: purchase.transactionId,
-            product_id: purchase.productId
-          };
-          if (product?.priceValue !== void 0 && product.priceValue > 0) {
-            properties.amount = product.priceValue;
-          }
-          if (product?.currency) {
-            properties.currency = product.currency;
-          }
-          if (options?.paywallId) properties.paywall_id = options.paywallId;
-          if (options?.variantId) properties.variant_id = options.variantId;
-          await apiClient.trackEvent("transaction", distinctId, properties, void 0, { priority: "critical" });
-        } catch (err) {
-          if (this.getDebug()) console.log("[Paywallo PURCHASE] transaction event emission failed", err);
-        }
-      }
-      /**
-       * Emits `checkout_started` quando o usuário inicia a compra (toca em comprar),
-       * antes do StoreKit/Billing abrir — conta mesmo que a sheet nativa seja cancelada.
-       * Vira InitiateCheckout no Meta/TikTok. Fire-and-forget — uma falha de tracking
-       * nunca pode travar a compra.
-       */
-      async emitCheckoutStarted(productId) {
-        try {
-          const apiClient = this.getApiClientFn();
-          if (!apiClient) return;
-          const distinctId = PaywalloClient.getDistinctId();
-          if (!distinctId) return;
-          const product = this.getProductFromCache(productId);
-          const properties = {
-            product_id: productId,
-            amount: product?.priceValue ?? 0,
-            currency: product?.currency ?? "USD"
+            product_id: productId,
+            amount: product?.priceValue ?? 0,
+            currency: product?.currency ?? "USD"
           };
           await apiClient.trackEvent("checkout_started", distinctId, properties, void 0, {
             priority: "critical"
@@ -4077,93 +3944,20 @@ var init_IAPTransactionEmitter = __esm({
         }
       }
       /**
-       * Forwards a native transaction update to the EventBatcher.
-       * Public so tests can exercise the wiring without a fake NativeEventEmitter.
-       */
-      async emitTransactionUpdate(update) {
-        try {
-          const apiClient = this.getApiClientFn() ?? PaywalloClient.getApiClient();
-          if (!apiClient) {
-            if (this.getDebug()) console.log("[Paywallo IAP] transaction update dropped (no apiClient)", update.type);
-            return;
-          }
-          const distinctId = PaywalloClient.getDistinctId();
-          if (!distinctId) {
-            if (this.getDebug()) console.log("[Paywallo IAP] transaction update dropped (no distinctId)", update.type);
-            return;
-          }
-          const properties = {
-            type: update.type,
-            tx_id: update.transactionId,
-            product_id: update.productId
-          };
-          if (update.type !== "canceled") {
-            const cached2 = this.getProductFromCache(update.productId);
-            const amount = update.amount ?? cached2?.priceValue;
-            const currency = update.currency ?? cached2?.currency;
-            if (typeof amount === "number" && amount > 0) properties.amount = amount;
-            if (currency) properties.currency = currency;
-          }
-          await apiClient.trackEvent("transaction", distinctId, properties, void 0, { priority: "critical" });
-          if (this.getDebug()) console.log(`[Paywallo IAP] emitted transaction {${update.type}}`, update.transactionId);
-        } catch (err) {
-          if (this.getDebug()) console.log("[Paywallo IAP] transaction update emission failed", err);
-        }
-      }
-      /**
-       * Starts listening to native Transaction.updates. Idempotent.
+       * No-op. Native transaction update listener removed — sale events are sourced
+       * exclusively from server-side webhooks (Apple/Google/Superwall/RevenueCat).
        */
       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");
-        }
       }
       /**
-       * Removes the native listener. Safe to call multiple times.
+       * No-op. See startListener.
        */
       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");
       }
     };
   }
 });
 
-// src/errors/ClientError.ts
-var ClientError, CLIENT_ERROR_CODES;
-var init_ClientError = __esm({
-  "src/errors/ClientError.ts"() {
-    "use strict";
-    init_PaywalloError();
-    ClientError = class extends PaywalloError {
-      constructor(code, message) {
-        super("client", code, message);
-        this.name = "ClientError";
-      }
-    };
-    CLIENT_ERROR_CODES = {
-      NOT_INITIALIZED: "CLIENT_NOT_INITIALIZED",
-      MISSING_APP_KEY: "CLIENT_MISSING_APP_KEY",
-      INVALID_EVENT_NAME: "CLIENT_INVALID_EVENT_NAME",
-      PROVIDER_MISSING: "CLIENT_PROVIDER_MISSING",
-      INSECURE_REQUEST: "CLIENT_INSECURE_REQUEST",
-      UNKNOWN: "CLIENT_UNKNOWN"
-    };
-  }
-});
-
 // src/core/queue/deduplication.ts
 function normalizeForComparison(obj) {
   if (obj === null || obj === void 0) {
@@ -5047,6 +4841,56 @@ 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";
 var IAPValidator;
@@ -5145,8 +4989,202 @@ var init_IAPValidator = __esm({
   }
 });
 
+// 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() };
+        } catch (err) {
+          if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] subscribeToTransactionUpdates failed", err);
+          return null;
+        }
+      }
+    };
+    NativeStoreKit = nativeStoreKit;
+  }
+});
+
 // src/domains/iap/IAPService.ts
-import { Platform as Platform12 } from "react-native";
+import { Platform as Platform13 } from "react-native";
 function getIAPService() {
   if (!_instance) {
     _instance = new IAPService();
@@ -5245,8 +5283,8 @@ var init_IAPService = __esm({
       stopTransactionListener() {
         this.emitter.stopListener();
       }
-      async emitTransactionUpdate(update) {
-        return this.emitter.emitTransactionUpdate(update);
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      async emitTransactionUpdate(_update) {
       }
       async purchase(productId, options) {
         if (!nativeStoreKit.isAvailable()) {
@@ -5275,10 +5313,6 @@ 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") {
@@ -5307,7 +5341,7 @@ var init_IAPService = __esm({
           const transactions = await nativeStoreKit.getActiveTransactions();
           const apiClient = this.getApiClient();
           const distinctId = PaywalloClient.getDistinctId();
-          const platform = Platform12.OS;
+          const platform = Platform13.OS;
           const results = await Promise.allSettled(
             transactions.map((tx) => {
               const product = this.productsCache.get(tx.productId);
@@ -6374,8 +6408,145 @@ var init_plan = __esm({
 var init_session = __esm({
   "src/domains/session/index.ts"() {
     "use strict";
-    init_SessionError();
-    init_SessionManager();
+    init_SessionError();
+    init_SessionManager();
+  }
+});
+
+// src/domains/onboarding/OnboardingError.ts
+var OnboardingError, ONBOARDING_ERROR_CODES;
+var init_OnboardingError = __esm({
+  "src/domains/onboarding/OnboardingError.ts"() {
+    "use strict";
+    init_PaywalloError();
+    OnboardingError = class extends PaywalloError {
+      constructor(code, message) {
+        super("onboarding", code, message);
+        this.name = "OnboardingError";
+      }
+    };
+    ONBOARDING_ERROR_CODES = {
+      NOT_INITIALIZED: "ONBOARDING_NOT_INITIALIZED",
+      INVALID_STEP_NAME: "ONBOARDING_INVALID_STEP_NAME"
+    };
+  }
+});
+
+// src/domains/onboarding/OnboardingManager.ts
+var OnboardingManager, onboardingManager;
+var init_OnboardingManager = __esm({
+  "src/domains/onboarding/OnboardingManager.ts"() {
+    "use strict";
+    init_OnboardingError();
+    OnboardingManager = class {
+      constructor() {
+        this.pipeline = null;
+        this.debug = false;
+        this.lastStep = null;
+        this.finished = false;
+      }
+      /**
+       * Injects runtime dependencies. Called by PaywalloClient during init.
+       */
+      injectDeps(config) {
+        this.pipeline = config.pipeline;
+        this.debug = config.debug ?? false;
+      }
+      /**
+       * Tracks an onboarding step view.
+       * Saves the step name internally for implicit drop detection on the backend.
+       *
+       * @param stepName - Unique name for this onboarding step.
+       * @param order - Optional explicit display order (accepts decimals, e.g. 2.1 for A/B variants).
+       */
+      async step(stepName, order) {
+        this.assertConfig();
+        this.validateStepName(stepName, "step");
+        this.lastStep = stepName;
+        const stepPayload = { step_name: stepName };
+        if (order !== void 0 && Number.isFinite(order) && order >= 0) {
+          stepPayload.order = order;
+        }
+        const payload = {
+          family: "onboarding",
+          type: "step",
+          ...stepPayload
+        };
+        return this.emit("onboarding", payload, "step");
+      }
+      /**
+       * Tracks successful completion of the onboarding flow.
+       * Marks the flow as finished.
+       */
+      async complete() {
+        this.assertConfig();
+        this.finished = true;
+        return this.emit("onboarding", { family: "onboarding", type: "complete" }, "complete");
+      }
+      /**
+       * Tracks an explicit drop (abandonment) at the given step.
+       * Marks the flow as finished.
+       *
+       * @param stepName - The step name where the user dropped off.
+       */
+      async drop(stepName) {
+        this.assertConfig();
+        this.validateStepName(stepName, "drop");
+        this.finished = true;
+        const payload = {
+          family: "onboarding",
+          type: "drop",
+          ...{ step_name: stepName }
+        };
+        return this.emit("onboarding", payload, "drop");
+      }
+      /** 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();
   }
 });
 
@@ -6594,18 +6765,6 @@ async function trackEvent(apiClient, state, eventName, options) {
     options?.priority ? { priority: options.priority } : void 0
   );
 }
-async function trackOnboardingStep(apiClient, state, index, name) {
-  const distinctId = identityManager.getDistinctId();
-  if (!distinctId) return;
-  if (!Number.isInteger(index) || index < 0) {
-    const msg = `Invalid stepIndex: "${index}". Must be a non-negative integer.`;
-    throw new AnalyticsError(ANALYTICS_ERROR_CODES.INVALID_STEP_INDEX, msg);
-  }
-  const now = Date.now();
-  const timeOnPreviousStep = state.lastOnboardingStepTimestamp !== null ? Math.round((now - state.lastOnboardingStepTimestamp) / 1e3) : 0;
-  state.lastOnboardingStepTimestamp = now;
-  await apiClient.trackEvent("$onboarding_step", distinctId, { stepIndex: index, stepName: name, timeOnPreviousStep });
-}
 function validateCoreAction(actionName) {
   if (!actionName || typeof actionName !== "string") {
     const msg = `Invalid actionName: "${actionName}". Must be a non-empty string.`;
@@ -6669,138 +6828,6 @@ var init_PaywalloFlags = __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.
-       */
-      async step(stepName) {
-        this.assertConfig();
-        this.validateStepName(stepName, "step");
-        this.lastStep = stepName;
-        const payload = {
-          family: "onboarding",
-          type: "step",
-          ...{ step_name: stepName }
-        };
-        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/paywallHeartbeatRecovery.ts
 async function recoverPaywallHeartbeat(apiClient, distinctId, sessionId, debug) {
   const snapshot = await readPersistedHeartbeat();
@@ -7132,6 +7159,36 @@ var init_SubscriptionManager = __esm({
   }
 });
 
+// src/utils/detectEnvironment.ts
+import { NativeModules as NativeModules7 } from "react-native";
+async function detectEnvironment() {
+  if (cached !== null) return cached;
+  if (typeof globalThis.__DEV__ !== "undefined" && globalThis.__DEV__) {
+    cached = "sandbox";
+    return cached;
+  }
+  if (!nativeModule) {
+    cached = "production";
+    return cached;
+  }
+  try {
+    const result = await nativeModule.detect();
+    cached = result === "sandbox" ? "sandbox" : "production";
+    return cached;
+  } catch {
+    cached = "production";
+    return cached;
+  }
+}
+var nativeModule, cached;
+var init_detectEnvironment = __esm({
+  "src/utils/detectEnvironment.ts"() {
+    "use strict";
+    nativeModule = NativeModules7.PaywalloEnv ?? null;
+    cached = null;
+  }
+});
+
 // src/domains/iap/apiPurchaseMethods.ts
 async function validatePurchase(client, appKey, platform, receipt, productId, transactionId, priceLocal, currency, country, distinctId, paywallPlacement, variantKey) {
   const response = await client.post(
@@ -7457,7 +7514,7 @@ var init_ApiClientQueue = __esm({
 });
 
 // src/core/eventEnvelopeV2.ts
-import { Platform as Platform13 } from "react-native";
+import { Platform as Platform14 } from "react-native";
 import { z as z2 } from "zod";
 function buildV2Envelope(events, providerContext) {
   const context = { ...providerContext };
@@ -7473,21 +7530,42 @@ function buildV2Envelope(events, providerContext) {
     if (family === "custom") {
       payload.event_name = event.eventName;
     }
-    return {
-      id: generateUUID(),
-      ts: event.timestamp,
-      name: family,
-      payload
-    };
+    const candidateId = payload.installEventId;
+    let id;
+    if (typeof candidateId === "string" && isValidUUIDv4(candidateId)) {
+      id = candidateId;
+      delete payload.installEventId;
+    } else {
+      id = generateUUID();
+    }
+    return { id, ts: event.timestamp, name: family, payload };
   });
   if (context.sdk_version === void 0) context.sdk_version = SDK_VERSION;
-  if (context.platform === void 0) context.platform = Platform13.OS;
+  if (context.platform === void 0) context.platform = Platform14.OS;
   if (context.distinct_id === void 0 && events.length > 0) {
     context.distinct_id = events[0].distinctId;
   }
   if (!context.distinct_id || context.distinct_id.length === 0) {
     console.error("[Paywallo:ENVELOPE] distinct_id is empty after resolution \u2014 envelope will fail schema", { providerContext, eventCount: events.length, firstEventName: events[0]?.eventName });
   }
+  const idsFromProps = {};
+  const existingIds = context.ids;
+  for (const event of events) {
+    for (const { key, aliases } of IDS_PROMO_ALIASES) {
+      if (existingIds?.[key] !== void 0) continue;
+      if (idsFromProps[key] !== void 0) continue;
+      for (const alias of aliases) {
+        const val = event.properties[alias];
+        if (typeof val === "string" && val.length > 0) {
+          idsFromProps[key] = val;
+          break;
+        }
+      }
+    }
+  }
+  if (Object.keys(idsFromProps).length > 0) {
+    context.ids = { ...idsFromProps, ...context.ids };
+  }
   return { context, events: v2Events };
 }
 function resolveProviderContext(provider) {
@@ -7521,7 +7599,7 @@ function splitPayloadAndContext(properties) {
   }
   return { payload, promoted };
 }
-var v2EventSchema, v2ContextSchema, v2EnvelopeSchema, CONTEXT_KEY_ALIASES;
+var v2EventSchema, v2ContextSchema, v2EnvelopeSchema, IDS_PROMO_ALIASES, CONTEXT_KEY_ALIASES;
 var init_eventEnvelopeV2 = __esm({
   "src/core/eventEnvelopeV2.ts"() {
     "use strict";
@@ -7547,6 +7625,7 @@ var init_eventEnvelopeV2 = __esm({
       device_model: z2.string().optional(),
       timezone: z2.string().optional(),
       locale: z2.string().optional(),
+      country: z2.string().optional(),
       carrier: z2.string().optional(),
       screen_width: z2.number().optional(),
       screen_height: z2.number().optional(),
@@ -7558,6 +7637,12 @@ var init_eventEnvelopeV2 = __esm({
       context: v2ContextSchema,
       events: z2.array(v2EventSchema).min(1)
     });
+    IDS_PROMO_ALIASES = [
+      { key: "idfv", aliases: ["idfv"] },
+      { key: "gaid", aliases: ["gaid"] },
+      { key: "fb_anon_id", aliases: ["fbAnonId", "fb_anon_id"] },
+      { key: "idfa", aliases: ["idfa"] }
+    ];
     CONTEXT_KEY_ALIASES = {
       distinct_id: ["distinct_id", "distinctId"],
       session_id: ["session_id", "sessionId"],
@@ -7574,6 +7659,7 @@ var init_eventEnvelopeV2 = __esm({
       device_model: ["device_model", "deviceModel", "model"],
       timezone: ["timezone", "timeZone"],
       locale: ["locale"],
+      country: ["country", "regionCode"],
       carrier: ["carrier_ctx"],
       screen_width: ["screen_width"],
       screen_height: ["screen_height"],
@@ -7593,7 +7679,7 @@ var init_events = __esm({
 });
 
 // src/core/EventBatcher.ts
-import { Platform as Platform14 } from "react-native";
+import { Platform as Platform15 } from "react-native";
 var BATCH_MAX_SIZE, BATCH_FLUSH_MS, EVENT_NAME_REGEX, V2_BATCH_ENDPOINT, EventBatcher;
 var init_EventBatcher = __esm({
   "src/core/EventBatcher.ts"() {
@@ -7646,7 +7732,7 @@ var init_EventBatcher = __esm({
         const event = {
           eventName,
           distinctId,
-          properties: { ...properties, platform: Platform14.OS },
+          properties: { ...properties, platform: Platform15.OS },
           timestamp: timestamp ?? Date.now(),
           environment: environment.toLowerCase()
         };
@@ -7972,7 +8058,7 @@ var init_http = __esm({
 });
 
 // src/core/ApiClient.ts
-import { Platform as Platform15 } from "react-native";
+import { Platform as Platform16 } from "react-native";
 function normalizeDateOfBirth(raw) {
   if (!raw) return void 0;
   if (DATE_OF_BIRTH_RE.test(raw)) return raw;
@@ -8108,7 +8194,7 @@ var init_ApiClient = __esm({
       buildSdkHeaders() {
         return {
           "x-sdk-version": SDK_VERSION,
-          "x-sdk-platform": Platform15.OS,
+          "x-sdk-platform": Platform16.OS,
           "x-sdk-environment": this.environment
         };
       }
@@ -8138,7 +8224,7 @@ var init_ApiClient = __esm({
             message,
             context,
             sdkVersion: SDK_VERSION,
-            platform: Platform15.OS
+            platform: Platform16.OS
           }, true);
         } catch (err) {
           if (this.debug) console.log("[Paywallo:ApiClient] reportError failed", err);
@@ -8156,7 +8242,7 @@ var init_ApiClient = __esm({
       async identify(distinctId, properties, email, deviceId, pii) {
         const rawTraits = {
           email: email || void 0,
-          platform: Platform15.OS,
+          platform: Platform16.OS,
           name: properties?.name,
           country: properties?.country,
           locale: properties?.locale,
@@ -8352,7 +8438,7 @@ function setupNotifications(apiClient, config, environment, eventPipeline) {
     notificationsManager.setupHandlers({ eventBatcher: eventPipeline });
     notificationsManager.initialize({
       appKey: config.appKey,
-      apiBaseUrl: config.apiUrl ?? DEFAULT_API_URL,
+      apiBaseUrl: DEFAULT_API_URL,
       debug: config.debug,
       environment: environment === "Sandbox" ? "sandbox" : "production"
     }).catch((err) => {
@@ -8431,36 +8517,6 @@ var init_PaywalloState = __esm({
   }
 });
 
-// src/utils/detectEnvironment.ts
-import { NativeModules as NativeModules8 } from "react-native";
-async function detectEnvironment() {
-  if (cached !== null) return cached;
-  if (typeof globalThis.__DEV__ !== "undefined" && globalThis.__DEV__) {
-    cached = "sandbox";
-    return cached;
-  }
-  if (!nativeModule) {
-    cached = "production";
-    return cached;
-  }
-  try {
-    const result = await nativeModule.detect();
-    cached = result === "sandbox" ? "sandbox" : "production";
-    return cached;
-  } catch {
-    cached = "production";
-    return cached;
-  }
-}
-var nativeModule, cached;
-var init_detectEnvironment = __esm({
-  "src/utils/detectEnvironment.ts"() {
-    "use strict";
-    nativeModule = NativeModules8.PaywalloEnv ?? null;
-    cached = null;
-  }
-});
-
 // src/core/PaywalloInitializer.ts
 import { Dimensions as Dimensions4, PixelRatio as PixelRatio2 } from "react-native";
 async function initWithRetry(state, config) {
@@ -8507,7 +8563,7 @@ function reportInitFailure(state, config, error, reason) {
   try {
     const tempClient = new ApiClient(
       config.appKey,
-      config.apiUrl ?? DEFAULT_API_URL,
+      DEFAULT_API_URL,
       config.debug
     );
     void tempClient.reportError("INIT_FAILED", reason, {
@@ -8557,7 +8613,7 @@ async function doInit(state, config) {
   ]);
   const apiClient = new ApiClient(
     config.appKey,
-    config.apiUrl ?? DEFAULT_API_URL,
+    DEFAULT_API_URL,
     config.debug,
     environment,
     offlineQueueEnabled,
@@ -8631,8 +8687,8 @@ async function doInit(state, config) {
     let timezone;
     try {
       const opts = Intl.DateTimeFormat().resolvedOptions();
-      locale = opts.locale || void 0;
-      timezone = opts.timeZone || void 0;
+      locale = device?.languageTag || opts.locale || void 0;
+      timezone = device?.timeZone || opts.timeZone || void 0;
     } catch {
     }
     let screenWidth;
@@ -8656,7 +8712,7 @@ async function doInit(state, config) {
       device_model: device?.modelId || device?.model || void 0,
       timezone,
       locale,
-      carrier: device?.carrier || void 0,
+      ...device?.regionCode && { country: device.regionCode },
       screen_width: screenWidth,
       screen_height: screenHeight,
       screen_density: screenDensity,
@@ -8722,6 +8778,7 @@ var init_PaywalloInitializer = __esm({
     init_plan();
     init_session();
     init_SubscriptionManager();
+    init_detectEnvironment();
     init_NativeDeviceInfo();
     init_ApiClient();
     init_constants();
@@ -8731,7 +8788,6 @@ var init_PaywalloInitializer = __esm({
     init_PaywalloState();
     init_queue();
     init_NativeStorage();
-    init_detectEnvironment();
   }
 });
 
@@ -8852,6 +8908,7 @@ var init_PaywalloClient = __esm({
     init_plan();
     init_session();
     init_ClientError();
+    init_onboarding();
     init_network();
     init_PaywalloAnalytics();
     init_PaywalloFlags();
@@ -8921,8 +8978,9 @@ var init_PaywalloClient = __esm({
       async track(eventName, options) {
         return trackEvent(this.getApiClientOrThrow(), this.state, eventName, options);
       }
-      async onboardingStep(index, name) {
-        return trackOnboardingStep(this.getApiClientOrThrow(), this.state, index, name);
+      async onboardingStep(order, name) {
+        this.ensureInitialized();
+        return onboardingManager.step(name, order);
       }
       async coreAction(actionName) {
         this.ensureInitialized();
@@ -9009,6 +9067,9 @@ var init_PaywalloClient = __esm({
       getConfig() {
         return this.state.config;
       }
+      getId() {
+        return identityManager.getDistinctId();
+      }
       getDistinctId() {
         return identityManager.getDistinctId();
       }
@@ -9146,9 +9207,9 @@ __export(OfferingService_exports, {
   OfferingService: () => OfferingService,
   offeringService: () => offeringService
 });
-import { Platform as Platform16 } from "react-native";
+import { Platform as Platform17 } from "react-native";
 function resolveProductId(raw) {
-  const isIos = Platform16.OS === "ios";
+  const isIos = Platform17.OS === "ios";
   const productId = isIos ? raw.apple_product_id : raw.google_product_id;
   return productId ?? "";
 }
@@ -9167,7 +9228,7 @@ function mapProduct2(raw) {
   };
 }
 function pickPlatformProduct(products) {
-  const isIos = Platform16.OS === "ios";
+  const isIos = Platform17.OS === "ios";
   const match = products.find((p) => isIos ? p.apple_product_id : p.google_product_id);
   return match ?? products[0] ?? null;
 }
@@ -9394,7 +9455,7 @@ init_onboarding();
 import { useCallback as useCallback9 } from "react";
 function useOnboarding() {
   const step = useCallback9(
-    (stepName) => onboardingManager.step(stepName),
+    (stepName, order) => onboardingManager.step(stepName, order),
     []
   );
   const complete = useCallback9(
@@ -9738,8 +9799,41 @@ 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 useCallback19, useEffect as useEffect14, useLayoutEffect, useMemo as useMemo3, useRef as useRef11, useState as useState17 } from "react";
+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";
 init_PaywalloClient();
 init_NativeStorage();
@@ -9962,50 +10056,9 @@ 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?.storeTransactionId ?? transaction?.originalTransactionIdentifier ?? `${productId}_${String(ts)}`;
-      const isTrial = product.hasFreeTrial === true || (product.trialPeriodPrice ?? 0) > 0;
-      const paywallIdentifier = ev.paywallInfo?.identifier;
-      log2("onSuperwallEvent: transactionComplete", { productId, currency, price, 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 (not `tx_id`). PurchaseHandler
-              // then resolves type=trial/new/renewal based on amount being 0 vs >0.
-              transaction_id: transactionId,
-              product_id: productId,
-              amount: price,
-              currency,
-              ...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) {
@@ -10049,7 +10102,7 @@ init_session();
 init_ClientError();
 
 // src/hooks/useAppAutoEvents.ts
-import { useEffect as useEffect13, useRef as useRef8 } from "react";
+import { useEffect as useEffect13, useRef as useRef9 } from "react";
 
 // src/utils/platformDetection.ts
 async function detectPlatform3() {
@@ -10075,7 +10128,7 @@ var FIRST_SEEN_KEY = "@paywallo:firstSeen_v226";
 var DEBOUNCE_MS = 1e3;
 function useAppAutoEvents(config) {
   const { isInitialized, getAppVersion: getAppVersion2, getSessionId, emitLifecycle, storageGet, storageSet, debug } = config;
-  const didRunRef = useRef8(false);
+  const didRunRef = useRef9(false);
   useEffect13(() => {
     if (debug) console.log("[Paywallo EVENTS] useEffect fired", { isInitialized, didRunRefCurrent: didRunRef.current });
     if (!isInitialized || didRunRef.current) return;
@@ -10086,13 +10139,13 @@ function useAppAutoEvents(config) {
         const sessionId = getSessionId();
         const appVersion = getAppVersion2();
         const deviceType = await detectPlatform3();
-        const osVersion = await detectOsVersion();
-        if (debug) console.log("[Paywallo EVENTS] computed device context", { deviceType, osVersion, appVersion, sessionId, hasSessionId: !!sessionId });
+        const osVersion2 = await detectOsVersion();
+        if (debug) console.log("[Paywallo EVENTS] computed device context", { deviceType, osVersion: osVersion2, appVersion, sessionId, hasSessionId: !!sessionId });
         try {
           if (debug) console.log("[Paywallo EVENTS] checking install \u2014 about to read FIRST_SEEN_KEY");
           const firstSeen = await storageGet(FIRST_SEEN_KEY);
           if (!firstSeen) {
-            await emitLifecycle({ type: "install", device_type: deviceType, os_version: osVersion, app_version: appVersion, ...sessionId ? { session_id: sessionId } : {} }, "critical");
+            await emitLifecycle({ type: "install", device_type: deviceType, os_version: osVersion2, app_version: appVersion, ...sessionId ? { session_id: sessionId } : {} }, "critical");
             await storageSet(FIRST_SEEN_KEY, (/* @__PURE__ */ new Date()).toISOString());
             if (debug) console.log("[Paywallo EVENTS] install event emitted (first time)");
             if (debug) console.log("[Paywallo EVENTS] lifecycle install emitted");
@@ -10104,7 +10157,7 @@ function useAppAutoEvents(config) {
         }
         try {
           if (debug) console.log("[Paywallo EVENTS] emitting cold_start");
-          await emitLifecycle({ type: "cold_start", app_version: appVersion, device_type: deviceType, os_version: osVersion, ...sessionId ? { session_id: sessionId } : {} }, "normal");
+          await emitLifecycle({ type: "cold_start", app_version: appVersion, device_type: deviceType, os_version: osVersion2, ...sessionId ? { session_id: sessionId } : {} }, "normal");
           if (debug) console.log("[Paywallo EVENTS] lifecycle cold_start emitted");
         } catch (err) {
           if (debug) console.log("[Paywallo EVENTS] lifecycle cold_start failed", err);
@@ -10118,7 +10171,7 @@ function useAppAutoEvents(config) {
 // src/hooks/useCampaignPreload.ts
 init_PaywalloClient();
 init_CampaignError();
-import { useCallback as useCallback15, useRef as useRef9, useState as useState14 } from "react";
+import { useCallback as useCallback16, useRef as useRef10, useState as useState14 } from "react";
 
 // src/utils/loadCampaignProducts.ts
 init_IAPService();
@@ -10188,16 +10241,16 @@ function getCacheEntry(cache, placement) {
 // src/hooks/useCampaignPreload.ts
 function useCampaignPreload() {
   const [preloadedWebView, setPreloadedWebView] = useState14(null);
-  const preloadedCampaignsRef = useRef9(/* @__PURE__ */ new Map());
-  const isPreloadValid = useCallback15(
+  const preloadedCampaignsRef = useRef10(/* @__PURE__ */ new Map());
+  const isPreloadValid = useCallback16(
     (placement) => isCacheEntryValid(preloadedCampaignsRef.current.get(placement)),
     []
   );
-  const consumePreloadedCampaign = useCallback15(
+  const consumePreloadedCampaign = useCallback16(
     (placement) => getCacheEntry(preloadedCampaignsRef.current, placement),
     []
   );
-  const preloadCampaign = useCallback15(
+  const preloadCampaign = useCallback16(
     async (placement, context) => {
       try {
         const campaign = await PaywalloClient.getCampaign(placement, context);
@@ -10266,11 +10319,11 @@ function useCampaignPreload() {
 }
 
 // src/hooks/useProductLoader.ts
-import { useCallback as useCallback16, useState as useState15 } from "react";
+import { useCallback as useCallback17, useState as useState15 } from "react";
 function useProductLoader() {
   const [products, setProducts] = useState15(/* @__PURE__ */ new Map());
   const [isLoadingProducts, setIsLoadingProducts] = useState15(false);
-  const refreshProducts = useCallback16(async (productIds) => {
+  const refreshProducts = useCallback17(async (productIds) => {
     setIsLoadingProducts(true);
     try {
       const iapService = getIAPService();
@@ -10288,11 +10341,11 @@ function useProductLoader() {
 }
 
 // src/hooks/usePurchaseOrchestrator.ts
-import { useCallback as useCallback17 } from "react";
+import { useCallback as useCallback18 } from "react";
 init_paywall();
 function usePurchaseOrchestrator(preloadedWebView, resolvePreloadedPaywall, clearPreloadedWebView, setShowingPreloadedWebView, presentedAtRef, invalidateSubscriptionCache) {
   const { trackDismissed, trackProductSelected, trackPurchased } = usePaywallTracking();
-  const handlePreloadedPurchase = useCallback17(
+  const handlePreloadedPurchase = useCallback18(
     async (productId) => {
       try {
         if (preloadedWebView) {
@@ -10330,7 +10383,7 @@ function usePurchaseOrchestrator(preloadedWebView, resolvePreloadedPaywall, clea
     },
     [preloadedWebView, resolvePreloadedPaywall, clearPreloadedWebView, setShowingPreloadedWebView, presentedAtRef, trackDismissed, trackProductSelected, trackPurchased, invalidateSubscriptionCache]
   );
-  const handlePreloadedRestore = useCallback17(async () => {
+  const handlePreloadedRestore = useCallback18(async () => {
     try {
       const transactions = await getIAPService().restore();
       if (transactions.length === 0) return;
@@ -10355,7 +10408,7 @@ function usePurchaseOrchestrator(preloadedWebView, resolvePreloadedPaywall, clea
 // src/hooks/useSubscriptionSync.ts
 init_PaywalloClient();
 init_SubscriptionCache();
-import { useCallback as useCallback18, useRef as useRef10, useState as useState16 } from "react";
+import { useCallback as useCallback19, useRef as useRef11, useState as useState16 } from "react";
 
 // src/hooks/subscriptionSyncHelpers.ts
 init_SubscriptionCache();
@@ -10464,17 +10517,17 @@ async function checkPersistedCache(distinctId, onHit) {
 // src/hooks/useSubscriptionSync.ts
 function useSubscriptionSync() {
   const [subscription, setSubscription] = useState16(null);
-  const cacheRef = useRef10(null);
-  const setCacheAndState = useCallback18((sub) => {
+  const cacheRef = useRef11(null);
+  const setCacheAndState = useCallback19((sub) => {
     cacheRef.current = { data: sub, expiresAt: Date.now() + CACHE_TTL_MS2 };
     setSubscription(sub);
   }, []);
-  const invalidateCache = useCallback18(() => {
+  const invalidateCache = useCallback19(() => {
     cacheRef.current = null;
     const distinctId = PaywalloClient.getDistinctId();
     if (distinctId) void subscriptionCache.invalidate(distinctId);
   }, []);
-  const fetchAndCache = useCallback18(async () => {
+  const fetchAndCache = useCallback19(async () => {
     const apiClient = PaywalloClient.getApiClient();
     const distinctId = PaywalloClient.getDistinctId();
     if (!apiClient || !distinctId) return null;
@@ -10484,7 +10537,7 @@ function useSubscriptionSync() {
     void subscriptionCache.set(distinctId, toDomainResponse(status));
     return sub;
   }, [setCacheAndState]);
-  const hasActiveSubscription = useCallback18(async () => {
+  const hasActiveSubscription = useCallback19(async () => {
     const apiClient = PaywalloClient.getApiClient();
     const distinctId = PaywalloClient.getDistinctId();
     if (!apiClient || !distinctId) return false;
@@ -10504,7 +10557,7 @@ function useSubscriptionSync() {
       return resolveOfflineFromCache(distinctId);
     }
   }, [setCacheAndState]);
-  const getSubscription = useCallback18(async () => {
+  const getSubscription = useCallback19(async () => {
     const apiClient = PaywalloClient.getApiClient();
     const distinctId = PaywalloClient.getDistinctId();
     if (!apiClient || !distinctId) return null;
@@ -10536,12 +10589,12 @@ function PaywalloProvider({ children, config }) {
   const { products, isLoadingProducts, refreshProducts } = useProductLoader();
   const { subscription, hasActiveSubscription, getSubscription, invalidateCache } = useSubscriptionSync();
   const { preloadedWebView, setPreloadedWebView, preloadCampaign, consumePreloadedCampaign, isPreloadValid } = useCampaignPreload();
-  const clearPreloadedWebView = useCallback19(() => setPreloadedWebView(null), [setPreloadedWebView]);
-  const autoPreloadTriggeredRef = useRef11(false);
-  const preloadedWebViewRef = useRef11(preloadedWebView);
-  const pollTimerRef = useRef11(null);
-  const pollCancelledRef = useRef11(false);
-  const secureStorageRef = useRef11(new SecureStorage(config.debug));
+  const clearPreloadedWebView = useCallback20(() => setPreloadedWebView(null), [setPreloadedWebView]);
+  const autoPreloadTriggeredRef = useRef12(false);
+  const preloadedWebViewRef = useRef12(preloadedWebView);
+  const pollTimerRef = useRef12(null);
+  const pollCancelledRef = useRef12(false);
+  const secureStorageRef = useRef12(new SecureStorage(config.debug));
   useEffect14(() => {
     preloadedWebViewRef.current = preloadedWebView;
   }, [preloadedWebView]);
@@ -10568,20 +10621,20 @@ function PaywalloProvider({ children, config }) {
     },
     debug: config.debug
   });
-  const triggerRepreload = useCallback19((placement) => {
+  const triggerRepreload = useCallback20((placement) => {
     void PaywalloClient.preloadCampaign(placement).catch(() => {
     });
   }, []);
   const { showingPreloadedWebView, presentPreloadedWebView, resolvePreloadedPaywall, handlePreloadedWebViewReady: baseHandlePreloadedWebViewReady, handlePreloadedClose: baseHandlePreloadedClose, setShowingPreloadedWebView, presentedAtRef } = usePaywallPresenter(preloadedWebView, setPreloadedWebView);
   const SCREEN_HEIGHT = useMemo3(() => Dimensions5.get("window").height, []);
-  const slideAnim = useRef11(new Animated4.Value(SCREEN_HEIGHT)).current;
-  const handlePreloadedWebViewReady = useCallback19(() => {
+  const slideAnim = useRef12(new Animated4.Value(SCREEN_HEIGHT)).current;
+  const handlePreloadedWebViewReady = useCallback20(() => {
     if (PaywalloClient.getConfig()?.debug) {
       console.log(`[Paywallo WEBVIEW] loaded \u2014 placement: ${preloadedWebView?.placement}`);
     }
     baseHandlePreloadedWebViewReady();
   }, [preloadedWebView?.placement, baseHandlePreloadedWebViewReady]);
-  const handlePreloadedClose = useCallback19(() => {
+  const handlePreloadedClose = useCallback20(() => {
     const placement = preloadedWebView?.placement;
     Animated4.timing(slideAnim, { toValue: SCREEN_HEIGHT, duration: 200, easing: Easing2.in(Easing2.cubic), useNativeDriver: true }).start(() => {
       baseHandlePreloadedClose();
@@ -10597,7 +10650,7 @@ function PaywalloProvider({ children, config }) {
     invalidateCache
   );
   const [isPreloadPurchasing, setIsPreloadPurchasing] = useState17(false);
-  const handlePreloadedPurchase = useCallback19(async (productId) => {
+  const handlePreloadedPurchase = useCallback20(async (productId) => {
     setIsPreloadPurchasing(true);
     try {
       await rawPreloadedPurchase(productId);
@@ -10605,15 +10658,25 @@ function PaywalloProvider({ children, config }) {
       setIsPreloadPurchasing(false);
     }
   }, [rawPreloadedPurchase]);
-  const configRef = useRef11(config);
+  const configRef = useRef12(config);
   useEffect14(() => {
     let mounted = true;
-    initLocalization({ detectDevice: true });
-    PaywalloClient.init(configRef.current).then(async () => {
+    const bootstrap = async () => {
+      if (!PaywalloClient.isReady()) {
+        initLocalization({ detectDevice: true });
+        try {
+          await PaywalloClient.init(configRef.current);
+        } catch (err) {
+          if (!mounted) return;
+          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;
       setDistinctId(PaywalloClient.getDistinctId());
-      startSuperwallAutoBridge(configRef.current.debug);
-      void pushAttributionToSuperwall(configRef.current.debug);
       setIsInitialized(true);
       if (!autoPreloadTriggeredRef.current) {
         autoPreloadTriggeredRef.current = true;
@@ -10626,19 +10689,17 @@ function PaywalloProvider({ children, config }) {
           });
         }
       }
-    }).catch((err) => {
-      if (!mounted) return;
-      setInitError(err instanceof Error ? err : new ClientError(CLIENT_ERROR_CODES.NOT_INITIALIZED, String(err)));
-    });
+    };
+    void bootstrap();
     return () => {
       mounted = false;
     };
   }, [preloadCampaign]);
-  const getPaywallConfig = useCallback19(async (p) => {
+  const getPaywallConfig = useCallback20(async (p) => {
     const api = PaywalloClient.getApiClient();
     return api ? api.getPaywall(p) : null;
   }, []);
-  const presentPaywall = useCallback19((placement) => {
+  const presentPaywall = useCallback20((placement) => {
     const preloaded = paywallPreloadService.getPreloaded(placement);
     return new Promise((resolve) => setActivePaywall({
       placement,
@@ -10656,7 +10717,7 @@ function PaywalloProvider({ children, config }) {
       }
     }));
   }, []);
-  const trackCampaignImpression = useCallback19((placement, variantKey, campaignId) => {
+  const trackCampaignImpression = useCallback20((placement, variantKey, campaignId) => {
     const api = PaywalloClient.getApiClient();
     if (!api) return;
     const sessionId = PaywalloClient.getSessionId();
@@ -10670,7 +10731,7 @@ function PaywalloProvider({ children, config }) {
     }).catch(() => {
     });
   }, []);
-  const presentCampaign = useCallback19(
+  const presentCampaign = useCallback20(
     async (placement, context) => {
       try {
         if (preloadedWebView?.placement === placement && preloadedWebView.loaded && isPreloadValid(placement)) {
@@ -10744,7 +10805,7 @@ function PaywalloProvider({ children, config }) {
     },
     [preloadedWebView, isPreloadValid, consumePreloadedCampaign, presentPreloadedWebView, trackCampaignImpression]
   );
-  const restorePurchases = useCallback19(async () => {
+  const restorePurchases = useCallback20(async () => {
     invalidateCache();
     try {
       const txs = await getIAPService().restore();
@@ -10753,13 +10814,13 @@ function PaywalloProvider({ children, config }) {
       return { success: false, restoredProducts: [], error: error instanceof Error ? error : new PurchaseError(PURCHASE_ERROR_CODES.RESTORE_FAILED, String(error)) };
     }
   }, [invalidateCache]);
-  const handlePaywallResult = useCallback19((result) => {
+  const handlePaywallResult = useCallback20((result) => {
     if (activePaywall) {
       activePaywall.resolver(result);
       setActivePaywall(null);
     }
   }, [activePaywall]);
-  const bridgePaywallPresenter = useCallback19((placement) => {
+  const bridgePaywallPresenter = useCallback20((placement) => {
     if (PaywalloClient.getConfig()?.debug) {
       console.log(`[Paywallo PRESENT] called \u2014 preloaded: ${preloadedWebViewRef.current?.loaded === true} placement: ${placement}`);
     }
@@ -10815,7 +10876,7 @@ function PaywalloProvider({ children, config }) {
     };
   }, [isInitialized, bridgePaywallPresenter, getSubscription, hasActiveSubscription, restorePurchases]);
   const isReady = isInitialized && !isLoadingProducts;
-  const noOp = useCallback19(() => {
+  const noOp = useCallback20(() => {
   }, []);
   const contextValue = useMemo3(() => ({
     config: PaywalloClient.getConfig(),
@@ -11070,6 +11131,7 @@ export {
   createPurchaseError,
   index_default as default,
   detectDeviceLanguage,
+  getActiveRouteName,
   getCurrentLanguage,
   getDefaultLanguage,
   getIAPService,
@@ -11098,6 +11160,7 @@ export {
   useOnboarding,
   usePaywallContext,
   usePaywallo,
+  usePaywalloScreenTracking,
   usePlanPurchase,
   usePlans,
   useProducts,