@virex-tech/paywallo-sdk 2.4.0 → 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.0") {
-      return "2.4.0";
+    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,90 +3944,17 @@ 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"
-    };
   }
 });
 
@@ -4531,11 +4325,11 @@ var init_OfflineQueue = __esm({
           });
           return true;
         }
-        const delay = Math.min(
+        const delay2 = Math.min(
           this.config.baseRetryDelayMs * Math.pow(2, item.attempts - 1),
           this.config.maxRetryDelayMs
         );
-        item.nextRetryAt = Date.now() + delay;
+        item.nextRetryAt = Date.now() + delay2;
         await this.storage.saveToStorage(this.queue);
         return false;
       }
@@ -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,53 +4989,247 @@ var init_IAPValidator = __esm({
   }
 });
 
-// src/domains/iap/IAPService.ts
-import { Platform as Platform12 } from "react-native";
-function getIAPService() {
-  if (!_instance) {
-    _instance = new IAPService();
-    _instance.startTransactionListener();
+// 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 _instance;
+  return product;
 }
-var IAPService, _instance;
-var init_IAPService = __esm({
-  "src/domains/iap/IAPService.ts"() {
+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_IAPTransactionEmitter();
-    init_IAPValidator();
-    init_NativeStoreKit();
+    init_uuid();
+    init_IdentityManager();
     init_PurchaseError();
-    IAPService = class {
-      constructor(apiClient) {
-        this.productsCache = /* @__PURE__ */ new Map();
-        this.apiClient = null;
-        this.purchaseInFlight = null;
-        /**
-         * Idempotency guard against double-finish. Populated with transaction IDs
-         * that have already been forwarded to `NativeStoreKit.finishTransaction`.
-         */
-        this.finishedTransactions = /* @__PURE__ */ new Set();
-        this.apiClient = apiClient ?? null;
-        this.validator = new IAPValidator(
-          (id) => this.productsCache.get(id),
-          () => this.getApiClient(),
-          () => this.debug,
-          () => this.getDeviceCountry()
-        );
-        this.emitter = new IAPTransactionEmitter(
-          (id) => this.productsCache.get(id),
-          () => this.apiClient ?? PaywalloClient.getApiClient(),
-          () => this.debug
-        );
-      }
-      get debug() {
-        return PaywalloClient.getConfig()?.debug ?? false;
-      }
-      getDeviceCountry() {
-        try {
-          const locale = Intl.DateTimeFormat().resolvedOptions().locale;
+    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 Platform13 } from "react-native";
+function getIAPService() {
+  if (!_instance) {
+    _instance = new IAPService();
+    _instance.startTransactionListener();
+  }
+  return _instance;
+}
+var IAPService, _instance;
+var init_IAPService = __esm({
+  "src/domains/iap/IAPService.ts"() {
+    "use strict";
+    init_PaywalloClient();
+    init_IAPTransactionEmitter();
+    init_IAPValidator();
+    init_NativeStoreKit();
+    init_PurchaseError();
+    IAPService = class {
+      constructor(apiClient) {
+        this.productsCache = /* @__PURE__ */ new Map();
+        this.apiClient = null;
+        this.purchaseInFlight = null;
+        /**
+         * Idempotency guard against double-finish. Populated with transaction IDs
+         * that have already been forwarded to `NativeStoreKit.finishTransaction`.
+         */
+        this.finishedTransactions = /* @__PURE__ */ new Set();
+        this.apiClient = apiClient ?? null;
+        this.validator = new IAPValidator(
+          (id) => this.productsCache.get(id),
+          () => this.getApiClient(),
+          () => this.debug,
+          () => this.getDeviceCountry()
+        );
+        this.emitter = new IAPTransactionEmitter(
+          (id) => this.productsCache.get(id),
+          () => this.apiClient ?? PaywalloClient.getApiClient(),
+          () => this.debug
+        );
+      }
+      get debug() {
+        return PaywalloClient.getConfig()?.debug ?? false;
+      }
+      getDeviceCountry() {
+        try {
+          const locale = Intl.DateTimeFormat().resolvedOptions().locale;
           const parts = locale.split("-");
           return parts[parts.length - 1]?.toUpperCase() || "US";
         } catch {
@@ -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);
@@ -6379,319 +6413,29 @@ var init_session = __esm({
   }
 });
 
-// src/domains/analytics/AnalyticsError.ts
-var AnalyticsError, ANALYTICS_ERROR_CODES;
-var init_AnalyticsError = __esm({
-  "src/domains/analytics/AnalyticsError.ts"() {
+// src/domains/onboarding/OnboardingError.ts
+var OnboardingError, ONBOARDING_ERROR_CODES;
+var init_OnboardingError = __esm({
+  "src/domains/onboarding/OnboardingError.ts"() {
     "use strict";
     init_PaywalloError();
-    AnalyticsError = class extends PaywalloError {
+    OnboardingError = class extends PaywalloError {
       constructor(code, message) {
-        super("analytics", code, message);
-        this.name = "AnalyticsError";
+        super("onboarding", code, message);
+        this.name = "OnboardingError";
       }
     };
-    ANALYTICS_ERROR_CODES = {
-      NOT_INITIALIZED: "ANALYTICS_NOT_INITIALIZED",
-      INVALID_STEP_INDEX: "ANALYTICS_INVALID_STEP_INDEX",
-      INVALID_ACTION_NAME: "ANALYTICS_INVALID_ACTION_NAME",
-      VALIDATION_ERROR: "ANALYTICS_VALIDATION_ERROR"
+    ONBOARDING_ERROR_CODES = {
+      NOT_INITIALIZED: "ONBOARDING_NOT_INITIALIZED",
+      INVALID_STEP_NAME: "ONBOARDING_INVALID_STEP_NAME"
     };
   }
 });
 
-// src/domains/analytics/index.ts
-var init_analytics = __esm({
-  "src/domains/analytics/index.ts"() {
-    "use strict";
-    init_AnalyticsError();
-  }
-});
-
-// src/core/events/schemas.ts
-import { z } from "zod";
-var lifecycleEventSchema, identifyEventSchema, paywallEventSchema, transactionEventSchema, onboardingEventSchema, notificationEventSchema, customEventSchema, EVENT_SCHEMAS;
-var init_schemas = __esm({
-  "src/core/events/schemas.ts"() {
-    "use strict";
-    lifecycleEventSchema = z.object({
-      type: z.enum([
-        "install",
-        "cold_start",
-        "foreground",
-        "background",
-        "session_start",
-        "session_end"
-      ]),
-      session_id: z.string().optional(),
-      duration_s: z.number().nonnegative().optional(),
-      first_ever: z.boolean().optional(),
-      // Contexto leve transportado em lifecycle (útil pra cold_start/install)
-      app_version: z.string().optional(),
-      device_type: z.enum(["ios", "android"]).optional(),
-      os_version: z.string().optional(),
-      // Timestamps opcionais — o EventBatcher injeta `timestamp` no envelope
-      started_at: z.string().optional(),
-      ended_at: z.string().optional()
-    }).strict();
-    identifyEventSchema = z.object({
-      distinct_id: z.string().min(1),
-      email: z.email().optional(),
-      traits: z.record(z.string(), z.unknown()).optional(),
-      attribution: z.record(z.string(), z.unknown()).optional(),
-      device: z.record(z.string(), z.unknown()).optional()
-    }).strict();
-    paywallEventSchema = z.object({
-      type: z.enum(["viewed", "closed", "purchased"]),
-      paywall_id: z.string().min(1),
-      placement: z.string().optional(),
-      variant_id: z.string().optional(),
-      variant_key: z.string().optional(),
-      campaign_id: z.string().optional(),
-      // `closed`-specific
-      closed_at: z.string().optional(),
-      duration_s: z.number().nonnegative().optional(),
-      close_reason: z.enum(["dismiss", "cta", "purchase", "error", "timeout"]).optional(),
-      scroll_depth: z.number().min(0).max(1).optional(),
-      // `purchased`-specific (mínimo — transaction canônica leva detalhes)
-      product_id: z.string().optional()
-    }).strict();
-    transactionEventSchema = z.object({
-      type: z.enum([
-        "completed",
-        "failed",
-        "refunded",
-        "renewed",
-        "canceled",
-        "expired"
-      ]),
-      tx_id: z.string().min(1),
-      amount: z.number().optional(),
-      currency: z.string().length(3).optional(),
-      product_id: z.string().optional(),
-      subscription_id: z.string().optional(),
-      paywall_id: z.string().optional(),
-      variant_id: z.string().optional(),
-      reason: z.string().optional()
-    }).strict();
-    onboardingEventSchema = z.object({
-      type: z.enum(["step", "complete", "drop"]),
-      step_index: z.number().int().nonnegative().optional(),
-      step_name: z.string().optional(),
-      variant_key: z.string().optional(),
-      time_on_prev_s: z.number().nonnegative().optional()
-    }).strict();
-    notificationEventSchema = z.object({
-      type: z.enum(["delivered", "displayed", "clicked", "dismissed"]),
-      notification_id: z.string().optional(),
-      campaign_id: z.string().optional(),
-      variant_key: z.string().nullable().optional(),
-      message_id: z.string().optional(),
-      device_id: z.string().optional(),
-      push_platform: z.enum(["ios", "android"]).optional(),
-      timezone: z.string().optional(),
-      failure_reason: z.string().optional(),
-      app_user_id: z.string().optional()
-    }).strict();
-    customEventSchema = z.object({
-      name: z.string().min(1).regex(
-        /^(\$[a-zA-Z0-9_]+|[a-z][a-z0-9_]*)$/,
-        "custom event name must be snake_case or $reserved"
-      ),
-      props: z.record(z.string(), z.unknown()).optional()
-    }).strict();
-    EVENT_SCHEMAS = {
-      lifecycle: lifecycleEventSchema,
-      identify: identifyEventSchema,
-      paywall: paywallEventSchema,
-      transaction: transactionEventSchema,
-      onboarding: onboardingEventSchema,
-      notification: notificationEventSchema,
-      custom: customEventSchema
-    };
-  }
-});
-
-// src/core/events/eventFamilies.ts
-function isDeprecatedEvent(eventName) {
-  return DEPRECATED_EVENT_NAMES.includes(eventName);
-}
-function isCanonicalFamily(name) {
-  return CANONICAL_FAMILIES.includes(name);
-}
-function detectFamily(eventName) {
-  if (isCanonicalFamily(eventName) && eventName !== "custom") {
-    return eventName;
-  }
-  return "custom";
-}
-function validateEvent(eventName, properties) {
-  const family = detectFamily(eventName);
-  const schema = EVENT_SCHEMAS[family];
-  const input = family === "custom" ? { name: eventName, ...properties ? { props: properties } : {} } : properties ?? {};
-  const parsed = schema.safeParse(input);
-  if (parsed.success) {
-    return { ok: true, family, data: parsed.data };
-  }
-  return { ok: false, family, error: parsed.error };
-}
-function formatValidationError(error) {
-  return error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
-}
-var CANONICAL_FAMILIES, DEPRECATED_EVENT_NAMES;
-var init_eventFamilies = __esm({
-  "src/core/events/eventFamilies.ts"() {
-    "use strict";
-    init_schemas();
-    CANONICAL_FAMILIES = [
-      "lifecycle",
-      "identify",
-      "paywall",
-      "transaction",
-      "onboarding",
-      "notification",
-      "custom"
-    ];
-    DEPRECATED_EVENT_NAMES = [
-      "$paywall_purchased",
-      "$paywall_product_selected",
-      "$core_action",
-      "$campaign_impression",
-      "$app_open",
-      "$app_background",
-      "$app_foreground",
-      "session.end"
-    ];
-  }
-});
-
-// src/core/PaywalloAnalytics.ts
-function isValidEventName(name) {
-  if (name.startsWith("$")) return /^\$[a-z][a-z0-9]*(_[a-z0-9]+)*$/.test(name);
-  return /^[a-z][a-z0-9]*(_[a-z0-9]+)*$/.test(name);
-}
-async function trackEvent(apiClient, state, eventName, options) {
-  const distinctId = identityManager.getDistinctId();
-  if (!distinctId) {
-    console.error("[Paywallo:DROP] event dropped \u2014 no distinctId available yet", { eventName });
-    return;
-  }
-  if (!isValidEventName(eventName)) {
-    const msg = `Invalid event name: "${eventName}". Use snake_case or $reserved_name.`;
-    throw new ClientError(CLIENT_ERROR_CODES.INVALID_EVENT_NAME, msg);
-  }
-  if (state.config?.debug && eventName.startsWith("$purchase")) console.log(`[Paywallo TRACK] ${eventName}`, options?.properties ?? {});
-  const sessionId = sessionManager.getSessionId();
-  const family = detectFamily(eventName);
-  const isCustomFamily = family === "custom";
-  const identityProps = isCustomFamily ? identityManager.getProperties() : {};
-  const sessionProp = isCustomFamily && sessionId ? { sessionId } : {};
-  await apiClient.trackEvent(
-    eventName,
-    distinctId,
-    { ...identityProps, ...options?.properties, ...sessionProp },
-    options?.timestamp,
-    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.`;
-    throw new AnalyticsError(ANALYTICS_ERROR_CODES.INVALID_ACTION_NAME, msg);
-  }
-}
-var init_PaywalloAnalytics = __esm({
-  "src/core/PaywalloAnalytics.ts"() {
-    "use strict";
-    init_analytics();
-    init_identity();
-    init_session();
-    init_ClientError();
-    init_eventFamilies();
-  }
-});
-
-// src/core/PaywalloFlags.ts
-async function getVariantCached(apiClient, flagKey, defaultValue) {
-  const distinctId = identityManager.getDistinctId();
-  const result = await apiClient.getVariantFromCache(flagKey, distinctId);
-  if (result) return result;
-  void apiClient.getVariant(flagKey, distinctId).catch(() => {
-  });
-  return { variant: defaultValue ?? null, payload: void 0 };
-}
-async function getVariant(apiClient, state, flagKey) {
-  try {
-    const distinctId = identityManager.getDistinctId();
-    if (!distinctId) {
-      if (state.config?.debug) console.log(`[Paywallo FLAG] ${flagKey} \u2192 null (no distinctId)`);
-      return { variant: null };
-    }
-    const result = await apiClient.getVariant(flagKey, distinctId);
-    if (state.config?.debug) console.log(`[Paywallo FLAG] ${flagKey} \u2192`, result.variant);
-    return result;
-  } catch (error) {
-    if (state.config?.debug) console.log(`[Paywallo FLAG] ${flagKey} \u2192 error`, error);
-    if (state.apiClient) void state.apiClient.reportError("GET_VARIANT_FAILED", error instanceof Error ? error.message : String(error));
-    return { variant: null };
-  }
-}
-function evaluateFlags(apiClient, keys) {
-  return apiClient.evaluateFlags(keys, identityManager.getDistinctId());
-}
-async function getConditionalFlag(apiClient, state, flagKey, context) {
-  try {
-    const distinctId = identityManager.getDistinctId();
-    if (!distinctId) return false;
-    const result = await apiClient.getConditionalFlag(flagKey, { distinctId, ...context });
-    return result.value;
-  } catch (error) {
-    if (state.apiClient) void state.apiClient.reportError("GET_CONDITIONAL_FLAG_FAILED", error instanceof Error ? error.message : String(error));
-    return false;
-  }
-}
-var init_PaywalloFlags = __esm({
-  "src/core/PaywalloFlags.ts"() {
-    "use strict";
-    init_identity();
-  }
-});
-
-// 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"() {
+// src/domains/onboarding/OnboardingManager.ts
+var OnboardingManager, onboardingManager;
+var init_OnboardingManager = __esm({
+  "src/domains/onboarding/OnboardingManager.ts"() {
     "use strict";
     init_OnboardingError();
     OnboardingManager = class {
@@ -6713,15 +6457,20 @@ var init_OnboardingManager = __esm({
        * 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) {
+      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",
-          ...{ step_name: stepName }
+          ...stepPayload
         };
         return this.emit("onboarding", payload, "step");
       }
@@ -6792,12 +6541,290 @@ var init_OnboardingManager = __esm({
   }
 });
 
-// src/domains/onboarding/index.ts
-var init_onboarding = __esm({
-  "src/domains/onboarding/index.ts"() {
+// src/domains/onboarding/index.ts
+var init_onboarding = __esm({
+  "src/domains/onboarding/index.ts"() {
+    "use strict";
+    init_OnboardingError();
+    init_OnboardingManager();
+  }
+});
+
+// src/domains/analytics/AnalyticsError.ts
+var AnalyticsError, ANALYTICS_ERROR_CODES;
+var init_AnalyticsError = __esm({
+  "src/domains/analytics/AnalyticsError.ts"() {
+    "use strict";
+    init_PaywalloError();
+    AnalyticsError = class extends PaywalloError {
+      constructor(code, message) {
+        super("analytics", code, message);
+        this.name = "AnalyticsError";
+      }
+    };
+    ANALYTICS_ERROR_CODES = {
+      NOT_INITIALIZED: "ANALYTICS_NOT_INITIALIZED",
+      INVALID_STEP_INDEX: "ANALYTICS_INVALID_STEP_INDEX",
+      INVALID_ACTION_NAME: "ANALYTICS_INVALID_ACTION_NAME",
+      VALIDATION_ERROR: "ANALYTICS_VALIDATION_ERROR"
+    };
+  }
+});
+
+// src/domains/analytics/index.ts
+var init_analytics = __esm({
+  "src/domains/analytics/index.ts"() {
+    "use strict";
+    init_AnalyticsError();
+  }
+});
+
+// src/core/events/schemas.ts
+import { z } from "zod";
+var lifecycleEventSchema, identifyEventSchema, paywallEventSchema, transactionEventSchema, onboardingEventSchema, notificationEventSchema, customEventSchema, EVENT_SCHEMAS;
+var init_schemas = __esm({
+  "src/core/events/schemas.ts"() {
+    "use strict";
+    lifecycleEventSchema = z.object({
+      type: z.enum([
+        "install",
+        "cold_start",
+        "foreground",
+        "background",
+        "session_start",
+        "session_end"
+      ]),
+      session_id: z.string().optional(),
+      duration_s: z.number().nonnegative().optional(),
+      first_ever: z.boolean().optional(),
+      // Contexto leve transportado em lifecycle (útil pra cold_start/install)
+      app_version: z.string().optional(),
+      device_type: z.enum(["ios", "android"]).optional(),
+      os_version: z.string().optional(),
+      // Timestamps opcionais — o EventBatcher injeta `timestamp` no envelope
+      started_at: z.string().optional(),
+      ended_at: z.string().optional()
+    }).strict();
+    identifyEventSchema = z.object({
+      distinct_id: z.string().min(1),
+      email: z.email().optional(),
+      traits: z.record(z.string(), z.unknown()).optional(),
+      attribution: z.record(z.string(), z.unknown()).optional(),
+      device: z.record(z.string(), z.unknown()).optional()
+    }).strict();
+    paywallEventSchema = z.object({
+      type: z.enum(["viewed", "closed", "purchased"]),
+      paywall_id: z.string().min(1),
+      placement: z.string().optional(),
+      variant_id: z.string().optional(),
+      variant_key: z.string().optional(),
+      campaign_id: z.string().optional(),
+      // `closed`-specific
+      closed_at: z.string().optional(),
+      duration_s: z.number().nonnegative().optional(),
+      close_reason: z.enum(["dismiss", "cta", "purchase", "error", "timeout"]).optional(),
+      scroll_depth: z.number().min(0).max(1).optional(),
+      // `purchased`-specific (mínimo — transaction canônica leva detalhes)
+      product_id: z.string().optional()
+    }).strict();
+    transactionEventSchema = z.object({
+      type: z.enum([
+        "completed",
+        "failed",
+        "refunded",
+        "renewed",
+        "canceled",
+        "expired"
+      ]),
+      tx_id: z.string().min(1),
+      amount: z.number().optional(),
+      currency: z.string().length(3).optional(),
+      product_id: z.string().optional(),
+      subscription_id: z.string().optional(),
+      paywall_id: z.string().optional(),
+      variant_id: z.string().optional(),
+      reason: z.string().optional()
+    }).strict();
+    onboardingEventSchema = z.object({
+      type: z.enum(["step", "complete", "drop"]),
+      step_index: z.number().int().nonnegative().optional(),
+      step_name: z.string().optional(),
+      variant_key: z.string().optional(),
+      time_on_prev_s: z.number().nonnegative().optional()
+    }).strict();
+    notificationEventSchema = z.object({
+      type: z.enum(["delivered", "displayed", "clicked", "dismissed"]),
+      notification_id: z.string().optional(),
+      campaign_id: z.string().optional(),
+      variant_key: z.string().nullable().optional(),
+      message_id: z.string().optional(),
+      device_id: z.string().optional(),
+      push_platform: z.enum(["ios", "android"]).optional(),
+      timezone: z.string().optional(),
+      failure_reason: z.string().optional(),
+      app_user_id: z.string().optional()
+    }).strict();
+    customEventSchema = z.object({
+      name: z.string().min(1).regex(
+        /^(\$[a-zA-Z0-9_]+|[a-z][a-z0-9_]*)$/,
+        "custom event name must be snake_case or $reserved"
+      ),
+      props: z.record(z.string(), z.unknown()).optional()
+    }).strict();
+    EVENT_SCHEMAS = {
+      lifecycle: lifecycleEventSchema,
+      identify: identifyEventSchema,
+      paywall: paywallEventSchema,
+      transaction: transactionEventSchema,
+      onboarding: onboardingEventSchema,
+      notification: notificationEventSchema,
+      custom: customEventSchema
+    };
+  }
+});
+
+// src/core/events/eventFamilies.ts
+function isDeprecatedEvent(eventName) {
+  return DEPRECATED_EVENT_NAMES.includes(eventName);
+}
+function isCanonicalFamily(name) {
+  return CANONICAL_FAMILIES.includes(name);
+}
+function detectFamily(eventName) {
+  if (isCanonicalFamily(eventName) && eventName !== "custom") {
+    return eventName;
+  }
+  return "custom";
+}
+function validateEvent(eventName, properties) {
+  const family = detectFamily(eventName);
+  const schema = EVENT_SCHEMAS[family];
+  const input = family === "custom" ? { name: eventName, ...properties ? { props: properties } : {} } : properties ?? {};
+  const parsed = schema.safeParse(input);
+  if (parsed.success) {
+    return { ok: true, family, data: parsed.data };
+  }
+  return { ok: false, family, error: parsed.error };
+}
+function formatValidationError(error) {
+  return error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+}
+var CANONICAL_FAMILIES, DEPRECATED_EVENT_NAMES;
+var init_eventFamilies = __esm({
+  "src/core/events/eventFamilies.ts"() {
+    "use strict";
+    init_schemas();
+    CANONICAL_FAMILIES = [
+      "lifecycle",
+      "identify",
+      "paywall",
+      "transaction",
+      "onboarding",
+      "notification",
+      "custom"
+    ];
+    DEPRECATED_EVENT_NAMES = [
+      "$paywall_purchased",
+      "$paywall_product_selected",
+      "$core_action",
+      "$campaign_impression",
+      "$app_open",
+      "$app_background",
+      "$app_foreground",
+      "session.end"
+    ];
+  }
+});
+
+// src/core/PaywalloAnalytics.ts
+function isValidEventName(name) {
+  if (name.startsWith("$")) return /^\$[a-z][a-z0-9]*(_[a-z0-9]+)*$/.test(name);
+  return /^[a-z][a-z0-9]*(_[a-z0-9]+)*$/.test(name);
+}
+async function trackEvent(apiClient, state, eventName, options) {
+  const distinctId = identityManager.getDistinctId();
+  if (!distinctId) {
+    console.error("[Paywallo:DROP] event dropped \u2014 no distinctId available yet", { eventName });
+    return;
+  }
+  if (!isValidEventName(eventName)) {
+    const msg = `Invalid event name: "${eventName}". Use snake_case or $reserved_name.`;
+    throw new ClientError(CLIENT_ERROR_CODES.INVALID_EVENT_NAME, msg);
+  }
+  if (state.config?.debug && eventName.startsWith("$purchase")) console.log(`[Paywallo TRACK] ${eventName}`, options?.properties ?? {});
+  const sessionId = sessionManager.getSessionId();
+  const family = detectFamily(eventName);
+  const isCustomFamily = family === "custom";
+  const identityProps = isCustomFamily ? identityManager.getProperties() : {};
+  const sessionProp = isCustomFamily && sessionId ? { sessionId } : {};
+  await apiClient.trackEvent(
+    eventName,
+    distinctId,
+    { ...identityProps, ...options?.properties, ...sessionProp },
+    options?.timestamp,
+    options?.priority ? { priority: options.priority } : void 0
+  );
+}
+function validateCoreAction(actionName) {
+  if (!actionName || typeof actionName !== "string") {
+    const msg = `Invalid actionName: "${actionName}". Must be a non-empty string.`;
+    throw new AnalyticsError(ANALYTICS_ERROR_CODES.INVALID_ACTION_NAME, msg);
+  }
+}
+var init_PaywalloAnalytics = __esm({
+  "src/core/PaywalloAnalytics.ts"() {
     "use strict";
-    init_OnboardingError();
-    init_OnboardingManager();
+    init_analytics();
+    init_identity();
+    init_session();
+    init_ClientError();
+    init_eventFamilies();
+  }
+});
+
+// src/core/PaywalloFlags.ts
+async function getVariantCached(apiClient, flagKey, defaultValue) {
+  const distinctId = identityManager.getDistinctId();
+  const result = await apiClient.getVariantFromCache(flagKey, distinctId);
+  if (result) return result;
+  void apiClient.getVariant(flagKey, distinctId).catch(() => {
+  });
+  return { variant: defaultValue ?? null, payload: void 0 };
+}
+async function getVariant(apiClient, state, flagKey) {
+  try {
+    const distinctId = identityManager.getDistinctId();
+    if (!distinctId) {
+      if (state.config?.debug) console.log(`[Paywallo FLAG] ${flagKey} \u2192 null (no distinctId)`);
+      return { variant: null };
+    }
+    const result = await apiClient.getVariant(flagKey, distinctId);
+    if (state.config?.debug) console.log(`[Paywallo FLAG] ${flagKey} \u2192`, result.variant);
+    return result;
+  } catch (error) {
+    if (state.config?.debug) console.log(`[Paywallo FLAG] ${flagKey} \u2192 error`, error);
+    if (state.apiClient) void state.apiClient.reportError("GET_VARIANT_FAILED", error instanceof Error ? error.message : String(error));
+    return { variant: null };
+  }
+}
+function evaluateFlags(apiClient, keys) {
+  return apiClient.evaluateFlags(keys, identityManager.getDistinctId());
+}
+async function getConditionalFlag(apiClient, state, flagKey, context) {
+  try {
+    const distinctId = identityManager.getDistinctId();
+    if (!distinctId) return false;
+    const result = await apiClient.getConditionalFlag(flagKey, { distinctId, ...context });
+    return result.value;
+  } catch (error) {
+    if (state.apiClient) void state.apiClient.reportError("GET_CONDITIONAL_FLAG_FAILED", error instanceof Error ? error.message : String(error));
+    return false;
+  }
+}
+var init_PaywalloFlags = __esm({
+  "src/core/PaywalloFlags.ts"() {
+    "use strict";
+    init_identity();
   }
 });
 
@@ -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()
         };
@@ -7813,8 +7899,8 @@ var init_HttpClient = __esm({
             if (this.shouldRetry(response.status, retryConfig)) {
               if (state.attempt < retryConfig.maxRetries) {
                 state.attempt++;
-                const delay = this.calculateDelayForResponse(state.attempt, response.headers, retryConfig);
-                await this.sleep(delay);
+                const delay2 = this.calculateDelayForResponse(state.attempt, response.headers, retryConfig);
+                await this.sleep(delay2);
                 continue;
               }
             }
@@ -7823,8 +7909,8 @@ var init_HttpClient = __esm({
             state.lastError = error instanceof Error ? error : new ClientError(CLIENT_ERROR_CODES.UNKNOWN, String(error));
             if (this.isNetworkError(state.lastError) && state.attempt < retryConfig.maxRetries) {
               state.attempt++;
-              const delay = this.calculateDelay(state.attempt, retryConfig);
-              await this.sleep(delay);
+              const delay2 = this.calculateDelay(state.attempt, retryConfig);
+              await this.sleep(delay2);
               continue;
             }
             throw state.lastError;
@@ -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) {
@@ -8476,8 +8532,8 @@ async function initWithRetry(state, config) {
     } catch (error) {
       state.initAttempts++;
       if (state.initAttempts > MAX_INIT_RETRIES) throw error;
-      const delay = RETRY_DELAYS[state.initAttempts - 1] ?? 1e4;
-      await new Promise((resolve) => setTimeout(resolve, delay));
+      const delay2 = RETRY_DELAYS[state.initAttempts - 1] ?? 1e4;
+      await new Promise((resolve) => setTimeout(resolve, delay2));
     }
   }
 }
@@ -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();
@@ -9754,12 +9848,17 @@ init_paywall();
 
 // src/domains/paywall/SuperwallAttributeBridge.ts
 init_identity();
+var CONFIG_POLL_INTERVAL_MS = 250;
+var CONFIG_POLL_MAX_ATTEMPTS = 40;
 var lastSignature = null;
 function log(debug, msg, data) {
   if (!debug) return;
   if (data !== void 0) console.log(`[Paywallo:SuperwallAttr] ${msg}`, data);
   else console.log(`[Paywallo:SuperwallAttr] ${msg}`);
 }
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
 var PAID_MEDIUM = /cpc|ppc|cpm|cpa|paid|display/i;
 function deriveIsPaid(a) {
   if (a.fbclid || a.gclid || a.ttclid || a.tiktokCampaignId) return true;
@@ -9798,24 +9897,38 @@ function buildSuperwallAttributes(a) {
   out.pw_attributed_at = a.capturedAt;
   return out;
 }
-function pickShared(mod) {
-  const shared = mod?.default?.shared ?? mod?.shared;
-  return shared && typeof shared.setUserAttributes === "function" ? shared : null;
+function pickNative(mod) {
+  const native = mod?.SuperwallExpoModule ?? mod?.default?.SuperwallExpoModule;
+  return native && typeof native.setUserAttributes === "function" && typeof native.getConfigurationStatus === "function" ? native : null;
 }
-async function resolveSuperwallShared(debug) {
+async function resolveSuperwallNativeModule(debug) {
   try {
-    const shared = pickShared(await import("expo-superwall/compat"));
-    if (shared) return shared;
+    const native = pickNative(await import("expo-superwall"));
+    if (native) return native;
   } catch {
   }
-  try {
-    const shared = pickShared(await import("expo-superwall"));
-    if (shared) return shared;
-  } catch {
-  }
-  log(debug, "expo-superwall not available \u2014 attribute push skipped");
+  log(debug, "expo-superwall native module not available \u2014 attribute push skipped");
   return null;
 }
+async function waitForConfigured(mod, debug) {
+  for (let attempt = 0; attempt < CONFIG_POLL_MAX_ATTEMPTS; attempt++) {
+    let status;
+    try {
+      status = String(await mod.getConfigurationStatus());
+    } catch (err) {
+      log(debug, "getConfigurationStatus error", { err: String(err) });
+      return false;
+    }
+    if (status === "CONFIGURED") return true;
+    if (status === "FAILED") {
+      log(debug, "Superwall configuration FAILED \u2014 skipping attribute push");
+      return false;
+    }
+    await delay(CONFIG_POLL_INTERVAL_MS);
+  }
+  log(debug, "Superwall not configured within timeout \u2014 skipping attribute push");
+  return false;
+}
 async function pushAttributionToSuperwall(debug = false) {
   const attrs = buildSuperwallAttributes(attributionTracker.get());
   const signature = JSON.stringify(attrs);
@@ -9823,10 +9936,11 @@ async function pushAttributionToSuperwall(debug = false) {
     log(debug, "attributes unchanged \u2014 skipping push");
     return;
   }
-  const shared = await resolveSuperwallShared(debug);
-  if (!shared) return;
+  const native = await resolveSuperwallNativeModule(debug);
+  if (!native) return;
+  if (!await waitForConfigured(native, debug)) return;
   try {
-    await shared.setUserAttributes(attrs);
+    await native.setUserAttributes(attrs);
     lastSignature = signature;
     log(debug, "attributes pushed to Superwall", attrs);
   } catch (err) {
@@ -9942,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) {
@@ -10029,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() {
@@ -10055,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;
@@ -10066,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");
@@ -10084,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);
@@ -10098,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();
@@ -10168,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);
@@ -10246,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();
@@ -10268,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) {
@@ -10310,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;
@@ -10335,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();
@@ -10444,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;
@@ -10464,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;
@@ -10484,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;
@@ -10516,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]);
@@ -10548,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();
@@ -10577,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);
@@ -10585,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;
@@ -10606,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,
@@ -10636,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();
@@ -10650,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)) {
@@ -10724,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();
@@ -10733,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}`);
     }
@@ -10795,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(),
@@ -11050,6 +11131,7 @@ export {
   createPurchaseError,
   index_default as default,
   detectDeviceLanguage,
+  getActiveRouteName,
   getCurrentLanguage,
   getDefaultLanguage,
   getIAPService,
@@ -11078,6 +11160,7 @@ export {
   useOnboarding,
   usePaywallContext,
   usePaywallo,
+  usePaywalloScreenTracking,
   usePlanPurchase,
   usePlans,
   useProducts,