@virex-tech/paywallo-sdk 2.4.0 → 2.5.0

package/dist/index.js

@@ -262,77 +262,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
+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 = import_react_native2.NativeModules.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 = import_react_native2.Platform.OS === "android" ? Application.getAndroidId() ?? "unknown" : "unknown";
+  return {
+    deviceId: import_react_native2.Platform.OS === "ios" ? idfv ?? "unknown" : androidId,
+    model: Device.modelName ?? "unknown",
+    modelId: Device.modelId ?? Device.modelName ?? "unknown",
+    osName: Device.osName ?? import_react_native2.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 = import_react_native2.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 import_react_native2.NativeModules.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 import_react_native2, FALLBACK, _debug2, warnedOnce, cachedDeviceInfo, nativeDeviceInfo;
+var import_react_native2, Device, Application, Localization, _debug2, cachedDeviceInfo, nativeDeviceInfo;
 var init_NativeDeviceInfo = __esm({
   "src/utils/NativeDeviceInfo.ts"() {
     "use strict";
     import_react_native2 = require("react-native");
-    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
-    };
+    Device = __toESM(require("expo-device"));
+    Application = __toESM(require("expo-application"));
+    Localization = __toESM(require("expo-localization"));
+    init_ClientError();
     _debug2 = false;
-    warnedOnce = false;
     cachedDeviceInfo = null;
     nativeDeviceInfo = {
       getDeviceInfo,
@@ -347,6 +372,7 @@ var init_NativeDeviceInfo = __esm({
 // src/utils/uuid.ts
 var uuid_exports = {};
 __export(uuid_exports, {
+  deterministicUUID: () => deterministicUUID,
   generateUUID: () => generateUUID,
   isValidUUIDv4: () => isValidUUIDv4
 });
@@ -358,6 +384,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);
@@ -625,6 +673,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;
       }
@@ -1028,10 +1080,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({
@@ -1426,6 +1476,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;
@@ -1446,6 +1502,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",
@@ -1470,18 +1527,180 @@ var init_InstallIdempotency = __esm({
   }
 });
 
+// src/domains/identity/MetaBridge.ts
+var import_react_native5, TIMEOUT_MS, NativeBridge, MetaBridge, metaBridge;
+var init_MetaBridge = __esm({
+  "src/domains/identity/MetaBridge.ts"() {
+    "use strict";
+    import_react_native5 = require("react-native");
+    TIMEOUT_MS = 2e3;
+    NativeBridge = import_react_native5.NativeModules.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
-var import_react_native5, REFERRER_TIMEOUT_MS, InstallReferrerManager, installReferrerManager;
+var import_react_native6, REFERRER_TIMEOUT_MS, InstallReferrerManager, installReferrerManager;
 var init_InstallReferrerManager = __esm({
   "src/domains/identity/InstallReferrerManager.ts"() {
     "use strict";
-    import_react_native5 = require("react-native");
+    import_react_native6 = require("react-native");
     init_NativeDeviceInfo();
+    init_MetaBridge();
+    init_deferredAppLink();
     REFERRER_TIMEOUT_MS = 5e3;
     InstallReferrerManager = class {
       async getReferrer() {
-        if (import_react_native5.Platform.OS !== "android") {
-          return this.emptyResult();
+        if (import_react_native6.Platform.OS !== "android") {
+          return this.fetchDeferredReferrer();
         }
         let timerId;
         const timeoutPromise = new Promise((resolve) => {
@@ -1492,6 +1711,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();
@@ -1552,79 +1794,6 @@ var init_InstallReferrerManager = __esm({
   }
 });
 
-// src/domains/identity/MetaBridge.ts
-var import_react_native6, TIMEOUT_MS, NativeBridge, MetaBridge, metaBridge;
-var init_MetaBridge = __esm({
-  "src/domains/identity/MetaBridge.ts"() {
-    "use strict";
-    import_react_native6 = require("react-native");
-    TIMEOUT_MS = 2e3;
-    NativeBridge = import_react_native6.NativeModules.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
 var import_react_native7, InstallTracker;
 var init_InstallTracker = __esm({
@@ -1694,44 +1863,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;
+          let brand2 = "unknown";
           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;
-          try {
-            if (import_react_native7.Platform.OS === "android") {
-              installerPackage = info.installerPackage ?? null;
-            }
+            brand2 = info.brand ?? "unknown";
           } catch {
           }
           deviceData = {
             deviceModel,
-            osVersion,
+            osVersion: osVersion2,
             appVersion,
             buildNumber,
             ...screenWidth > 0 && { screenWidth },
@@ -1739,21 +1881,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 },
@@ -1834,6 +1975,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()
             }),
@@ -2089,7 +2231,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";
   }
 });
@@ -2421,8 +2563,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 {
   }
@@ -2464,8 +2606,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";
@@ -3768,292 +3910,17 @@ 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
-});
-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: import_react_native16.Platform.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 import_react_native16, TRANSACTION_UPDATE_EVENT, PaywalloStoreKitNative, nativeStoreKit, NativeStoreKit;
-var init_NativeStoreKit = __esm({
-  "src/domains/iap/NativeStoreKit.ts"() {
-    "use strict";
-    import_react_native16 = require("react-native");
-    init_PaywalloClient();
-    init_uuid();
-    init_IdentityManager();
-    init_PurchaseError();
-    TRANSACTION_UPDATE_EVENT = "PaywalloTransactionUpdate";
-    PaywalloStoreKitNative = import_react_native16.NativeModules.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 = import_react_native16.NativeEventEmitter;
-          const emitter = new EmitterCtor(PaywalloStoreKitNative);
-          const sub = emitter.addListener(TRANSACTION_UPDATE_EVENT, (payload) => {
-            const update = normalizeTransactionUpdate(payload);
-            if (update) listener(update);
-          });
-          return { remove: () => sub.remove() };
-        } catch (err) {
-          if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] subscribeToTransactionUpdates failed", err);
-          return null;
-        }
-      }
-    };
-    NativeStoreKit = nativeStoreKit;
-  }
-});
-
 // src/domains/iap/IAPTransactionEmitter.ts
 var IAPTransactionEmitter;
 var init_IAPTransactionEmitter = __esm({
   "src/domains/iap/IAPTransactionEmitter.ts"() {
     "use strict";
     init_PaywalloClient();
-    init_NativeStoreKit();
     IAPTransactionEmitter = class {
       constructor(getProductFromCache, getApiClientFn, getDebug) {
         this.getProductFromCache = getProductFromCache;
         this.getApiClientFn = getApiClientFn;
         this.getDebug = getDebug;
-        this.transactionUpdateSubscription = null;
-      }
-      /**
-       * Emits `transaction {type: "completed"}` after a server-validated purchase.
-       * Fire-and-forget — a tracking failure must never poison the purchase flow.
-       */
-      async emitTransactionCompleted(purchase, productId, options) {
-        try {
-          const apiClient = this.getApiClientFn();
-          if (!apiClient) return;
-          const distinctId = PaywalloClient.getDistinctId();
-          if (!distinctId) return;
-          const product = this.getProductFromCache(productId);
-          const properties = {
-            type: "completed",
-            tx_id: purchase.transactionId,
-            product_id: purchase.productId
-          };
-          if (product?.priceValue !== void 0 && product.priceValue > 0) {
-            properties.amount = product.priceValue;
-          }
-          if (product?.currency) {
-            properties.currency = product.currency;
-          }
-          if (options?.paywallId) properties.paywall_id = options.paywallId;
-          if (options?.variantId) properties.variant_id = options.variantId;
-          await apiClient.trackEvent("transaction", distinctId, properties, void 0, { priority: "critical" });
-        } catch (err) {
-          if (this.getDebug()) console.log("[Paywallo PURCHASE] transaction event emission failed", err);
-        }
       }
       /**
        * Emits `checkout_started` quando o usuário inicia a compra (toca em comprar),
@@ -4075,96 +3942,23 @@ var init_IAPTransactionEmitter = __esm({
           };
           await apiClient.trackEvent("checkout_started", distinctId, properties, void 0, {
             priority: "critical"
-          });
-          if (this.getDebug()) console.log("[Paywallo PURCHASE] emitted checkout_started", productId);
-        } catch (err) {
-          if (this.getDebug()) console.log("[Paywallo PURCHASE] checkout_started emission failed", err);
-        }
-      }
-      /**
-       * 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.
-       */
-      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.
-       */
-      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";
+          });
+          if (this.getDebug()) console.log("[Paywallo PURCHASE] emitted checkout_started", productId);
+        } catch (err) {
+          if (this.getDebug()) console.log("[Paywallo PURCHASE] checkout_started emission failed", err);
+        }
+      }
+      /**
+       * No-op. Native transaction update listener removed — sale events are sourced
+       * exclusively from server-side webhooks (Apple/Google/Superwall/RevenueCat).
+       */
+      startListener() {
+      }
+      /**
+       * No-op. See startListener.
+       */
+      stopListener() {
       }
-    };
-    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"
     };
   }
 });
@@ -4536,11 +4330,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;
       }
@@ -4651,11 +4445,11 @@ var init_types2 = __esm({
 });
 
 // src/core/network/NetworkMonitor.ts
-var import_react_native17, NetworkMonitorClass, networkMonitor;
+var import_react_native16, NetworkMonitorClass, networkMonitor;
 var init_NetworkMonitor = __esm({
   "src/core/network/NetworkMonitor.ts"() {
     "use strict";
-    import_react_native17 = require("react-native");
+    import_react_native16 = require("react-native");
     init_types2();
     NetworkMonitorClass = class {
       constructor() {
@@ -4684,7 +4478,7 @@ var init_NetworkMonitor = __esm({
         }, this.config.checkInterval);
       }
       setupAppStateListener() {
-        this.appStateSubscription = import_react_native17.AppState.addEventListener("change", (state) => {
+        this.appStateSubscription = import_react_native16.AppState.addEventListener("change", (state) => {
           if (state === "active") {
             if (!this.checkIntervalId) {
               this.checkIntervalId = setInterval(() => {
@@ -5052,12 +4846,62 @@ 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
-var import_react_native18, IAPValidator;
+var import_react_native17, IAPValidator;
 var init_IAPValidator = __esm({
   "src/domains/iap/IAPValidator.ts"() {
     "use strict";
-    import_react_native18 = require("react-native");
+    import_react_native17 = require("react-native");
     init_PaywalloClient();
     init_queue();
     init_PurchaseError();
@@ -5078,75 +4922,269 @@ var init_IAPValidator = __esm({
             if (i < maxRetries) await new Promise((resolve) => setTimeout(resolve, delayMs));
           }
         }
-        throw lastError;
-      }
-      async validateWithServer(purchase, productId, options) {
-        const apiClient = this.getApiClientFn();
-        const product = this.getProductFromCache(productId);
-        const platform = import_react_native18.Platform.OS;
-        const distinctId = PaywalloClient.getDistinctId();
-        return this.validateWithRetry(
-          () => apiClient.validatePurchase(
-            platform,
-            purchase.receipt,
-            purchase.productId,
-            purchase.transactionId,
-            product?.priceValue ?? 0,
-            product?.currency ?? "USD",
-            this.getDeviceCountry(),
-            distinctId,
-            options?.paywallPlacement,
-            options?.variantKey
-          )
-        );
-      }
-      /**
-       * Bucketizes a validation failure into `server4xx` (permanent) vs `network` (transient).
-       */
-      classifyValidationError(error) {
-        if (error instanceof PurchaseError && typeof error.httpStatus === "number") {
-          const status = error.httpStatus;
-          if (status >= 400 && status < 500) return "server4xx";
+        throw lastError;
+      }
+      async validateWithServer(purchase, productId, options) {
+        const apiClient = this.getApiClientFn();
+        const product = this.getProductFromCache(productId);
+        const platform = import_react_native17.Platform.OS;
+        const distinctId = PaywalloClient.getDistinctId();
+        return this.validateWithRetry(
+          () => apiClient.validatePurchase(
+            platform,
+            purchase.receipt,
+            purchase.productId,
+            purchase.transactionId,
+            product?.priceValue ?? 0,
+            product?.currency ?? "USD",
+            this.getDeviceCountry(),
+            distinctId,
+            options?.paywallPlacement,
+            options?.variantKey
+          )
+        );
+      }
+      /**
+       * Bucketizes a validation failure into `server4xx` (permanent) vs `network` (transient).
+       */
+      classifyValidationError(error) {
+        if (error instanceof PurchaseError && typeof error.httpStatus === "number") {
+          const status = error.httpStatus;
+          if (status >= 400 && status < 500) return "server4xx";
+        }
+        return "network";
+      }
+      /**
+       * Pushes the validation payload into the offline queue for durable retry.
+       * The StoreKit transaction is intentionally left un-finished.
+       */
+      async enqueueValidationRetry(purchase, productId, options) {
+        try {
+          const apiClient = this.getApiClientFn();
+          const product = this.getProductFromCache(productId);
+          const platform = import_react_native17.Platform.OS;
+          const distinctId = PaywalloClient.getDistinctId();
+          const appKey = apiClient.getAppKey();
+          const body = {
+            platform,
+            receipt_data: purchase.receipt,
+            product_id: purchase.productId,
+            transaction_id: purchase.transactionId,
+            price_local: product?.priceValue ?? 0,
+            currency: product?.currency ?? "USD",
+            country: this.getDeviceCountry(),
+            distinct_id: distinctId
+          };
+          if (options?.paywallPlacement !== void 0) body.paywall_placement = options.paywallPlacement;
+          if (options?.variantKey !== void 0) body.variant_key = options.variantKey;
+          await offlineQueue.enqueue(
+            "POST",
+            "/sdk/purchases/validate",
+            body,
+            { "X-App-Key": appKey },
+            `validate:${purchase.transactionId}`,
+            "critical"
+          );
+          if (this.getDebug()) console.log("[Paywallo PURCHASE] validation retry enqueued", purchase.transactionId);
+        } catch (err) {
+          console.error("[Paywallo PURCHASE] failed to enqueue validation retry", err);
+        }
+      }
+    };
+  }
+});
+
+// src/domains/iap/NativeStoreKit.ts
+var NativeStoreKit_exports = {};
+__export(NativeStoreKit_exports, {
+  NativeStoreKit: () => NativeStoreKit,
+  nativeStoreKit: () => nativeStoreKit
+});
+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: import_react_native18.Platform.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 import_react_native18, TRANSACTION_UPDATE_EVENT, PaywalloStoreKitNative, nativeStoreKit, NativeStoreKit;
+var init_NativeStoreKit = __esm({
+  "src/domains/iap/NativeStoreKit.ts"() {
+    "use strict";
+    import_react_native18 = require("react-native");
+    init_PaywalloClient();
+    init_uuid();
+    init_IdentityManager();
+    init_PurchaseError();
+    TRANSACTION_UPDATE_EVENT = "PaywalloTransactionUpdate";
+    PaywalloStoreKitNative = import_react_native18.NativeModules.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);
         }
-        return "network";
-      }
+      },
+      async getActiveTransactions() {
+        if (!PaywalloStoreKitNative) return [];
+        try {
+          const results = await PaywalloStoreKitNative.getActiveTransactions();
+          return results.map(mapNativePurchase);
+        } catch (err) {
+          console.error("[Paywallo] getActiveTransactions failed", err);
+          return [];
+        }
+      },
       /**
-       * Pushes the validation payload into the offline queue for durable retry.
-       * The StoreKit transaction is intentionally left un-finished.
+       * 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.
        */
-      async enqueueValidationRetry(purchase, productId, options) {
+      subscribeToTransactionUpdates(listener) {
+        if (!PaywalloStoreKitNative) return null;
         try {
-          const apiClient = this.getApiClientFn();
-          const product = this.getProductFromCache(productId);
-          const platform = import_react_native18.Platform.OS;
-          const distinctId = PaywalloClient.getDistinctId();
-          const appKey = apiClient.getAppKey();
-          const body = {
-            platform,
-            receipt_data: purchase.receipt,
-            product_id: purchase.productId,
-            transaction_id: purchase.transactionId,
-            price_local: product?.priceValue ?? 0,
-            currency: product?.currency ?? "USD",
-            country: this.getDeviceCountry(),
-            distinct_id: distinctId
-          };
-          if (options?.paywallPlacement !== void 0) body.paywall_placement = options.paywallPlacement;
-          if (options?.variantKey !== void 0) body.variant_key = options.variantKey;
-          await offlineQueue.enqueue(
-            "POST",
-            "/sdk/purchases/validate",
-            body,
-            { "X-App-Key": appKey },
-            `validate:${purchase.transactionId}`,
-            "critical"
-          );
-          if (this.getDebug()) console.log("[Paywallo PURCHASE] validation retry enqueued", purchase.transactionId);
+          const EmitterCtor = import_react_native18.NativeEventEmitter;
+          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) {
-          console.error("[Paywallo PURCHASE] failed to enqueue validation retry", err);
+          if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] subscribeToTransactionUpdates failed", err);
+          return null;
         }
       }
     };
+    NativeStoreKit = nativeStoreKit;
   }
 });
 
@@ -5250,8 +5288,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()) {
@@ -5280,10 +5318,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") {
@@ -6370,12 +6404,149 @@ var init_plan = __esm({
   }
 });
 
-// src/domains/session/index.ts
-var init_session = __esm({
-  "src/domains/session/index.ts"() {
+// src/domains/session/index.ts
+var init_session = __esm({
+  "src/domains/session/index.ts"() {
+    "use strict";
+    init_SessionError();
+    init_SessionManager();
+  }
+});
+
+// src/domains/onboarding/OnboardingError.ts
+var OnboardingError, ONBOARDING_ERROR_CODES;
+var init_OnboardingError = __esm({
+  "src/domains/onboarding/OnboardingError.ts"() {
+    "use strict";
+    init_PaywalloError();
+    OnboardingError = class extends PaywalloError {
+      constructor(code, message) {
+        super("onboarding", code, message);
+        this.name = "OnboardingError";
+      }
+    };
+    ONBOARDING_ERROR_CODES = {
+      NOT_INITIALIZED: "ONBOARDING_NOT_INITIALIZED",
+      INVALID_STEP_NAME: "ONBOARDING_INVALID_STEP_NAME"
+    };
+  }
+});
+
+// src/domains/onboarding/OnboardingManager.ts
+var OnboardingManager, onboardingManager;
+var init_OnboardingManager = __esm({
+  "src/domains/onboarding/OnboardingManager.ts"() {
+    "use strict";
+    init_OnboardingError();
+    OnboardingManager = class {
+      constructor() {
+        this.pipeline = null;
+        this.debug = false;
+        this.lastStep = null;
+        this.finished = false;
+      }
+      /**
+       * Injects runtime dependencies. Called by PaywalloClient during init.
+       */
+      injectDeps(config) {
+        this.pipeline = config.pipeline;
+        this.debug = config.debug ?? false;
+      }
+      /**
+       * Tracks an onboarding step view.
+       * Saves the step name internally for implicit drop detection on the backend.
+       *
+       * @param stepName - Unique name for this onboarding step.
+       * @param order - Optional explicit display order (accepts decimals, e.g. 2.1 for A/B variants).
+       */
+      async step(stepName, order) {
+        this.assertConfig();
+        this.validateStepName(stepName, "step");
+        this.lastStep = stepName;
+        const stepPayload = { step_name: stepName };
+        if (order !== void 0 && Number.isFinite(order) && order >= 0) {
+          stepPayload.order = order;
+        }
+        const payload = {
+          family: "onboarding",
+          type: "step",
+          ...stepPayload
+        };
+        return this.emit("onboarding", payload, "step");
+      }
+      /**
+       * Tracks successful completion of the onboarding flow.
+       * Marks the flow as finished.
+       */
+      async complete() {
+        this.assertConfig();
+        this.finished = true;
+        return this.emit("onboarding", { family: "onboarding", type: "complete" }, "complete");
+      }
+      /**
+       * Tracks an explicit drop (abandonment) at the given step.
+       * Marks the flow as finished.
+       *
+       * @param stepName - The step name where the user dropped off.
+       */
+      async drop(stepName) {
+        this.assertConfig();
+        this.validateStepName(stepName, "drop");
+        this.finished = true;
+        const payload = {
+          family: "onboarding",
+          type: "drop",
+          ...{ step_name: stepName }
+        };
+        return this.emit("onboarding", payload, "drop");
+      }
+      /** Returns the last step name seen, or null if no step was tracked yet. */
+      getLastStep() {
+        return this.lastStep;
+      }
+      /** Returns whether the flow has been marked as finished (complete or drop). */
+      isFinished() {
+        return this.finished;
+      }
+      async emit(eventName, properties, logLabel) {
+        const pipeline = this.pipeline;
+        const distinctId = pipeline.getDistinctId();
+        if (!distinctId) {
+          if (this.debug) console.log(`[Paywallo:Onboarding] skipped (no distinctId): ${logLabel}`);
+          return;
+        }
+        await pipeline.trackEvent(eventName, distinctId, properties);
+        if (this.debug) {
+          console.log(`[Paywallo:Onboarding] event emitted: ${eventName}.${logLabel}`, properties);
+        }
+      }
+      assertConfig() {
+        if (!this.pipeline) {
+          throw new OnboardingError(
+            ONBOARDING_ERROR_CODES.NOT_INITIALIZED,
+            "OnboardingManager not initialized. Call Paywallo.init() first."
+          );
+        }
+      }
+      validateStepName(stepName, method) {
+        if (typeof stepName !== "string" || stepName.trim().length === 0) {
+          throw new OnboardingError(
+            ONBOARDING_ERROR_CODES.INVALID_STEP_NAME,
+            `OnboardingManager.${method}(): stepName must be a non-empty string.`
+          );
+        }
+      }
+    };
+    onboardingManager = new OnboardingManager();
+  }
+});
+
+// src/domains/onboarding/index.ts
+var init_onboarding = __esm({
+  "src/domains/onboarding/index.ts"() {
     "use strict";
-    init_SessionError();
-    init_SessionManager();
+    init_OnboardingError();
+    init_OnboardingManager();
   }
 });
 
@@ -6536,268 +6707,124 @@ function validateEvent(eventName, properties) {
   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"() {
-    "use strict";
-    init_OnboardingError();
-    OnboardingManager = class {
-      constructor() {
-        this.pipeline = null;
-        this.debug = false;
-        this.lastStep = null;
-        this.finished = false;
-      }
-      /**
-       * Injects runtime dependencies. Called by PaywalloClient during init.
-       */
-      injectDeps(config) {
-        this.pipeline = config.pipeline;
-        this.debug = config.debug ?? false;
-      }
-      /**
-       * Tracks an onboarding step view.
-       * Saves the step name internally for implicit drop detection on the backend.
-       *
-       * @param stepName - Unique name for this onboarding step.
-       */
-      async step(stepName) {
-        this.assertConfig();
-        this.validateStepName(stepName, "step");
-        this.lastStep = stepName;
-        const payload = {
-          family: "onboarding",
-          type: "step",
-          ...{ step_name: stepName }
-        };
-        return this.emit("onboarding", payload, "step");
-      }
-      /**
-       * Tracks successful completion of the onboarding flow.
-       * Marks the flow as finished.
-       */
-      async complete() {
-        this.assertConfig();
-        this.finished = true;
-        return this.emit("onboarding", { family: "onboarding", type: "complete" }, "complete");
-      }
-      /**
-       * Tracks an explicit drop (abandonment) at the given step.
-       * Marks the flow as finished.
-       *
-       * @param stepName - The step name where the user dropped off.
-       */
-      async drop(stepName) {
-        this.assertConfig();
-        this.validateStepName(stepName, "drop");
-        this.finished = true;
-        const payload = {
-          family: "onboarding",
-          type: "drop",
-          ...{ step_name: stepName }
-        };
-        return this.emit("onboarding", payload, "drop");
-      }
-      /** Returns the last step name seen, or null if no step was tracked yet. */
-      getLastStep() {
-        return this.lastStep;
-      }
-      /** Returns whether the flow has been marked as finished (complete or drop). */
-      isFinished() {
-        return this.finished;
-      }
-      async emit(eventName, properties, logLabel) {
-        const pipeline = this.pipeline;
-        const distinctId = pipeline.getDistinctId();
-        if (!distinctId) {
-          if (this.debug) console.log(`[Paywallo:Onboarding] skipped (no distinctId): ${logLabel}`);
-          return;
-        }
-        await pipeline.trackEvent(eventName, distinctId, properties);
-        if (this.debug) {
-          console.log(`[Paywallo:Onboarding] event emitted: ${eventName}.${logLabel}`, properties);
-        }
-      }
-      assertConfig() {
-        if (!this.pipeline) {
-          throw new OnboardingError(
-            ONBOARDING_ERROR_CODES.NOT_INITIALIZED,
-            "OnboardingManager not initialized. Call Paywallo.init() first."
-          );
-        }
-      }
-      validateStepName(stepName, method) {
-        if (typeof stepName !== "string" || stepName.trim().length === 0) {
-          throw new OnboardingError(
-            ONBOARDING_ERROR_CODES.INVALID_STEP_NAME,
-            `OnboardingManager.${method}(): stepName must be a non-empty string.`
-          );
-        }
-      }
-    };
-    onboardingManager = new OnboardingManager();
+  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/domains/onboarding/index.ts
-var init_onboarding = __esm({
-  "src/domains/onboarding/index.ts"() {
+// 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
+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 import_react_native23, nativeModule, cached;
+var init_detectEnvironment = __esm({
+  "src/utils/detectEnvironment.ts"() {
+    "use strict";
+    import_react_native23 = require("react-native");
+    nativeModule = import_react_native23.NativeModules.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(
@@ -7471,21 +7528,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 = import_react_native23.Platform.OS;
+  if (context.platform === void 0) context.platform = import_react_native24.Platform.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) {
@@ -7519,11 +7597,11 @@ function splitPayloadAndContext(properties) {
   }
   return { payload, promoted };
 }
-var import_react_native23, import_zod2, v2EventSchema, v2ContextSchema, v2EnvelopeSchema, CONTEXT_KEY_ALIASES;
+var import_react_native24, import_zod2, v2EventSchema, v2ContextSchema, v2EnvelopeSchema, IDS_PROMO_ALIASES, CONTEXT_KEY_ALIASES;
 var init_eventEnvelopeV2 = __esm({
   "src/core/eventEnvelopeV2.ts"() {
     "use strict";
-    import_react_native23 = require("react-native");
+    import_react_native24 = require("react-native");
     import_zod2 = require("zod");
     init_uuid();
     init_eventFamilies();
@@ -7547,6 +7625,7 @@ var init_eventEnvelopeV2 = __esm({
       device_model: import_zod2.z.string().optional(),
       timezone: import_zod2.z.string().optional(),
       locale: import_zod2.z.string().optional(),
+      country: import_zod2.z.string().optional(),
       carrier: import_zod2.z.string().optional(),
       screen_width: import_zod2.z.number().optional(),
       screen_height: import_zod2.z.number().optional(),
@@ -7558,6 +7637,12 @@ var init_eventEnvelopeV2 = __esm({
       context: v2ContextSchema,
       events: import_zod2.z.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,11 +7679,11 @@ var init_events = __esm({
 });
 
 // src/core/EventBatcher.ts
-var import_react_native24, BATCH_MAX_SIZE, BATCH_FLUSH_MS, EVENT_NAME_REGEX, V2_BATCH_ENDPOINT, EventBatcher;
+var import_react_native25, BATCH_MAX_SIZE, BATCH_FLUSH_MS, EVENT_NAME_REGEX, V2_BATCH_ENDPOINT, EventBatcher;
 var init_EventBatcher = __esm({
   "src/core/EventBatcher.ts"() {
     "use strict";
-    import_react_native24 = require("react-native");
+    import_react_native25 = require("react-native");
     init_eventEnvelopeV2();
     init_events();
     BATCH_MAX_SIZE = 25;
@@ -7646,7 +7732,7 @@ var init_EventBatcher = __esm({
         const event = {
           eventName,
           distinctId,
-          properties: { ...properties, platform: import_react_native24.Platform.OS },
+          properties: { ...properties, platform: import_react_native25.Platform.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;
@@ -8001,11 +8087,11 @@ function normalizeGender(raw) {
   if (lower === "f" || lower === "female") return "f";
   return void 0;
 }
-var import_react_native25, DATE_OF_BIRTH_RE, ApiClient;
+var import_react_native26, DATE_OF_BIRTH_RE, ApiClient;
 var init_ApiClient = __esm({
   "src/core/ApiClient.ts"() {
     "use strict";
-    import_react_native25 = require("react-native");
+    import_react_native26 = require("react-native");
     init_apiPurchaseMethods();
     init_ApiCache();
     init_ApiClientFlags();
@@ -8108,7 +8194,7 @@ var init_ApiClient = __esm({
       buildSdkHeaders() {
         return {
           "x-sdk-version": SDK_VERSION,
-          "x-sdk-platform": import_react_native25.Platform.OS,
+          "x-sdk-platform": import_react_native26.Platform.OS,
           "x-sdk-environment": this.environment
         };
       }
@@ -8138,7 +8224,7 @@ var init_ApiClient = __esm({
             message,
             context,
             sdkVersion: SDK_VERSION,
-            platform: import_react_native25.Platform.OS
+            platform: import_react_native26.Platform.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: import_react_native25.Platform.OS,
+          platform: import_react_native26.Platform.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
-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 import_react_native26, nativeModule, cached;
-var init_detectEnvironment = __esm({
-  "src/utils/detectEnvironment.ts"() {
-    "use strict";
-    import_react_native26 = require("react-native");
-    nativeModule = import_react_native26.NativeModules.PaywalloEnv ?? null;
-    cached = null;
-  }
-});
-
 // src/core/PaywalloInitializer.ts
 async function initWithRetry(state, config) {
   while (state.initAttempts <= MAX_INIT_RETRIES) {
@@ -8475,8 +8531,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));
     }
   }
 }
@@ -8506,7 +8562,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, {
@@ -8556,7 +8612,7 @@ async function doInit(state, config) {
   ]);
   const apiClient = new ApiClient(
     config.appKey,
-    config.apiUrl ?? DEFAULT_API_URL,
+    DEFAULT_API_URL,
     config.debug,
     environment,
     offlineQueueEnabled,
@@ -8630,8 +8686,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;
@@ -8655,7 +8711,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,
@@ -8723,6 +8779,7 @@ var init_PaywalloInitializer = __esm({
     init_plan();
     init_session();
     init_SubscriptionManager();
+    init_detectEnvironment();
     init_NativeDeviceInfo();
     init_ApiClient();
     init_constants();
@@ -8732,7 +8789,6 @@ var init_PaywalloInitializer = __esm({
     init_PaywalloState();
     init_queue();
     init_NativeStorage();
-    init_detectEnvironment();
   }
 });
 
@@ -8853,6 +8909,7 @@ var init_PaywalloClient = __esm({
     init_plan();
     init_session();
     init_ClientError();
+    init_onboarding();
     init_network();
     init_PaywalloAnalytics();
     init_PaywalloFlags();
@@ -8922,8 +8979,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();
@@ -9010,6 +9068,9 @@ var init_PaywalloClient = __esm({
       getConfig() {
         return this.state.config;
       }
+      getId() {
+        return identityManager.getDistinctId();
+      }
       getDistinctId() {
         return identityManager.getDistinctId();
       }
@@ -9310,6 +9371,7 @@ __export(index_exports, {
   createPurchaseError: () => createPurchaseError,
   default: () => index_default,
   detectDeviceLanguage: () => detectDeviceLanguage,
+  getActiveRouteName: () => getActiveRouteName,
   getCurrentLanguage: () => getCurrentLanguage,
   getDefaultLanguage: () => getDefaultLanguage,
   getIAPService: () => getIAPService,
@@ -9338,6 +9400,7 @@ __export(index_exports, {
   useOnboarding: () => useOnboarding,
   usePaywallContext: () => usePaywallContext,
   usePaywallo: () => usePaywallo,
+  usePaywalloScreenTracking: () => usePaywalloScreenTracking,
   usePlanPurchase: () => usePlanPurchase,
   usePlans: () => usePlans,
   useProducts: () => useProducts,
@@ -9472,7 +9535,7 @@ var import_react15 = require("react");
 init_onboarding();
 function useOnboarding() {
   const step = (0, import_react15.useCallback)(
-    (stepName) => onboardingManager.step(stepName),
+    (stepName, order) => onboardingManager.step(stepName, order),
     []
   );
   const complete = (0, import_react15.useCallback)(
@@ -9816,8 +9879,41 @@ function useSubscription() {
   };
 }
 
+// src/hooks/usePaywalloScreenTracking.ts
+var import_react22 = require("react");
+init_PaywalloClient();
+function isNavState(value) {
+  return typeof value === "object" && value !== null && "routes" in value && "index" in value && Array.isArray(value.routes) && typeof value.index === "number";
+}
+function getActiveRouteName(state) {
+  try {
+    if (!isNavState(state)) return null;
+    const route = state.routes[state.index];
+    if (!route) return null;
+    if (isNavState(route.state)) {
+      return getActiveRouteName(route.state);
+    }
+    return typeof route.name === "string" ? route.name : null;
+  } catch {
+    return null;
+  }
+}
+function usePaywalloScreenTracking() {
+  const lastScreenRef = (0, import_react22.useRef)(null);
+  return (0, import_react22.useCallback)((state) => {
+    if (!PaywalloClient.isReady()) return;
+    const screenName = getActiveRouteName(state);
+    if (!screenName || screenName === lastScreenRef.current) return;
+    lastScreenRef.current = screenName;
+    void PaywalloClient.track("screen_view", {
+      properties: { screen_name: screenName }
+    }).catch(() => {
+    });
+  }, []);
+}
+
 // src/PaywalloProvider.tsx
-var import_react27 = require("react");
+var import_react28 = require("react");
 var import_react_native29 = require("react-native");
 init_PaywalloClient();
 init_NativeStorage();
@@ -9832,12 +9928,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;
@@ -9876,24 +9977,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) {
-  try {
-    const shared = pickShared(await import("expo-superwall/compat"));
-    if (shared) return shared;
-  } catch {
-  }
+async function resolveSuperwallNativeModule(debug) {
   try {
-    const shared = pickShared(await import("expo-superwall"));
-    if (shared) return shared;
+    const native = pickNative(await import("expo-superwall"));
+    if (native) return native;
   } 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);
@@ -9901,10 +10016,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) {
@@ -10020,50 +10136,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) {
@@ -10107,7 +10182,7 @@ init_session();
 init_ClientError();
 
 // src/hooks/useAppAutoEvents.ts
-var import_react22 = require("react");
+var import_react23 = require("react");
 
 // src/utils/platformDetection.ts
 async function detectPlatform3() {
@@ -10133,8 +10208,8 @@ 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 = (0, import_react22.useRef)(false);
-  (0, import_react22.useEffect)(() => {
+  const didRunRef = (0, import_react23.useRef)(false);
+  (0, import_react23.useEffect)(() => {
     if (debug) console.log("[Paywallo EVENTS] useEffect fired", { isInitialized, didRunRefCurrent: didRunRef.current });
     if (!isInitialized || didRunRef.current) return;
     const timer = setTimeout(() => {
@@ -10144,13 +10219,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");
@@ -10162,7 +10237,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);
@@ -10174,7 +10249,7 @@ function useAppAutoEvents(config) {
 }
 
 // src/hooks/useCampaignPreload.ts
-var import_react23 = require("react");
+var import_react24 = require("react");
 init_PaywalloClient();
 init_CampaignError();
 
@@ -10245,17 +10320,17 @@ function getCacheEntry(cache, placement) {
 
 // src/hooks/useCampaignPreload.ts
 function useCampaignPreload() {
-  const [preloadedWebView, setPreloadedWebView] = (0, import_react23.useState)(null);
-  const preloadedCampaignsRef = (0, import_react23.useRef)(/* @__PURE__ */ new Map());
-  const isPreloadValid = (0, import_react23.useCallback)(
+  const [preloadedWebView, setPreloadedWebView] = (0, import_react24.useState)(null);
+  const preloadedCampaignsRef = (0, import_react24.useRef)(/* @__PURE__ */ new Map());
+  const isPreloadValid = (0, import_react24.useCallback)(
     (placement) => isCacheEntryValid(preloadedCampaignsRef.current.get(placement)),
     []
   );
-  const consumePreloadedCampaign = (0, import_react23.useCallback)(
+  const consumePreloadedCampaign = (0, import_react24.useCallback)(
     (placement) => getCacheEntry(preloadedCampaignsRef.current, placement),
     []
   );
-  const preloadCampaign = (0, import_react23.useCallback)(
+  const preloadCampaign = (0, import_react24.useCallback)(
     async (placement, context) => {
       try {
         const campaign = await PaywalloClient.getCampaign(placement, context);
@@ -10324,11 +10399,11 @@ function useCampaignPreload() {
 }
 
 // src/hooks/useProductLoader.ts
-var import_react24 = require("react");
+var import_react25 = require("react");
 function useProductLoader() {
-  const [products, setProducts] = (0, import_react24.useState)(/* @__PURE__ */ new Map());
-  const [isLoadingProducts, setIsLoadingProducts] = (0, import_react24.useState)(false);
-  const refreshProducts = (0, import_react24.useCallback)(async (productIds) => {
+  const [products, setProducts] = (0, import_react25.useState)(/* @__PURE__ */ new Map());
+  const [isLoadingProducts, setIsLoadingProducts] = (0, import_react25.useState)(false);
+  const refreshProducts = (0, import_react25.useCallback)(async (productIds) => {
     setIsLoadingProducts(true);
     try {
       const iapService = getIAPService();
@@ -10346,11 +10421,11 @@ function useProductLoader() {
 }
 
 // src/hooks/usePurchaseOrchestrator.ts
-var import_react25 = require("react");
+var import_react26 = require("react");
 init_paywall();
 function usePurchaseOrchestrator(preloadedWebView, resolvePreloadedPaywall, clearPreloadedWebView, setShowingPreloadedWebView, presentedAtRef, invalidateSubscriptionCache) {
   const { trackDismissed, trackProductSelected, trackPurchased } = usePaywallTracking();
-  const handlePreloadedPurchase = (0, import_react25.useCallback)(
+  const handlePreloadedPurchase = (0, import_react26.useCallback)(
     async (productId) => {
       try {
         if (preloadedWebView) {
@@ -10388,7 +10463,7 @@ function usePurchaseOrchestrator(preloadedWebView, resolvePreloadedPaywall, clea
     },
     [preloadedWebView, resolvePreloadedPaywall, clearPreloadedWebView, setShowingPreloadedWebView, presentedAtRef, trackDismissed, trackProductSelected, trackPurchased, invalidateSubscriptionCache]
   );
-  const handlePreloadedRestore = (0, import_react25.useCallback)(async () => {
+  const handlePreloadedRestore = (0, import_react26.useCallback)(async () => {
     try {
       const transactions = await getIAPService().restore();
       if (transactions.length === 0) return;
@@ -10411,7 +10486,7 @@ function usePurchaseOrchestrator(preloadedWebView, resolvePreloadedPaywall, clea
 }
 
 // src/hooks/useSubscriptionSync.ts
-var import_react26 = require("react");
+var import_react27 = require("react");
 init_PaywalloClient();
 init_SubscriptionCache();
 
@@ -10521,18 +10596,18 @@ async function checkPersistedCache(distinctId, onHit) {
 
 // src/hooks/useSubscriptionSync.ts
 function useSubscriptionSync() {
-  const [subscription, setSubscription] = (0, import_react26.useState)(null);
-  const cacheRef = (0, import_react26.useRef)(null);
-  const setCacheAndState = (0, import_react26.useCallback)((sub) => {
+  const [subscription, setSubscription] = (0, import_react27.useState)(null);
+  const cacheRef = (0, import_react27.useRef)(null);
+  const setCacheAndState = (0, import_react27.useCallback)((sub) => {
     cacheRef.current = { data: sub, expiresAt: Date.now() + CACHE_TTL_MS2 };
     setSubscription(sub);
   }, []);
-  const invalidateCache = (0, import_react26.useCallback)(() => {
+  const invalidateCache = (0, import_react27.useCallback)(() => {
     cacheRef.current = null;
     const distinctId = PaywalloClient.getDistinctId();
     if (distinctId) void subscriptionCache.invalidate(distinctId);
   }, []);
-  const fetchAndCache = (0, import_react26.useCallback)(async () => {
+  const fetchAndCache = (0, import_react27.useCallback)(async () => {
     const apiClient = PaywalloClient.getApiClient();
     const distinctId = PaywalloClient.getDistinctId();
     if (!apiClient || !distinctId) return null;
@@ -10542,7 +10617,7 @@ function useSubscriptionSync() {
     void subscriptionCache.set(distinctId, toDomainResponse(status));
     return sub;
   }, [setCacheAndState]);
-  const hasActiveSubscription = (0, import_react26.useCallback)(async () => {
+  const hasActiveSubscription = (0, import_react27.useCallback)(async () => {
     const apiClient = PaywalloClient.getApiClient();
     const distinctId = PaywalloClient.getDistinctId();
     if (!apiClient || !distinctId) return false;
@@ -10562,7 +10637,7 @@ function useSubscriptionSync() {
       return resolveOfflineFromCache(distinctId);
     }
   }, [setCacheAndState]);
-  const getSubscription = (0, import_react26.useCallback)(async () => {
+  const getSubscription = (0, import_react27.useCallback)(async () => {
     const apiClient = PaywalloClient.getApiClient();
     const distinctId = PaywalloClient.getDistinctId();
     if (!apiClient || !distinctId) return null;
@@ -10587,20 +10662,20 @@ function useSubscriptionSync() {
 init_localization();
 var import_jsx_runtime5 = require("react/jsx-runtime");
 function PaywalloProvider({ children, config }) {
-  const [isInitialized, setIsInitialized] = (0, import_react27.useState)(false);
-  const [initError, setInitError] = (0, import_react27.useState)(null);
-  const [distinctId, setDistinctId] = (0, import_react27.useState)(null);
-  const [activePaywall, setActivePaywall] = (0, import_react27.useState)(null);
+  const [isInitialized, setIsInitialized] = (0, import_react28.useState)(false);
+  const [initError, setInitError] = (0, import_react28.useState)(null);
+  const [distinctId, setDistinctId] = (0, import_react28.useState)(null);
+  const [activePaywall, setActivePaywall] = (0, import_react28.useState)(null);
   const { products, isLoadingProducts, refreshProducts } = useProductLoader();
   const { subscription, hasActiveSubscription, getSubscription, invalidateCache } = useSubscriptionSync();
   const { preloadedWebView, setPreloadedWebView, preloadCampaign, consumePreloadedCampaign, isPreloadValid } = useCampaignPreload();
-  const clearPreloadedWebView = (0, import_react27.useCallback)(() => setPreloadedWebView(null), [setPreloadedWebView]);
-  const autoPreloadTriggeredRef = (0, import_react27.useRef)(false);
-  const preloadedWebViewRef = (0, import_react27.useRef)(preloadedWebView);
-  const pollTimerRef = (0, import_react27.useRef)(null);
-  const pollCancelledRef = (0, import_react27.useRef)(false);
-  const secureStorageRef = (0, import_react27.useRef)(new SecureStorage(config.debug));
-  (0, import_react27.useEffect)(() => {
+  const clearPreloadedWebView = (0, import_react28.useCallback)(() => setPreloadedWebView(null), [setPreloadedWebView]);
+  const autoPreloadTriggeredRef = (0, import_react28.useRef)(false);
+  const preloadedWebViewRef = (0, import_react28.useRef)(preloadedWebView);
+  const pollTimerRef = (0, import_react28.useRef)(null);
+  const pollCancelledRef = (0, import_react28.useRef)(false);
+  const secureStorageRef = (0, import_react28.useRef)(new SecureStorage(config.debug));
+  (0, import_react28.useEffect)(() => {
     preloadedWebViewRef.current = preloadedWebView;
   }, [preloadedWebView]);
   useAppAutoEvents({
@@ -10626,20 +10701,20 @@ function PaywalloProvider({ children, config }) {
     },
     debug: config.debug
   });
-  const triggerRepreload = (0, import_react27.useCallback)((placement) => {
+  const triggerRepreload = (0, import_react28.useCallback)((placement) => {
     void PaywalloClient.preloadCampaign(placement).catch(() => {
     });
   }, []);
   const { showingPreloadedWebView, presentPreloadedWebView, resolvePreloadedPaywall, handlePreloadedWebViewReady: baseHandlePreloadedWebViewReady, handlePreloadedClose: baseHandlePreloadedClose, setShowingPreloadedWebView, presentedAtRef } = usePaywallPresenter(preloadedWebView, setPreloadedWebView);
-  const SCREEN_HEIGHT = (0, import_react27.useMemo)(() => import_react_native29.Dimensions.get("window").height, []);
-  const slideAnim = (0, import_react27.useRef)(new import_react_native29.Animated.Value(SCREEN_HEIGHT)).current;
-  const handlePreloadedWebViewReady = (0, import_react27.useCallback)(() => {
+  const SCREEN_HEIGHT = (0, import_react28.useMemo)(() => import_react_native29.Dimensions.get("window").height, []);
+  const slideAnim = (0, import_react28.useRef)(new import_react_native29.Animated.Value(SCREEN_HEIGHT)).current;
+  const handlePreloadedWebViewReady = (0, import_react28.useCallback)(() => {
     if (PaywalloClient.getConfig()?.debug) {
       console.log(`[Paywallo WEBVIEW] loaded \u2014 placement: ${preloadedWebView?.placement}`);
     }
     baseHandlePreloadedWebViewReady();
   }, [preloadedWebView?.placement, baseHandlePreloadedWebViewReady]);
-  const handlePreloadedClose = (0, import_react27.useCallback)(() => {
+  const handlePreloadedClose = (0, import_react28.useCallback)(() => {
     const placement = preloadedWebView?.placement;
     import_react_native29.Animated.timing(slideAnim, { toValue: SCREEN_HEIGHT, duration: 200, easing: import_react_native29.Easing.in(import_react_native29.Easing.cubic), useNativeDriver: true }).start(() => {
       baseHandlePreloadedClose();
@@ -10654,8 +10729,8 @@ function PaywalloProvider({ children, config }) {
     presentedAtRef,
     invalidateCache
   );
-  const [isPreloadPurchasing, setIsPreloadPurchasing] = (0, import_react27.useState)(false);
-  const handlePreloadedPurchase = (0, import_react27.useCallback)(async (productId) => {
+  const [isPreloadPurchasing, setIsPreloadPurchasing] = (0, import_react28.useState)(false);
+  const handlePreloadedPurchase = (0, import_react28.useCallback)(async (productId) => {
     setIsPreloadPurchasing(true);
     try {
       await rawPreloadedPurchase(productId);
@@ -10663,15 +10738,25 @@ function PaywalloProvider({ children, config }) {
       setIsPreloadPurchasing(false);
     }
   }, [rawPreloadedPurchase]);
-  const configRef = (0, import_react27.useRef)(config);
-  (0, import_react27.useEffect)(() => {
+  const configRef = (0, import_react28.useRef)(config);
+  (0, import_react28.useEffect)(() => {
     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;
@@ -10684,19 +10769,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 = (0, import_react27.useCallback)(async (p) => {
+  const getPaywallConfig = (0, import_react28.useCallback)(async (p) => {
     const api = PaywalloClient.getApiClient();
     return api ? api.getPaywall(p) : null;
   }, []);
-  const presentPaywall = (0, import_react27.useCallback)((placement) => {
+  const presentPaywall = (0, import_react28.useCallback)((placement) => {
     const preloaded = paywallPreloadService.getPreloaded(placement);
     return new Promise((resolve) => setActivePaywall({
       placement,
@@ -10714,7 +10797,7 @@ function PaywalloProvider({ children, config }) {
       }
     }));
   }, []);
-  const trackCampaignImpression = (0, import_react27.useCallback)((placement, variantKey, campaignId) => {
+  const trackCampaignImpression = (0, import_react28.useCallback)((placement, variantKey, campaignId) => {
     const api = PaywalloClient.getApiClient();
     if (!api) return;
     const sessionId = PaywalloClient.getSessionId();
@@ -10728,7 +10811,7 @@ function PaywalloProvider({ children, config }) {
     }).catch(() => {
     });
   }, []);
-  const presentCampaign = (0, import_react27.useCallback)(
+  const presentCampaign = (0, import_react28.useCallback)(
     async (placement, context) => {
       try {
         if (preloadedWebView?.placement === placement && preloadedWebView.loaded && isPreloadValid(placement)) {
@@ -10802,7 +10885,7 @@ function PaywalloProvider({ children, config }) {
     },
     [preloadedWebView, isPreloadValid, consumePreloadedCampaign, presentPreloadedWebView, trackCampaignImpression]
   );
-  const restorePurchases = (0, import_react27.useCallback)(async () => {
+  const restorePurchases = (0, import_react28.useCallback)(async () => {
     invalidateCache();
     try {
       const txs = await getIAPService().restore();
@@ -10811,13 +10894,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 = (0, import_react27.useCallback)((result) => {
+  const handlePaywallResult = (0, import_react28.useCallback)((result) => {
     if (activePaywall) {
       activePaywall.resolver(result);
       setActivePaywall(null);
     }
   }, [activePaywall]);
-  const bridgePaywallPresenter = (0, import_react27.useCallback)((placement) => {
+  const bridgePaywallPresenter = (0, import_react28.useCallback)((placement) => {
     if (PaywalloClient.getConfig()?.debug) {
       console.log(`[Paywallo PRESENT] called \u2014 preloaded: ${preloadedWebViewRef.current?.loaded === true} placement: ${placement}`);
     }
@@ -10846,7 +10929,7 @@ function PaywalloProvider({ children, config }) {
     }
     return presentCampaign(placement);
   }, [presentPreloadedWebView, presentCampaign]);
-  (0, import_react27.useEffect)(() => {
+  (0, import_react28.useEffect)(() => {
     if (!isInitialized) return;
     const onEmergency = async (id) => {
       try {
@@ -10873,9 +10956,9 @@ function PaywalloProvider({ children, config }) {
     };
   }, [isInitialized, bridgePaywallPresenter, getSubscription, hasActiveSubscription, restorePurchases]);
   const isReady = isInitialized && !isLoadingProducts;
-  const noOp = (0, import_react27.useCallback)(() => {
+  const noOp = (0, import_react28.useCallback)(() => {
   }, []);
-  const contextValue = (0, import_react27.useMemo)(() => ({
+  const contextValue = (0, import_react28.useMemo)(() => ({
     config: PaywalloClient.getConfig(),
     isInitialized,
     isReady,
@@ -10909,7 +10992,7 @@ function PaywalloProvider({ children, config }) {
     getPaywallConfig,
     refreshProducts
   ]);
-  (0, import_react27.useLayoutEffect)(() => {
+  (0, import_react28.useLayoutEffect)(() => {
     if (showingPreloadedWebView) {
       slideAnim.setValue(SCREEN_HEIGHT);
       import_react_native29.Animated.timing(slideAnim, { toValue: 0, duration: 200, easing: import_react_native29.Easing.out(import_react_native29.Easing.cubic), useNativeDriver: true }).start();
@@ -11128,6 +11211,7 @@ var index_default = Paywallo;
   attributionTracker,
   createPurchaseError,
   detectDeviceLanguage,
+  getActiveRouteName,
   getCurrentLanguage,
   getDefaultLanguage,
   getIAPService,
@@ -11156,6 +11240,7 @@ var index_default = Paywallo;
   useOnboarding,
   usePaywallContext,
   usePaywallo,
+  usePaywalloScreenTracking,
   usePlanPurchase,
   usePlans,
   useProducts,