@virex-tech/paywallo-sdk 2.5.3 → 2.6.2

package/dist/index.js

@@ -491,7 +491,7 @@ async function readAnonIdDurably(storage) {
   if (secure) return secure;
   return nativeStorage.get(ANON_ID_FALLBACK_KEY);
 }
-var DEVICE_ID_KEY, ANON_ID_FALLBACK_KEY, ANON_ID_KEY, USER_EMAIL_KEY, USER_PROPERTIES_KEY, USER_DISTINCT_ID_KEY, USER_NAME_KEY, USER_COUNTRY_KEY, USER_LOCALE_KEY, USER_PHONE_KEY, USER_FIRST_NAME_KEY, USER_LAST_NAME_KEY, USER_DOB_KEY, USER_GENDER_KEY, LEGACY_USER_PHONE_KEY, LEGACY_USER_FIRST_NAME_KEY, LEGACY_USER_LAST_NAME_KEY, LEGACY_USER_DOB_KEY, LEGACY_USER_GENDER_KEY, LEGACY_DEVICE_ID_KEY, LEGACY_ANON_ID_KEY, LEGACY_EMAIL_KEY, LEGACY_PROPERTIES_KEY, LEGACY_DISTINCT_ID_KEY, LEGACY_NAME_KEY, LEGACY_COUNTRY_KEY, LEGACY_LOCALE_KEY, ANON_ID_SET_RETRIES, ANON_ID_RETRY_DELAY_MS;
+var DEVICE_ID_KEY, ANON_ID_FALLBACK_KEY, ANON_ID_KEY, USER_EMAIL_KEY, USER_PROPERTIES_KEY, USER_DISTINCT_ID_KEY, USER_NAME_KEY, USER_COUNTRY_KEY, USER_LOCALE_KEY, USER_PHONE_KEY, USER_FIRST_NAME_KEY, USER_LAST_NAME_KEY, USER_DOB_KEY, USER_GENDER_KEY, USER_ZIP_KEY, LEGACY_USER_PHONE_KEY, LEGACY_USER_FIRST_NAME_KEY, LEGACY_USER_LAST_NAME_KEY, LEGACY_USER_DOB_KEY, LEGACY_USER_GENDER_KEY, LEGACY_DEVICE_ID_KEY, LEGACY_ANON_ID_KEY, LEGACY_EMAIL_KEY, LEGACY_PROPERTIES_KEY, LEGACY_DISTINCT_ID_KEY, LEGACY_NAME_KEY, LEGACY_COUNTRY_KEY, LEGACY_LOCALE_KEY, ANON_ID_SET_RETRIES, ANON_ID_RETRY_DELAY_MS;
 var init_IdentityStorage = __esm({
   "src/domains/identity/IdentityStorage.ts"() {
     "use strict";
@@ -510,6 +510,7 @@ var init_IdentityStorage = __esm({
     USER_LAST_NAME_KEY = "@paywallo:user_last_name";
     USER_DOB_KEY = "@paywallo:user_dob";
     USER_GENDER_KEY = "@paywallo:user_gender";
+    USER_ZIP_KEY = "@paywallo:user_zip";
     LEGACY_USER_PHONE_KEY = "@panel:user_phone";
     LEGACY_USER_FIRST_NAME_KEY = "@panel:user_first_name";
     LEGACY_USER_LAST_NAME_KEY = "@panel:user_last_name";
@@ -560,6 +561,7 @@ var init_IdentityManager = __esm({
         this.lastName = null;
         this.dateOfBirth = null;
         this.gender = null;
+        this.zipCode = null;
         this.apiClient = null;
         this.secureStorage = null;
         this.debug = false;
@@ -614,7 +616,7 @@ var init_IdentityManager = __esm({
         let email;
         let properties;
         if (options) {
-          if ("email" in options || "properties" in options || "phone" in options || "firstName" in options || "lastName" in options || "dateOfBirth" in options || "gender" in options) {
+          if ("email" in options || "properties" in options || "phone" in options || "firstName" in options || "lastName" in options || "dateOfBirth" in options || "gender" in options || "zipCode" in options) {
             email = options.email;
             properties = options.properties;
           } else {
@@ -655,6 +657,10 @@ var init_IdentityManager = __esm({
           this.gender = opts.gender;
           await this.secureStorage.set(USER_GENDER_KEY, this.gender);
         }
+        if (opts?.zipCode) {
+          this.zipCode = opts.zipCode;
+          await this.secureStorage.set(USER_ZIP_KEY, this.zipCode);
+        }
         if (this.apiClient && this.anonId) {
           try {
             await this.apiClient.identify(this.anonId, properties, email, this.deviceId ?? void 0, {
@@ -662,11 +668,15 @@ var init_IdentityManager = __esm({
               firstName: this.firstName ?? void 0,
               lastName: this.lastName ?? void 0,
               dateOfBirth: this.dateOfBirth ?? void 0,
-              gender: this.gender ?? void 0
+              gender: this.gender ?? void 0,
+              zipCode: this.zipCode ?? void 0
             });
+            if (this.debug) console.log("[Paywallo] identify confirmed", this.anonId.slice(0, 8));
           } catch (err) {
-            if (this.debug) console.log("[Paywallo] identify dispatch error", err);
+            if (this.debug) console.log("[Paywallo] identify failed:", err);
           }
+        } else {
+          if (this.debug) console.log("[Paywallo] identify skipped \u2014 anonId not ready");
         }
       }
       getDistinctId() {
@@ -709,6 +719,7 @@ var init_IdentityManager = __esm({
         this.lastName = null;
         this.dateOfBirth = null;
         this.gender = null;
+        this.zipCode = null;
         await Promise.all([
           this.secureStorage?.set(ANON_ID_KEY, newAnonId) ?? Promise.resolve(false),
           this.secureStorage?.remove(USER_EMAIL_KEY) ?? Promise.resolve(false),
@@ -717,7 +728,8 @@ var init_IdentityManager = __esm({
           this.secureStorage?.remove(USER_FIRST_NAME_KEY) ?? Promise.resolve(false),
           this.secureStorage?.remove(USER_LAST_NAME_KEY) ?? Promise.resolve(false),
           this.secureStorage?.remove(USER_DOB_KEY) ?? Promise.resolve(false),
-          this.secureStorage?.remove(USER_GENDER_KEY) ?? Promise.resolve(false)
+          this.secureStorage?.remove(USER_GENDER_KEY) ?? Promise.resolve(false),
+          this.secureStorage?.remove(USER_ZIP_KEY) ?? Promise.resolve(false)
         ]);
       }
       getState() {
@@ -729,7 +741,8 @@ var init_IdentityManager = __esm({
           firstName: this.firstName,
           lastName: this.lastName,
           dateOfBirth: this.dateOfBirth,
-          gender: this.gender
+          gender: this.gender,
+          zipCode: this.zipCode
         };
       }
       isSecureStorageAvailable() {
@@ -947,17 +960,39 @@ var init_campaign = __esm({
   }
 });
 
+// src/domains/identity/NativeAdvertisingId.ts
+var import_react_native3, nativeModule, nativeAdvertisingId;
+var init_NativeAdvertisingId = __esm({
+  "src/domains/identity/NativeAdvertisingId.ts"() {
+    "use strict";
+    import_react_native3 = require("react-native");
+    nativeModule = import_react_native3.NativeModules.PaywalloAdvertisingId ?? null;
+    nativeAdvertisingId = {
+      async getAdvertisingId() {
+        try {
+          return await nativeModule?.getAdvertisingId?.() ?? null;
+        } catch {
+          return null;
+        }
+      }
+    };
+  }
+});
+
 // src/domains/identity/AdvertisingIdManager.ts
-var import_react_native3, ZERO_IDFA, AdvertisingIdManager, advertisingIdManager;
+var import_react_native4, ZERO_IDFA, ATT_PROMPT_TIMEOUT_MS, AdvertisingIdManager, advertisingIdManager;
 var init_AdvertisingIdManager = __esm({
   "src/domains/identity/AdvertisingIdManager.ts"() {
     "use strict";
-    import_react_native3 = require("react-native");
+    import_react_native4 = require("react-native");
     init_NativeDeviceInfo();
+    init_NativeAdvertisingId();
     ZERO_IDFA = "00000000-0000-0000-0000-000000000000";
+    ATT_PROMPT_TIMEOUT_MS = 4e3;
     AdvertisingIdManager = class {
-      constructor() {
+      constructor(debug = false) {
         this.cached = null;
+        this.debug = debug;
       }
       /**
        * Synchronous accessor for the cached collect() result. Returns null until
@@ -972,9 +1007,12 @@ var init_AdvertisingIdManager = __esm({
           return this.cached;
         }
         const fallback = { idfv: null, idfa: null, gaid: null, attStatus: "unavailable" };
+        if (import_react_native4.Platform.OS === "android") {
+          return this.collectAndroid();
+        }
         try {
           const tracking = await import("expo-tracking-transparency");
-          if (import_react_native3.Platform.OS === "ios") {
+          if (import_react_native4.Platform.OS === "ios") {
             if (!tracking.isAvailable()) {
               const idfv2 = await this.collectIdfv();
               const result2 = { ...fallback, idfv: idfv2 };
@@ -985,9 +1023,20 @@ var init_AdvertisingIdManager = __esm({
             let status = current.status;
             let granted = current.granted;
             if (status === "undetermined" && requestATT) {
-              const result2 = await tracking.requestTrackingPermissionsAsync();
-              status = result2.status;
-              granted = result2.granted;
+              const result2 = await Promise.race([
+                tracking.requestTrackingPermissionsAsync(),
+                new Promise((r) => setTimeout(() => r(null), ATT_PROMPT_TIMEOUT_MS))
+              ]);
+              if (result2 === null) {
+                if (this.debug) {
+                  console.log(`[Paywallo] ATT prompt timed out after ${ATT_PROMPT_TIMEOUT_MS}ms \u2014 treating as undetermined`);
+                }
+                status = "undetermined";
+                granted = false;
+              } else {
+                status = result2.status;
+                granted = result2.granted;
+              }
             }
             const idfv = await this.collectIdfv();
             const idfa = granted ? this.sanitizeId(tracking.getAdvertisingId()) : null;
@@ -995,12 +1044,6 @@ var init_AdvertisingIdManager = __esm({
             if (idfv !== null) this.cached = result;
             return result;
           }
-          if (import_react_native3.Platform.OS === "android") {
-            const rawGaid = tracking.getAdvertisingId();
-            const gaid = this.sanitizeId(rawGaid);
-            this.cached = { idfv: null, idfa: null, gaid, attStatus: "unavailable" };
-            return this.cached;
-          }
           this.cached = fallback;
           return this.cached;
         } catch {
@@ -1008,6 +1051,27 @@ var init_AdvertisingIdManager = __esm({
           return this.cached;
         }
       }
+      async collectAndroid() {
+        const nativeGaid = this.sanitizeId(
+          await Promise.race([
+            nativeAdvertisingId.getAdvertisingId(),
+            new Promise((r) => setTimeout(() => r(null), 1500))
+          ])
+        );
+        if (nativeGaid !== null) {
+          this.cached = { idfv: null, idfa: null, gaid: nativeGaid, attStatus: "unavailable" };
+          return this.cached;
+        }
+        try {
+          const tracking = await import("expo-tracking-transparency");
+          const gaid = this.sanitizeId(tracking.getAdvertisingId());
+          this.cached = { idfv: null, idfa: null, gaid, attStatus: "unavailable" };
+          return this.cached;
+        } catch {
+          this.cached = { idfv: null, idfa: null, gaid: null, attStatus: "unavailable" };
+          return this.cached;
+        }
+      }
       async collectIdfv() {
         const RETRY_DELAY_MS = 80;
         const MAX_ATTEMPTS = 3;
@@ -1151,11 +1215,11 @@ var init_sessionTracking = __esm({
 });
 
 // src/domains/session/SessionManager.ts
-var import_react_native4, SESSION_ID_KEY, SESSION_START_KEY, LEGACY_SESSION_ID_KEY, LEGACY_SESSION_START_KEY, SESSION_TIMEOUT_MS, SessionManager, sessionManager;
+var import_react_native5, SESSION_ID_KEY, SESSION_START_KEY, LEGACY_SESSION_ID_KEY, LEGACY_SESSION_START_KEY, SESSION_TIMEOUT_MS, SessionManager, sessionManager;
 var init_SessionManager = __esm({
   "src/domains/session/SessionManager.ts"() {
     "use strict";
-    import_react_native4 = require("react-native");
+    import_react_native5 = require("react-native");
     init_SecureStorage();
     init_uuid();
     init_distinctIdGuard();
@@ -1311,7 +1375,7 @@ var init_SessionManager = __esm({
         if (this.appStateSubscription) {
           this.appStateSubscription.remove();
         }
-        this.appStateSubscription = import_react_native4.AppState.addEventListener("change", this.handleAppStateChange);
+        this.appStateSubscription = import_react_native5.AppState.addEventListener("change", this.handleAppStateChange);
       }
       async handleForeground() {
         const elapsed = this.backgroundTimestamp ? Date.now() - this.backgroundTimestamp : null;
@@ -1614,13 +1678,13 @@ var init_deferredAppLink = __esm({
 });
 
 // src/domains/identity/MetaBridge.ts
-var import_react_native5, TIMEOUT_MS, NativeBridge, MetaBridge, metaBridge;
+var import_react_native6, TIMEOUT_MS, NativeBridge, MetaBridge, metaBridge;
 var init_MetaBridge = __esm({
   "src/domains/identity/MetaBridge.ts"() {
     "use strict";
-    import_react_native5 = require("react-native");
+    import_react_native6 = require("react-native");
     TIMEOUT_MS = 2e3;
-    NativeBridge = import_react_native5.NativeModules.PaywalloFBBridge ?? null;
+    NativeBridge = import_react_native6.NativeModules.PaywalloFBBridge ?? null;
     MetaBridge = class {
       constructor() {
         this.cachedAnonId = null;
@@ -1712,18 +1776,18 @@ var init_MetaBridge = __esm({
 });
 
 // src/domains/identity/InstallReferrerManager.ts
-var import_react_native6, REFERRER_TIMEOUT_MS, InstallReferrerManager, installReferrerManager;
+var import_react_native7, REFERRER_TIMEOUT_MS, InstallReferrerManager, installReferrerManager;
 var init_InstallReferrerManager = __esm({
   "src/domains/identity/InstallReferrerManager.ts"() {
     "use strict";
-    import_react_native6 = require("react-native");
+    import_react_native7 = require("react-native");
     init_NativeDeviceInfo();
     init_deferredAppLink();
     init_MetaBridge();
     REFERRER_TIMEOUT_MS = 5e3;
     InstallReferrerManager = class {
       async getReferrer() {
-        if (import_react_native6.Platform.OS !== "android") {
+        if (import_react_native7.Platform.OS !== "android") {
           return this.fetchDeferredReferrer();
         }
         let timerId;
@@ -1829,11 +1893,11 @@ function extractDeferredAttribution(raw) {
   }
   return Object.keys(out).length > 0 ? out : null;
 }
-var import_react_native7, InstallTracker, DEFERRED_ATTRIBUTION_FIELDS;
+var import_react_native8, InstallTracker, DEFERRED_ATTRIBUTION_FIELDS;
 var init_InstallTracker = __esm({
   "src/domains/identity/InstallTracker.ts"() {
     "use strict";
-    import_react_native7 = require("react-native");
+    import_react_native8 = require("react-native");
     init_SecureStorage();
     init_NativeDeviceInfo();
     init_distinctIdGuard();
@@ -1889,10 +1953,10 @@ var init_InstallTracker = __esm({
         }
         let deviceData = {};
         try {
-          const screen = import_react_native7.Dimensions.get("screen");
+          const screen = import_react_native8.Dimensions.get("screen");
           const screenWidth = Math.round(screen.width ?? 0);
           const screenHeight = Math.round(screen.height ?? 0);
-          const screenDensity = import_react_native7.PixelRatio.get();
+          const screenDensity = import_react_native8.PixelRatio.get();
           const locale = Intl.DateTimeFormat().resolvedOptions().locale ?? "unknown";
           const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone ?? "unknown";
           const info = await nativeDeviceInfo.getDeviceInfo();
@@ -1953,13 +2017,14 @@ var init_InstallTracker = __esm({
           } else {
             const { generateUUID: generateUUID2 } = await Promise.resolve().then(() => (init_uuid(), uuid_exports));
             effectiveAnonId = `PW_${generateUUID2()}`;
+            if (this.debug) console.log("[Paywallo] fb_anon_id: gerado PW_ local (Facebook Android SDK ausente no host? _fbp real indispon\xEDvel \u2014 Meta n\xE3o reconhece PW_)");
             await storage.set(INSTALL_KEYS.ANON_ID, effectiveAnonId).catch(() => {
             });
           }
         }
         await apiClient.trackEvent("$app_installed", distinctId, {
           installedAt,
-          platform: import_react_native7.Platform.OS,
+          platform: import_react_native8.Platform.OS,
           installEventId,
           ...sessionId && { sessionId },
           ...deviceData,
@@ -1981,11 +2046,11 @@ var init_InstallTracker = __esm({
           ...adIds.gaid && { gaid: adIds.gaid },
           attStatus: adIds.attStatus
         }, void 0, { priority: "critical" });
-        void this.callDeferredMatch(apiClient, deviceData, adIds, effectiveAnonId, installedAt).catch(() => {
+        void this.callDeferredMatch(apiClient, distinctId, deviceData, adIds, effectiveAnonId, installedAt).catch(() => {
         });
         await markInstallTracked(storage, installedAt);
       }
-      async callDeferredMatch(apiClient, deviceData, adIds, anonId, installedAt) {
+      async callDeferredMatch(apiClient, distinctId, deviceData, adIds, anonId, installedAt) {
         const storage = new SecureStorage(this.debug);
         const alreadyMatched = await storage.get(INSTALL_KEYS.DEFERRED_MATCH_DONE);
         if (alreadyMatched) return;
@@ -1999,7 +2064,11 @@ var init_InstallTracker = __esm({
             method: "POST",
             headers: { "Content-Type": "application/json", "X-App-Key": appKey },
             body: JSON.stringify({
-              platform: import_react_native7.Platform.OS,
+              platform: import_react_native8.Platform.OS,
+              // Sem isto o servidor não tem identificador no Android (não há IDFV) e grava a
+              // attribution com distinct_id vazio — o reader junta por
+              // install_attributions.distinct_id = app_users.external_id e nunca casa.
+              distinctId,
               ...adIds.idfv && { idfv: adIds.idfv },
               ...adIds.gaid && { gaid: adIds.gaid },
               ...referrer.rawReferrer && { installReferrer: referrer.rawReferrer },
@@ -2094,11 +2163,11 @@ function parseAttributionFromUrl(url) {
     return {};
   }
 }
-var import_react_native8, DeepLinkAttributionCapture, deepLinkAttributionCapture;
+var import_react_native9, DeepLinkAttributionCapture, deepLinkAttributionCapture;
 var init_DeepLinkAttributionCapture = __esm({
   "src/domains/identity/DeepLinkAttributionCapture.ts"() {
     "use strict";
-    import_react_native8 = require("react-native");
+    import_react_native9 = require("react-native");
     init_InstallTracker();
     DeepLinkAttributionCapture = class {
       constructor(debug = false) {
@@ -2107,7 +2176,7 @@ var init_DeepLinkAttributionCapture = __esm({
       }
       async start() {
         try {
-          const initialUrl = await import_react_native8.Linking.getInitialURL();
+          const initialUrl = await import_react_native9.Linking.getInitialURL();
           const parsed = parseAttributionFromUrl(initialUrl);
           await attributionTracker.capture(parsed).catch(() => {
           });
@@ -2120,13 +2189,13 @@ var init_DeepLinkAttributionCapture = __esm({
             void attributionTracker.capture(parsed).catch(() => {
             });
           };
-          const maybeSub = import_react_native8.Linking.addEventListener("url", handler);
+          const maybeSub = import_react_native9.Linking.addEventListener("url", handler);
           if (maybeSub && typeof maybeSub.remove === "function") {
             this.subscription = maybeSub;
           } else {
             this.subscription = {
               remove: () => {
-                const legacy = import_react_native8.Linking;
+                const legacy = import_react_native9.Linking;
                 legacy.removeEventListener?.("url", handler);
               }
             };
@@ -2161,10 +2230,10 @@ var init_identity = __esm({
 
 // src/domains/notifications/bridges/NativePushBridge.ts
 function getPaywalloNotifications() {
-  return import_react_native9.NativeModules.PaywalloNotifications ?? null;
+  return import_react_native10.NativeModules.PaywalloNotifications ?? null;
 }
 function isNativePushAvailable() {
-  return !!import_react_native9.NativeModules.PaywalloNotifications;
+  return !!import_react_native10.NativeModules.PaywalloNotifications;
 }
 function mapStatusToNumber(status) {
   switch (status) {
@@ -2186,16 +2255,16 @@ function mapStatusToNumber(status) {
 }
 function getEmitter() {
   if (_emitter) return _emitter;
-  const nativeMod = import_react_native9.NativeModules.PaywalloNotifications;
+  const nativeMod = import_react_native10.NativeModules.PaywalloNotifications;
   if (!nativeMod) return null;
-  _emitter = new import_react_native9.NativeEventEmitter(nativeMod);
+  _emitter = new import_react_native10.NativeEventEmitter(nativeMod);
   return _emitter;
 }
-var import_react_native9, _emitter, NativePushBridge;
+var import_react_native10, _emitter, NativePushBridge;
 var init_NativePushBridge = __esm({
   "src/domains/notifications/bridges/NativePushBridge.ts"() {
     "use strict";
-    import_react_native9 = require("react-native");
+    import_react_native10 = require("react-native");
     _emitter = null;
     NativePushBridge = class {
       async getToken() {
@@ -2208,7 +2277,7 @@ var init_NativePushBridge = __esm({
         }
       }
       async getAPNSToken() {
-        if (import_react_native9.Platform.OS !== "ios") return null;
+        if (import_react_native10.Platform.OS !== "ios") return null;
         return this.getToken();
       }
       async requestPermission(options) {
@@ -2301,18 +2370,15 @@ var init_constants = __esm({
 });
 
 // src/domains/notifications/config.ts
-function resolveApiBaseUrl(config) {
-  if (config.apiBaseUrl) return config.apiBaseUrl;
-  if (config.environment === "sandbox") return SANDBOX_API_BASE_URL;
+function resolveApiBaseUrl() {
   return DEFAULT_API_BASE_URL;
 }
-var DEFAULT_API_BASE_URL, SANDBOX_API_BASE_URL;
+var DEFAULT_API_BASE_URL;
 var init_config = __esm({
   "src/domains/notifications/config.ts"() {
     "use strict";
     init_constants();
     DEFAULT_API_BASE_URL = DEFAULT_API_URL;
-    SANDBOX_API_BASE_URL = DEFAULT_API_URL;
   }
 });
 
@@ -2450,13 +2516,13 @@ function getTimezone() {
   }
 }
 function detectPlatform() {
-  return import_react_native10.Platform.OS === "ios" ? "ios" : "android";
+  return import_react_native11.Platform.OS === "ios" ? "ios" : "android";
 }
-var import_react_native10, SEEN_MESSAGES_KEY, LEGACY_SEEN_MESSAGES_KEY, SEEN_TTL_MS, MAX_SEEN_SIZE, NOTIFICATION_TYPE_TO_FAMILY, NotificationEventTracker;
+var import_react_native11, SEEN_MESSAGES_KEY, LEGACY_SEEN_MESSAGES_KEY, SEEN_TTL_MS, MAX_SEEN_SIZE, NOTIFICATION_TYPE_TO_FAMILY, NotificationEventTracker;
 var init_NotificationEventTracker = __esm({
   "src/domains/notifications/NotificationEventTracker.ts"() {
     "use strict";
-    import_react_native10 = require("react-native");
+    import_react_native11 = require("react-native");
     SEEN_MESSAGES_KEY = "@paywallo:seen_messages";
     LEGACY_SEEN_MESSAGES_KEY = "seen_messages";
     SEEN_TTL_MS = 60 * 60 * 1e3;
@@ -2627,8 +2693,8 @@ var init_NotificationHandlerSetup = __esm({
 // src/core/version.ts
 function resolveVersion() {
   try {
-    if ("2.5.3") {
-      return "2.5.3";
+    if ("2.6.2") {
+      return "2.6.2";
     }
   } catch {
   }
@@ -2698,7 +2764,7 @@ function mapPermissionStatus(status) {
   }
 }
 function detectPlatform2() {
-  return import_react_native11.Platform.OS === "ios" ? "ios" : "android";
+  return import_react_native12.Platform.OS === "ios" ? "ios" : "android";
 }
 async function getAppVersion() {
   try {
@@ -2709,11 +2775,11 @@ async function getAppVersion() {
     return "unknown";
   }
 }
-var import_react_native11, AUTH_STATUS, LOCALE_WHITELIST;
+var import_react_native12, AUTH_STATUS, LOCALE_WHITELIST;
 var init_utils = __esm({
   "src/domains/notifications/utils.ts"() {
     "use strict";
-    import_react_native11 = require("react-native");
+    import_react_native12 = require("react-native");
     init_NotificationsError();
     AUTH_STATUS = {
       NOT_DETERMINED: -1,
@@ -2889,18 +2955,18 @@ function mapPermissionStatus2(status) {
   }
 }
 function getPlatform() {
-  return import_react_native12.Platform;
+  return import_react_native13.Platform;
 }
 function needsAndroidRuntimePermission(platform) {
   if (platform.OS !== "android") return false;
   const v = typeof platform.Version === "string" ? parseInt(platform.Version, 10) : platform.Version ?? 0;
   return Number.isFinite(v) && v >= ANDROID_TIRAMISU_API;
 }
-var import_react_native12, AUTH_STATUS2, ANDROID_TIRAMISU_API, PermissionManager;
+var import_react_native13, AUTH_STATUS2, ANDROID_TIRAMISU_API, PermissionManager;
 var init_PermissionManager = __esm({
   "src/domains/notifications/PermissionManager.ts"() {
     "use strict";
-    import_react_native12 = require("react-native");
+    import_react_native13 = require("react-native");
     AUTH_STATUS2 = {
       NOT_DETERMINED: -1,
       DENIED: 0,
@@ -3082,10 +3148,7 @@ var init_NotificationsManager = __esm({
       }
       applyConfig(config) {
         this.appKey = config.appKey;
-        this.apiBaseUrl = resolveApiBaseUrl({
-          apiBaseUrl: config.apiBaseUrl,
-          environment: config.environment
-        });
+        this.apiBaseUrl = resolveApiBaseUrl();
         this.debug = config.debug ?? false;
         this.permissionManager.setDebug(this.debug);
       }
@@ -3261,7 +3324,8 @@ var init_OnboardingError = __esm({
     };
     ONBOARDING_ERROR_CODES = {
       NOT_INITIALIZED: "ONBOARDING_NOT_INITIALIZED",
-      INVALID_STEP_NAME: "ONBOARDING_INVALID_STEP_NAME"
+      INVALID_STEP_NAME: "ONBOARDING_INVALID_STEP_NAME",
+      INVALID_ORDER: "ONBOARDING_INVALID_ORDER"
     };
   }
 });
@@ -3291,16 +3355,20 @@ var init_OnboardingManager = __esm({
        * Saves the step name internally for implicit drop detection on the backend.
        *
        * @param stepName - Unique name for this onboarding step.
-       * @param order - Optional explicit display order (accepts decimals, e.g. 2.1 for A/B variants).
+       * @param order - Ordem de exibição do step. Obrigatório. Aceita decimais (ex: 2.1 para variantes A/B).
+       *   Deve ser um número finito e não-negativo. O servidor faz o floor — não arredondar aqui.
        */
-      async step(stepName, order) {
+      async step(stepName, order, options) {
         this.assertConfig();
         this.validateStepName(stepName, "step");
+        this.validateOrder(order);
         this.lastStep = stepName;
-        const stepPayload = { step_name: stepName };
-        if (order !== void 0 && Number.isFinite(order) && order >= 0) {
-          stepPayload.order = order;
-        }
+        const stepPayload = {
+          step_name: stepName,
+          order,
+          ...options?.variantKey !== void 0 ? { variant_key: options.variantKey } : {},
+          ...options?.timeOnPrevS !== void 0 ? { time_on_prev_s: options.timeOnPrevS } : {}
+        };
         const payload = {
           family: "onboarding",
           type: "step",
@@ -3312,33 +3380,21 @@ var init_OnboardingManager = __esm({
        * 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) {
+      async complete(options) {
         this.assertConfig();
-        this.validateStepName(stepName, "drop");
         this.finished = true;
         const payload = {
           family: "onboarding",
-          type: "drop",
-          ...{ step_name: stepName }
+          type: "complete",
+          ...options?.variantKey !== void 0 ? { variant_key: options.variantKey } : {}
         };
-        return this.emit("onboarding", payload, "drop");
+        return this.emit("onboarding", payload, "complete");
       }
       /** 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). */
+      /** Returns whether the flow has been marked as finished (complete). */
       isFinished() {
         return this.finished;
       }
@@ -3370,6 +3426,14 @@ var init_OnboardingManager = __esm({
           );
         }
       }
+      validateOrder(order) {
+        if (order === void 0 || order === null || !Number.isFinite(order) || order < 0) {
+          throw new OnboardingError(
+            ONBOARDING_ERROR_CODES.INVALID_ORDER,
+            "OnboardingManager.step(): order deve ser um n\xFAmero finito e n\xE3o-negativo."
+          );
+        }
+      }
     };
     onboardingManager = new OnboardingManager();
   }
@@ -3647,11 +3711,11 @@ function getLocalizedString(text) {
 }
 function detectDeviceLanguage() {
   try {
-    if (import_react_native13.Platform.OS === "ios") {
-      const settings = import_react_native13.NativeModules.SettingsManager?.settings;
+    if (import_react_native14.Platform.OS === "ios") {
+      const settings = import_react_native14.NativeModules.SettingsManager?.settings;
       return settings?.AppleLocale ?? settings?.AppleLanguages?.[0] ?? "en-US";
     }
-    return import_react_native13.NativeModules.I18nManager?.localeIdentifier ?? "en-US";
+    return import_react_native14.NativeModules.I18nManager?.localeIdentifier ?? "en-US";
   } catch {
     return "en-US";
   }
@@ -3673,11 +3737,11 @@ function initLocalization(options) {
     currentLanguage = deviceLanguage;
   }
 }
-var import_react_native13, currentLanguage, defaultLanguage, SDK_STRINGS;
+var import_react_native14, currentLanguage, defaultLanguage, SDK_STRINGS;
 var init_localization = __esm({
   "src/utils/localization.ts"() {
     "use strict";
-    import_react_native13 = require("react-native");
+    import_react_native14 = require("react-native");
     currentLanguage = "pt-BR";
     defaultLanguage = "pt-BR";
     SDK_STRINGS = {
@@ -3714,48 +3778,48 @@ var init_localization = __esm({
 
 // src/domains/paywall/PaywallSkeleton.tsx
 function SkeletonBlock({ style, color, opacity }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native14.Animated.View, { style: [style, { backgroundColor: color, opacity }] });
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native15.Animated.View, { style: [style, { backgroundColor: color, opacity }] });
 }
 function PaywallSkeleton({ backgroundColor = "#FFFFFF" }) {
-  const pulse = (0, import_react3.useRef)(new import_react_native14.Animated.Value(0.4)).current;
+  const pulse = (0, import_react3.useRef)(new import_react_native15.Animated.Value(0.4)).current;
   (0, import_react3.useEffect)(() => {
-    const loop = import_react_native14.Animated.loop(
-      import_react_native14.Animated.sequence([
-        import_react_native14.Animated.timing(pulse, { toValue: 1, duration: 700, useNativeDriver: true }),
-        import_react_native14.Animated.timing(pulse, { toValue: 0.4, duration: 700, useNativeDriver: true })
+    const loop = import_react_native15.Animated.loop(
+      import_react_native15.Animated.sequence([
+        import_react_native15.Animated.timing(pulse, { toValue: 1, duration: 700, useNativeDriver: true }),
+        import_react_native15.Animated.timing(pulse, { toValue: 0.4, duration: 700, useNativeDriver: true })
       ])
     );
     loop.start();
     return () => loop.stop();
   }, [pulse]);
   const placeholder = isColorDark(backgroundColor) ? "rgba(255,255,255,0.13)" : "rgba(0,0,0,0.07)";
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native14.View, { style: [styles.container, { backgroundColor }], pointerEvents: "none", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native14.View, { style: styles.header, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SkeletonBlock, { style: styles.logo, color: placeholder, opacity: pulse }) }),
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native15.View, { style: [styles.container, { backgroundColor }], pointerEvents: "none", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native15.View, { style: styles.header, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SkeletonBlock, { style: styles.logo, color: placeholder, opacity: pulse }) }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SkeletonBlock, { style: styles.hero, color: placeholder, opacity: pulse }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native14.View, { style: styles.titleGroup, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native15.View, { style: styles.titleGroup, children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SkeletonBlock, { style: styles.titleLine, color: placeholder, opacity: pulse }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SkeletonBlock, { style: styles.titleLineShort, color: placeholder, opacity: pulse })
     ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native14.View, { style: styles.cardsRow, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native15.View, { style: styles.cardsRow, children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SkeletonBlock, { style: styles.card, color: placeholder, opacity: pulse }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SkeletonBlock, { style: styles.card, color: placeholder, opacity: pulse })
     ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native14.View, { style: styles.footerGroup, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native15.View, { style: styles.footerGroup, children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SkeletonBlock, { style: styles.cta, color: placeholder, opacity: pulse }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SkeletonBlock, { style: styles.footer, color: placeholder, opacity: pulse })
     ] })
   ] });
 }
-var import_react3, import_react_native14, import_jsx_runtime, RADIUS, styles;
+var import_react3, import_react_native15, import_jsx_runtime, RADIUS, styles;
 var init_PaywallSkeleton = __esm({
   "src/domains/paywall/PaywallSkeleton.tsx"() {
     "use strict";
     import_react3 = require("react");
-    import_react_native14 = require("react-native");
+    import_react_native15 = require("react-native");
     init_extractFirstPageBackground();
     import_jsx_runtime = require("react/jsx-runtime");
     RADIUS = 14;
-    styles = import_react_native14.StyleSheet.create({
+    styles = import_react_native15.StyleSheet.create({
       card: { borderRadius: RADIUS, flex: 1, height: 120 },
       cardsRow: { flexDirection: "row", gap: 12, marginTop: "auto", paddingHorizontal: 24 },
       container: { flex: 1, paddingBottom: 40, paddingTop: 64 },
@@ -3821,7 +3885,7 @@ function getNativeWebView() {
   if (NativeWebViewComponent) return NativeWebViewComponent;
   if (nativeWebViewLookupFailed) return null;
   try {
-    NativeWebViewComponent = (0, import_react_native15.requireNativeComponent)("PaywalloWebView");
+    NativeWebViewComponent = (0, import_react_native16.requireNativeComponent)("PaywalloWebView");
     return NativeWebViewComponent;
   } catch {
     nativeWebViewLookupFailed = true;
@@ -3830,9 +3894,9 @@ function getNativeWebView() {
 }
 function getWebViewEmitter() {
   if (webViewEmitter) return webViewEmitter;
-  const mod = import_react_native15.NativeModules.PaywalloWebViewModule;
+  const mod = import_react_native16.NativeModules.PaywalloWebViewModule;
   if (!mod) return null;
-  webViewEmitter = new import_react_native15.NativeEventEmitter(mod);
+  webViewEmitter = new import_react_native16.NativeEventEmitter(mod);
   return webViewEmitter;
 }
 async function triggerNativeHaptic(style) {
@@ -3923,10 +3987,10 @@ function PaywallWebView({
     }
   }, []);
   const injectScript = (0, import_react4.useCallback)((script) => {
-    if (import_react_native15.Platform.OS === "android") {
-      const handle = (0, import_react_native15.findNodeHandle)(webViewRef.current);
+    if (import_react_native16.Platform.OS === "android") {
+      const handle = (0, import_react_native16.findNodeHandle)(webViewRef.current);
       if (handle == null) return;
-      import_react_native15.UIManager.dispatchViewManagerCommand(handle, "injectJavaScript", [script]);
+      import_react_native16.UIManager.dispatchViewManagerCommand(handle, "injectJavaScript", [script]);
       return;
     }
     setScriptToInject(script);
@@ -3986,7 +4050,7 @@ function PaywallWebView({
           if (message.payload?.url) {
             const url = message.payload.url;
             if (/^https?:\/\//i.test(url) || /^mailto:/i.test(url) || /^itms-apps:/i.test(url) || /^market:/i.test(url)) {
-              void import_react_native15.Linking.openURL(url);
+              void import_react_native16.Linking.openURL(url);
             }
           }
           break;
@@ -4067,18 +4131,18 @@ function PaywallWebView({
     injectScript(buildPurchaseStateScript(isPurchasing));
   }, [isPurchasing, injectScript]);
   (0, import_react4.useEffect)(() => {
-    if (import_react_native15.Platform.OS !== "android") return;
+    if (import_react_native16.Platform.OS !== "android") return;
     const onBackPress = () => {
       if (!paywallDataSent.current) return false;
       injectScript(buildBackButtonScript());
       return true;
     };
-    const subscription = import_react_native15.BackHandler.addEventListener("hardwareBackPress", onBackPress);
+    const subscription = import_react_native16.BackHandler.addEventListener("hardwareBackPress", onBackPress);
     return () => subscription.remove();
   }, [injectScript]);
   if (!resolvedWebUrl || !NativeWebView) return null;
   const paywallUrl = `${resolvedWebUrl}/paywall/${paywallId}`;
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native15.View, { style: styles2.container, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native16.View, { style: styles2.container, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
     NativeWebView,
     {
       ref: webViewRef,
@@ -4091,12 +4155,12 @@ function PaywallWebView({
     }
   ) });
 }
-var import_react4, import_react_native15, import_jsx_runtime2, NativeWebViewComponent, nativeWebViewLookupFailed, webViewEmitter, styles2;
+var import_react4, import_react_native16, import_jsx_runtime2, NativeWebViewComponent, nativeWebViewLookupFailed, webViewEmitter, styles2;
 var init_PaywallWebView = __esm({
   "src/domains/paywall/PaywallWebView.tsx"() {
     "use strict";
     import_react4 = require("react");
-    import_react_native15 = require("react-native");
+    import_react_native16 = require("react-native");
     init_PaywalloClient();
     init_parseWebViewMessage();
     init_paywallScripts();
@@ -4104,7 +4168,7 @@ var init_PaywallWebView = __esm({
     NativeWebViewComponent = null;
     nativeWebViewLookupFailed = false;
     webViewEmitter = null;
-    styles2 = import_react_native15.StyleSheet.create({
+    styles2 = import_react_native16.StyleSheet.create({
       container: { flex: 1 },
       webview: { flex: 1, backgroundColor: "transparent" }
     });
@@ -4239,7 +4303,7 @@ function mapNativePurchase(native) {
     transactionId: native.transactionId,
     transactionDate: native.transactionDate,
     receipt: native.receipt,
-    platform: import_react_native16.Platform.OS
+    platform: import_react_native17.Platform.OS
   };
 }
 function normalizeTransactionUpdate(raw) {
@@ -4259,17 +4323,17 @@ function normalizeTransactionUpdate(raw) {
   if (typeof r.currency === "string") update.currency = r.currency;
   return update;
 }
-var import_react_native16, TRANSACTION_UPDATE_EVENT, PaywalloStoreKitNative, nativeStoreKit, NativeStoreKit;
+var import_react_native17, TRANSACTION_UPDATE_EVENT, PaywalloStoreKitNative, nativeStoreKit, NativeStoreKit;
 var init_NativeStoreKit = __esm({
   "src/domains/iap/NativeStoreKit.ts"() {
     "use strict";
-    import_react_native16 = require("react-native");
+    import_react_native17 = require("react-native");
     init_PaywalloClient();
     init_uuid();
     init_IdentityManager();
     init_PurchaseError();
     TRANSACTION_UPDATE_EVENT = "PaywalloTransactionUpdate";
-    PaywalloStoreKitNative = import_react_native16.NativeModules.PaywalloStoreKit ?? null;
+    PaywalloStoreKitNative = import_react_native17.NativeModules.PaywalloStoreKit ?? null;
     nativeStoreKit = {
       isAvailable: isAvailable3,
       async getProducts(productIds) {
@@ -4338,7 +4402,7 @@ var init_NativeStoreKit = __esm({
       subscribeToTransactionUpdates(listener) {
         if (!PaywalloStoreKitNative) return null;
         try {
-          const EmitterCtor = import_react_native16.NativeEventEmitter;
+          const EmitterCtor = import_react_native17.NativeEventEmitter;
           const emitter = new EmitterCtor(PaywalloStoreKitNative);
           const sub = emitter.addListener(TRANSACTION_UPDATE_EVENT, (payload) => {
             const update = normalizeTransactionUpdate(payload);
@@ -4971,11 +5035,11 @@ var init_types2 = __esm({
 });
 
 // src/core/network/NetworkMonitor.ts
-var import_react_native17, NetworkMonitorClass, networkMonitor;
+var import_react_native18, NetworkMonitorClass, networkMonitor;
 var init_NetworkMonitor = __esm({
   "src/core/network/NetworkMonitor.ts"() {
     "use strict";
-    import_react_native17 = require("react-native");
+    import_react_native18 = require("react-native");
     init_types2();
     NetworkMonitorClass = class {
       constructor() {
@@ -5004,7 +5068,7 @@ var init_NetworkMonitor = __esm({
         }, this.config.checkInterval);
       }
       setupAppStateListener() {
-        this.appStateSubscription = import_react_native17.AppState.addEventListener("change", (state) => {
+        this.appStateSubscription = import_react_native18.AppState.addEventListener("change", (state) => {
           if (state === "active") {
             if (!this.checkIntervalId) {
               this.checkIntervalId = setInterval(() => {
@@ -5226,7 +5290,7 @@ var init_QueueProcessor = __esm({
             for (const item of batch) {
               retryIds.add(item.id);
             }
-            console.error("[Paywallo:QUEUE] event batch network error \u2014 items will retry", { size: batch.length, error: error instanceof Error ? error.message : String(error) });
+            if (this.config.debug) console.log("[Paywallo:QUEUE] event batch network error \u2014 items will retry", { size: batch.length, error: error instanceof Error ? error.message : String(error) });
             this.log("Event batch threw network error - will retry", {
               size: batch.length,
               error: error instanceof Error ? error.message : String(error)
@@ -5239,7 +5303,7 @@ var init_QueueProcessor = __esm({
               processed++;
             }
             this.log("Event batch processed successfully", { size: batch.length });
-          } else if (response.status >= 400 && response.status < 500) {
+          } else if (response.status >= 400 && response.status < 500 && response.status !== 429) {
             for (const item of batch) {
               await offlineQueue.removeItem(item.id);
               failed++;
@@ -5251,7 +5315,7 @@ var init_QueueProcessor = __esm({
                 console.log("[Paywallo:QUEUE] event batch deduplicated by server \u2014 items dropped (benign)", { status: response.status, size: batch.length, error: responseError });
               }
             } else {
-              console.error("[Paywallo:QUEUE] event batch failed PERMANENTLY (4xx) \u2014 items dropped", { status: response.status, size: batch.length, responseBody: typeof response.data === "string" ? response.data.slice(0, 1e3) : JSON.stringify(response.data).slice(0, 1e3), firstItemBody: typeof batch[0].body === "string" ? batch[0].body.slice(0, 1e3) : JSON.stringify(batch[0].body).slice(0, 1e3) });
+              if (this.config.debug) console.log("[Paywallo:QUEUE] event batch failed PERMANENTLY (4xx) \u2014 items dropped", { status: response.status, size: batch.length, responseBody: typeof response.data === "string" ? response.data.slice(0, 1e3) : JSON.stringify(response.data).slice(0, 1e3), firstItemBody: typeof batch[0].body === "string" ? batch[0].body.slice(0, 1e3) : JSON.stringify(batch[0].body).slice(0, 1e3) });
             }
             this.log("Event batch failed permanently (4xx) - removing from queue", {
               status: response.status,
@@ -5262,7 +5326,7 @@ var init_QueueProcessor = __esm({
             for (const item of batch) {
               retryIds.add(item.id);
             }
-            console.error("[Paywallo:QUEUE] event batch server error (5xx) \u2014 will retry", { status: response.status, size: batch.length });
+            if (this.config.debug) console.log("[Paywallo:QUEUE] event batch server error (5xx) \u2014 will retry", { status: response.status, size: batch.length });
             this.log("Event batch failed with server error - will retry", {
               status: response.status,
               size: batch.length
@@ -5292,7 +5356,7 @@ var init_QueueProcessor = __esm({
             skipRetry: false
           });
         } catch (error) {
-          console.error("[Paywallo:QUEUE] individual item network error \u2014 will retry", { id: item.id, url: item.url, error: error instanceof Error ? error.message : String(error) });
+          if (this.config.debug) console.log("[Paywallo:QUEUE] individual item network error \u2014 will retry", { id: item.id, url: item.url, error: error instanceof Error ? error.message : String(error) });
           this.log("Request threw network error - will retry", {
             id: item.id,
             error: error instanceof Error ? error.message : String(error)
@@ -5303,7 +5367,7 @@ var init_QueueProcessor = __esm({
           this.log("Queue item processed successfully", { id: item.id });
           return { success: true, permanent: false };
         }
-        if (response.status >= 400 && response.status < 500) {
+        if (response.status >= 400 && response.status < 500 && response.status !== 429) {
           this.log("Request failed with permanent client error - removing from queue", {
             id: item.id,
             url: item.url,
@@ -5373,11 +5437,11 @@ var init_queue = __esm({
 });
 
 // src/domains/iap/IAPValidator.ts
-var import_react_native18, IAPValidator;
+var import_react_native19, IAPValidator;
 var init_IAPValidator = __esm({
   "src/domains/iap/IAPValidator.ts"() {
     "use strict";
-    import_react_native18 = require("react-native");
+    import_react_native19 = require("react-native");
     init_PaywalloClient();
     init_queue();
     init_PurchaseError();
@@ -5403,7 +5467,7 @@ var init_IAPValidator = __esm({
       async validateWithServer(purchase, productId, options) {
         const apiClient = this.getApiClientFn();
         const product = this.getProductFromCache(productId);
-        const platform = import_react_native18.Platform.OS;
+        const platform = import_react_native19.Platform.OS;
         const distinctId = PaywalloClient.getDistinctId();
         return this.validateWithRetry(
           () => apiClient.validatePurchase(
@@ -5438,7 +5502,7 @@ var init_IAPValidator = __esm({
         try {
           const apiClient = this.getApiClientFn();
           const product = this.getProductFromCache(productId);
-          const platform = import_react_native18.Platform.OS;
+          const platform = import_react_native19.Platform.OS;
           const distinctId = PaywalloClient.getDistinctId();
           const appKey = apiClient.getAppKey();
           const body = {
@@ -5478,11 +5542,11 @@ function getIAPService() {
   }
   return _instance;
 }
-var import_react_native19, IAPService, _instance;
+var import_react_native20, IAPService, _instance;
 var init_IAPService = __esm({
   "src/domains/iap/IAPService.ts"() {
     "use strict";
-    import_react_native19 = require("react-native");
+    import_react_native20 = require("react-native");
     init_PaywalloClient();
     init_IAPTransactionEmitter();
     init_IAPValidator();
@@ -5632,7 +5696,7 @@ var init_IAPService = __esm({
           const transactions = await nativeStoreKit.getActiveTransactions();
           const apiClient = this.getApiClient();
           const distinctId = PaywalloClient.getDistinctId();
-          const platform = import_react_native19.Platform.OS;
+          const platform = import_react_native20.Platform.OS;
           const results = await Promise.allSettled(
             transactions.map((tx) => {
               const product = this.productsCache.get(tx.productId);
@@ -5727,7 +5791,7 @@ function usePaywallActions(placement, paywallConfig, onResult, variantKey, campa
   const [isPurchasing, setIsPurchasing] = (0, import_react6.useState)(false);
   const isPurchasingRef = (0, import_react6.useRef)(false);
   const [isClosing, setIsClosing] = (0, import_react6.useState)(false);
-  const slideAnim = (0, import_react6.useRef)(new import_react_native20.Animated.Value(0)).current;
+  const slideAnim = (0, import_react6.useRef)(new import_react_native21.Animated.Value(0)).current;
   const presentedAtRef = (0, import_react6.useRef)(Date.now());
   const closedRef = (0, import_react6.useRef)(false);
   const { trackDismissed, trackProductSelected, trackPurchased } = usePaywallTracking();
@@ -5735,8 +5799,8 @@ function usePaywallActions(placement, paywallConfig, onResult, variantKey, campa
     if (closedRef.current) return;
     closedRef.current = true;
     const animTarget = openAnim ?? slideAnim;
-    import_react_native20.Animated.timing(animTarget, {
-      toValue: import_react_native20.Dimensions.get("window").height,
+    import_react_native21.Animated.timing(animTarget, {
+      toValue: import_react_native21.Dimensions.get("window").height,
       duration: 350,
       useNativeDriver: true
     }).start(() => {
@@ -5756,7 +5820,7 @@ function usePaywallActions(placement, paywallConfig, onResult, variantKey, campa
     closeWithReason("dismissed");
   }, [isClosing, closeWithReason]);
   (0, import_react6.useEffect)(() => {
-    const sub = import_react_native20.AppState.addEventListener("change", (nextState) => {
+    const sub = import_react_native21.AppState.addEventListener("change", (nextState) => {
       if (isPurchasingRef.current) return;
       if (nextState === "background" || nextState === "inactive") {
         closeWithReason("backgrounded");
@@ -5824,12 +5888,12 @@ function usePaywallActions(placement, paywallConfig, onResult, variantKey, campa
   }, [isPurchasing, onResult, paywallConfig, placement, trackDismissed, variantKey, campaignId, variantId]);
   return { isPurchasing, slideAnim, handleClose, handlePurchase, handleRestore };
 }
-var import_react6, import_react_native20, PAYWALL_TIMEOUT_MS;
+var import_react6, import_react_native21, PAYWALL_TIMEOUT_MS;
 var init_usePaywallActions = __esm({
   "src/domains/paywall/usePaywallActions.ts"() {
     "use strict";
     import_react6 = require("react");
-    import_react_native20 = require("react-native");
+    import_react_native21 = require("react-native");
     init_IAPService();
     init_usePaywallTracking();
     PAYWALL_TIMEOUT_MS = 30 * 60 * 1e3;
@@ -5950,11 +6014,11 @@ function ErrorFallback({ description, onRetry, onClose }) {
   const title = overrides?.title ?? getSdkString("paywallErrorTitle");
   const retryLabel = overrides?.retry ?? getSdkString("paywallRetryButton");
   const closeLabel = overrides?.close ?? getSdkString("paywallCloseButton");
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native21.View, { style: styles3.fallbackContainer, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_react_native21.View, { style: styles3.fallbackCard, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native21.Text, { style: styles3.fallbackTitle, children: title }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native21.Text, { style: styles3.fallbackDescription, children: description }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native21.Pressable, { style: styles3.retryButton, onPress: onRetry, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native21.Text, { style: styles3.retryButtonText, children: retryLabel }) }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native21.Pressable, { style: styles3.closeButton, onPress: onClose, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native21.Text, { style: styles3.closeButtonText, children: closeLabel }) })
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native22.View, { style: styles3.fallbackContainer, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_react_native22.View, { style: styles3.fallbackCard, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native22.Text, { style: styles3.fallbackTitle, children: title }),
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native22.Text, { style: styles3.fallbackDescription, children: description }),
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native22.Pressable, { style: styles3.retryButton, onPress: onRetry, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native22.Text, { style: styles3.retryButtonText, children: retryLabel }) }),
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native22.Pressable, { style: styles3.closeButton, onPress: onClose, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native22.Text, { style: styles3.closeButtonText, children: closeLabel }) })
   ] }) });
 }
 function PaywallModal({
@@ -5976,8 +6040,8 @@ function PaywallModal({
     campaignId,
     variantId
   );
-  const screenHeight = import_react_native21.Dimensions.get("window").height;
-  const openAnim = (0, import_react8.useRef)(new import_react_native21.Animated.Value(screenHeight)).current;
+  const screenHeight = import_react_native22.Dimensions.get("window").height;
+  const openAnim = (0, import_react8.useRef)(new import_react_native22.Animated.Value(screenHeight)).current;
   const [modalVisible, setModalVisible] = (0, import_react8.useState)(false);
   const handleResult = (0, import_react8.useCallback)((result) => {
     setModalVisible(false);
@@ -5987,7 +6051,7 @@ function PaywallModal({
   const [webViewError, setWebViewError] = (0, import_react8.useState)(null);
   const [retryCount, setRetryCount] = (0, import_react8.useState)(0);
   const [showSkeleton, setShowSkeleton] = (0, import_react8.useState)(true);
-  const skeletonOpacity = (0, import_react8.useRef)(new import_react_native21.Animated.Value(1)).current;
+  const skeletonOpacity = (0, import_react8.useRef)(new import_react_native22.Animated.Value(1)).current;
   const retryCountRef = (0, import_react8.useRef)(0);
   const handleWebViewError = (0, import_react8.useCallback)(
     (err) => {
@@ -6008,10 +6072,10 @@ function PaywallModal({
     skeletonOpacity.setValue(1);
   }, [skeletonOpacity]);
   const handleWebViewReady = (0, import_react8.useCallback)(() => {
-    import_react_native21.Animated.timing(skeletonOpacity, {
+    import_react_native22.Animated.timing(skeletonOpacity, {
       toValue: 0,
       duration: 250,
-      easing: import_react_native21.Easing.out(import_react_native21.Easing.cubic),
+      easing: import_react_native22.Easing.out(import_react_native22.Easing.cubic),
       useNativeDriver: true
     }).start(() => setShowSkeleton(false));
   }, [skeletonOpacity]);
@@ -6025,11 +6089,11 @@ function PaywallModal({
       setModalVisible(true);
       setShowSkeleton(true);
       skeletonOpacity.setValue(1);
-      openAnim.setValue(import_react_native21.Dimensions.get("window").height);
-      import_react_native21.Animated.timing(openAnim, {
+      openAnim.setValue(import_react_native22.Dimensions.get("window").height);
+      import_react_native22.Animated.timing(openAnim, {
         toValue: 0,
         duration: 550,
-        easing: import_react_native21.Easing.out(import_react_native21.Easing.cubic),
+        easing: import_react_native22.Easing.out(import_react_native22.Easing.cubic),
         useNativeDriver: true
       }).start();
     }
@@ -6037,7 +6101,7 @@ function PaywallModal({
   if (!modalVisible && !visible) return null;
   const skeletonBackground = paywallConfig && "craftData" in paywallConfig.config ? extractFirstPageBackground(paywallConfig.config.craftData) : "#FFFFFF";
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-    import_react_native21.Modal,
+    import_react_native22.Modal,
     {
       visible: modalVisible,
       animationType: "none",
@@ -6045,8 +6109,8 @@ function PaywallModal({
       onRequestClose: handleClose,
       transparent: true,
       statusBarTranslucent: true,
-      children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native21.View, { style: styles3.overlay, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native21.Animated.View, { style: [styles3.animatedContainer, { transform: [{ translateY: openAnim }] }], children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_react_native21.View, { style: styles3.container, children: [
-        error && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native21.View, { style: styles3.errorContainer, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native21.Text, { style: styles3.errorText, children: error.message }) }),
+      children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native22.View, { style: styles3.overlay, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native22.Animated.View, { style: [styles3.animatedContainer, { transform: [{ translateY: openAnim }] }], children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_react_native22.View, { style: styles3.container, children: [
+        error && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native22.View, { style: styles3.errorContainer, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native22.Text, { style: styles3.errorText, children: error.message }) }),
         !error && paywallConfig && "craftData" in paywallConfig.config && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_jsx_runtime3.Fragment, { children: webViewError ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
           ErrorFallback,
           {
@@ -6073,9 +6137,9 @@ function PaywallModal({
           retryCount
         ) }),
         showSkeleton && !error && !webViewError && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-          import_react_native21.Animated.View,
+          import_react_native22.Animated.View,
           {
-            style: [import_react_native21.StyleSheet.absoluteFill, { opacity: skeletonOpacity }],
+            style: [import_react_native22.StyleSheet.absoluteFill, { opacity: skeletonOpacity }],
             pointerEvents: "none",
             children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(PaywallSkeleton, { backgroundColor: skeletonBackground })
           }
@@ -6084,12 +6148,12 @@ function PaywallModal({
     }
   );
 }
-var import_react8, import_react_native21, import_jsx_runtime3, styles3;
+var import_react8, import_react_native22, import_jsx_runtime3, styles3;
 var init_PaywallModal = __esm({
   "src/domains/paywall/PaywallModal.tsx"() {
     "use strict";
     import_react8 = require("react");
-    import_react_native21 = require("react-native");
+    import_react_native22 = require("react-native");
     init_PaywalloClient();
     init_localization();
     init_extractFirstPageBackground();
@@ -6098,7 +6162,7 @@ var init_PaywallModal = __esm({
     init_usePaywallActions();
     init_usePaywallLoader();
     import_jsx_runtime3 = require("react/jsx-runtime");
-    styles3 = import_react_native21.StyleSheet.create({
+    styles3 = import_react_native22.StyleSheet.create({
       overlay: { flex: 1, backgroundColor: "rgba(0,0,0,0.3)" },
       animatedContainer: { flex: 1, backgroundColor: "#fff" },
       container: { flex: 1, backgroundColor: "#fff" },
@@ -6268,7 +6332,7 @@ function getNativeWebView2() {
   if (NativeWebViewComponent2) return NativeWebViewComponent2;
   if (nativeLookupFailed) return null;
   try {
-    NativeWebViewComponent2 = (0, import_react_native22.requireNativeComponent)("PaywalloWebView");
+    NativeWebViewComponent2 = (0, import_react_native23.requireNativeComponent)("PaywalloWebView");
     return NativeWebViewComponent2;
   } catch {
     nativeLookupFailed = true;
@@ -6291,20 +6355,20 @@ function PaywallWebViewPrewarmer({
   if (PaywalloClient.getConfig()?.debug) {
     console.log(`[Paywallo PREWARM] mounting hidden WebView: ${preheatUrl}`);
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native22.View, { pointerEvents: "none", style: styles4.hidden, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(NativeWebView, { sourceUrl: preheatUrl, style: styles4.fill }) });
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native23.View, { pointerEvents: "none", style: styles4.hidden, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(NativeWebView, { sourceUrl: preheatUrl, style: styles4.fill }) });
 }
-var import_react9, import_react_native22, import_jsx_runtime4, NativeWebViewComponent2, nativeLookupFailed, DEFAULT_DURATION_MS, styles4;
+var import_react9, import_react_native23, import_jsx_runtime4, NativeWebViewComponent2, nativeLookupFailed, DEFAULT_DURATION_MS, styles4;
 var init_PaywallWebViewPrewarmer = __esm({
   "src/domains/paywall/PaywallWebViewPrewarmer.tsx"() {
     "use strict";
     import_react9 = require("react");
-    import_react_native22 = require("react-native");
+    import_react_native23 = require("react-native");
     init_PaywalloClient();
     import_jsx_runtime4 = require("react/jsx-runtime");
     NativeWebViewComponent2 = null;
     nativeLookupFailed = false;
     DEFAULT_DURATION_MS = 60 * 1e3;
-    styles4 = import_react_native22.StyleSheet.create({
+    styles4 = import_react_native23.StyleSheet.create({
       hidden: {
         height: 1,
         left: -9999,
@@ -6821,8 +6885,9 @@ var init_schemas = __esm({
       path: ["transaction_id"]
     });
     onboardingEventSchema = import_zod.z.object({
-      type: import_zod.z.enum(["step", "complete", "drop"]),
-      step_index: import_zod.z.number().int().nonnegative().optional(),
+      type: import_zod.z.enum(["step", "complete"]),
+      family: import_zod.z.literal("onboarding").optional(),
+      order: import_zod.z.number().nonnegative().optional(),
       step_name: import_zod.z.string().optional(),
       variant_key: import_zod.z.string().optional(),
       time_on_prev_s: import_zod.z.number().nonnegative().optional()
@@ -6919,7 +6984,7 @@ function isValidEventName(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 });
+    if (state.config?.debug) console.log("[Paywallo:DROP] event dropped \u2014 no distinctId available yet", { eventName });
     return;
   }
   if (!isValidEventName(eventName)) {
@@ -7341,12 +7406,12 @@ async function detectEnvironment() {
     cached = "sandbox";
     return cached;
   }
-  if (!nativeModule) {
+  if (!nativeModule2) {
     cached = "production";
     return cached;
   }
   try {
-    const result = await nativeModule.detect();
+    const result = await nativeModule2.detect();
     cached = result === "sandbox" ? "sandbox" : "production";
     return cached;
   } catch {
@@ -7354,12 +7419,12 @@ async function detectEnvironment() {
     return cached;
   }
 }
-var import_react_native23, nativeModule, cached;
+var import_react_native24, nativeModule2, cached;
 var init_detectEnvironment = __esm({
   "src/utils/detectEnvironment.ts"() {
     "use strict";
-    import_react_native23 = require("react-native");
-    nativeModule = import_react_native23.NativeModules.PaywalloEnv ?? null;
+    import_react_native24 = require("react-native");
+    nativeModule2 = import_react_native24.NativeModules.PaywalloEnv ?? null;
     cached = null;
   }
 });
@@ -7427,6 +7492,32 @@ var init_apiPurchaseMethods = __esm({
   }
 });
 
+// src/utils/userAgent.ts
+function buildUserAgent(sdkVersion) {
+  const clean = (v) => v.replace(/[^\x20-\x7E]/g, "").replace(/[();]/g, "").trim();
+  const info = typeof nativeDeviceInfo.getCachedDeviceInfo === "function" ? nativeDeviceInfo.getCachedDeviceInfo() : null;
+  if (!info) {
+    return `PaywalloSDK/${sdkVersion} (${clean(import_react_native25.Platform.OS)})`;
+  }
+  const isValid = (v) => {
+    if (typeof v !== "string") return false;
+    const c = clean(v);
+    return c.length > 0 && c !== "unknown";
+  };
+  const parts = [clean(info.osName)];
+  if (isValid(info.systemVersion)) parts.push(clean(info.systemVersion));
+  const detail = isValid(info.model) ? `; ${clean(info.model)}` : "";
+  return `PaywalloSDK/${sdkVersion} (${parts.join(" ")}${detail})`;
+}
+var import_react_native25;
+var init_userAgent = __esm({
+  "src/utils/userAgent.ts"() {
+    "use strict";
+    import_react_native25 = require("react-native");
+    init_NativeDeviceInfo();
+  }
+});
+
 // src/core/ApiCache.ts
 var ApiCache;
 var init_ApiCache = __esm({
@@ -7654,6 +7745,11 @@ function isServerError(res) {
   const r = res;
   return r.ok === false && typeof r.status === "number" && r.status >= 500;
 }
+function isRateLimitError(res) {
+  if (typeof res !== "object" || res === null) return false;
+  const r = res;
+  return r.ok === false && r.status === 429;
+}
 async function postWithQueue(deps, url, payload, label, priority) {
   const enqueue = async () => {
     await offlineQueue.enqueue(
@@ -7665,6 +7761,11 @@ async function postWithQueue(deps, url, payload, label, priority) {
       priority
     );
   };
+  if (priority === "critical" && deps.isOfflineQueueEnabled()) {
+    await enqueue();
+    if (deps.isDebug()) console.log("[Paywallo:ApiClient] Critical event queued (write-ahead):", label);
+    return;
+  }
   if (deps.isOfflineQueueEnabled() && !networkMonitor.isOnline()) {
     await enqueue();
     if (deps.isDebug()) console.log("[Paywallo:ApiClient] Queued for offline:", label, priority ?? "normal");
@@ -7675,6 +7776,9 @@ async function postWithQueue(deps, url, payload, label, priority) {
     if (isServerError(res) && deps.isOfflineQueueEnabled()) {
       if (deps.isDebug()) console.log("[Paywallo:ApiClient] Server error, queued for retry:", label, priority ?? "normal");
       await enqueue();
+    } else if (isRateLimitError(res) && deps.isOfflineQueueEnabled()) {
+      if (deps.isDebug()) console.log("[Paywallo:ApiClient] Rate limited (429), queued for retry:", label, priority ?? "normal");
+      await enqueue();
     }
   } catch (error) {
     if (deps.isDebug()) console.log("[Paywallo:ApiClient] Request failed:", label, error);
@@ -7719,7 +7823,7 @@ function buildV2Envelope(events, providerContext) {
     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_native24.Platform.OS;
+  if (context.platform === void 0) context.platform = import_react_native26.Platform.OS;
   if (context.distinct_id === void 0 && events.length > 0) {
     context.distinct_id = events[0].distinctId;
   }
@@ -7777,11 +7881,11 @@ function splitPayloadAndContext(properties) {
   }
   return { payload, promoted };
 }
-var import_react_native24, import_zod2, v2EventSchema, v2ContextSchema, v2EnvelopeSchema, IDS_PROMO_ALIASES, CONTEXT_KEY_ALIASES;
+var import_react_native26, import_zod2, v2EventSchema, v2ContextSchema, v2EnvelopeSchema, IDS_PROMO_ALIASES, CONTEXT_KEY_ALIASES;
 var init_eventEnvelopeV2 = __esm({
   "src/core/eventEnvelopeV2.ts"() {
     "use strict";
-    import_react_native24 = require("react-native");
+    import_react_native26 = require("react-native");
     import_zod2 = require("zod");
     init_uuid();
     init_eventFamilies();
@@ -7859,11 +7963,11 @@ var init_events = __esm({
 });
 
 // src/core/EventBatcher.ts
-var import_react_native25, BATCH_MAX_SIZE, BATCH_FLUSH_MS, EVENT_NAME_REGEX, V2_BATCH_ENDPOINT, EventBatcher;
+var import_react_native27, 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_native25 = require("react-native");
+    import_react_native27 = require("react-native");
     init_eventEnvelopeV2();
     init_events();
     BATCH_MAX_SIZE = 25;
@@ -7872,10 +7976,8 @@ var init_EventBatcher = __esm({
     V2_BATCH_ENDPOINT = "/sdk/ingest/batch";
     EventBatcher = class {
       constructor(post, debug = false, contextProvider = null) {
-        this.criticalQueue = [];
         this.normalQueue = [];
         this.normalTimer = null;
-        this.criticalScheduled = false;
         this.post = post;
         this.debug = debug;
         this.contextProvider = contextProvider;
@@ -7912,14 +8014,17 @@ var init_EventBatcher = __esm({
         const event = {
           eventName,
           distinctId,
-          properties: { ...properties, platform: import_react_native25.Platform.OS },
+          properties: { ...properties, platform: import_react_native27.Platform.OS },
           timestamp: timestamp ?? Date.now(),
           environment: environment.toLowerCase()
         };
         const priority = options?.priority ?? "normal";
         if (priority === "critical") {
-          this.criticalQueue.push(event);
-          this.scheduleCriticalFlush();
+          try {
+            await this.postBatch([event], `event_critical:${event.eventName}`, "critical");
+          } catch (err) {
+            if (this.debug) console.log("[Paywallo:CRITICAL] critical event post failed", { eventName: event.eventName, error: err instanceof Error ? err.message : String(err) });
+          }
           return;
         }
         this.normalQueue.push(event);
@@ -7940,9 +8045,10 @@ var init_EventBatcher = __esm({
       }
       /**
        * Force flush of the normal queue. Critical events are never held in the
-       * normal queue, so this does not affect them (they flush on their own
-       * microtask). Exposed so callers (e.g. `AppState=background` listener in
-       * phase 2.4) can drain pending events before the app is suspended.
+       * normal queue, so this does not affect them — they are posted (and
+       * awaited) synchronously inside `track()`. Exposed so callers (e.g.
+       * `AppState=background` listener in phase 2.4) can drain pending events
+       * before the app is suspended.
        */
       async flush() {
         await this.flushNormal();
@@ -7952,28 +8058,7 @@ var init_EventBatcher = __esm({
           clearTimeout(this.normalTimer);
           this.normalTimer = null;
         }
-        this.criticalQueue = [];
         this.normalQueue = [];
-        this.criticalScheduled = false;
-      }
-      scheduleCriticalFlush() {
-        if (this.criticalScheduled) return;
-        this.criticalScheduled = true;
-        queueMicrotask(() => {
-          this.criticalScheduled = false;
-          void this.flushCritical();
-        });
-      }
-      async flushCritical() {
-        if (this.criticalQueue.length === 0) return;
-        const drained = this.criticalQueue.splice(0, this.criticalQueue.length);
-        for (const event of drained) {
-          try {
-            await this.postBatch([event], `event_critical:${event.eventName}`, "critical");
-          } catch (err) {
-            console.error("[Paywallo:CRITICAL] critical event post failed", { eventName: event.eventName, error: err instanceof Error ? err.message : String(err) });
-          }
-        }
       }
       async flushNormal() {
         if (this.normalQueue.length === 0) return;
@@ -7985,7 +8070,7 @@ var init_EventBatcher = __esm({
         try {
           await this.postBatch(batch, `event_batch:${batch.length}`);
         } catch (err) {
-          console.error("[Paywallo:NORMAL] batch post failed \u2014 relying on OfflineQueue", { batchSize: batch.length, error: err instanceof Error ? err.message : String(err) });
+          if (this.debug) console.log("[Paywallo:NORMAL] batch post failed \u2014 relying on OfflineQueue", { batchSize: batch.length, error: err instanceof Error ? err.message : String(err) });
         }
       }
       async postBatch(events, label, priority = "normal") {
@@ -8000,7 +8085,7 @@ var init_EventBatcher = __esm({
         const parsed = v2EnvelopeSchema.safeParse(envelope);
         if (!parsed.success) {
           if (this.debug) console.log("[Paywallo EVENTS] V2 envelope schema validation failed:", parsed.error.issues);
-          console.error("[Paywallo:CRITICAL] V2 envelope schema validation failed", { issues: parsed.error.issues, eventCount: events.length, firstEventName: events[0]?.eventName, context: providerContext });
+          if (this.debug) console.log("[Paywallo:CRITICAL] V2 envelope schema validation failed", { issues: parsed.error.issues, eventCount: events.length, firstEventName: events[0]?.eventName, context: providerContext });
           throw parsed.error;
         }
         await this.post(V2_BATCH_ENDPOINT, parsed.data, label, priority);
@@ -8258,6 +8343,7 @@ function buildPiiPayload(pii) {
   if (dob) result.dateOfBirth = dob;
   const g = normalizeGender(pii.gender);
   if (g) result.gender = g;
+  if (pii.zipCode) result.zipCode = pii.zipCode.trim();
   return result;
 }
 function normalizeGender(raw) {
@@ -8267,12 +8353,13 @@ function normalizeGender(raw) {
   if (lower === "f" || lower === "female") return "f";
   return void 0;
 }
-var import_react_native26, DATE_OF_BIRTH_RE, ApiClient;
+var import_react_native28, DATE_OF_BIRTH_RE, ApiClient;
 var init_ApiClient = __esm({
   "src/core/ApiClient.ts"() {
     "use strict";
-    import_react_native26 = require("react-native");
+    import_react_native28 = require("react-native");
     init_apiPurchaseMethods();
+    init_userAgent();
     init_ApiCache();
     init_ApiClientFlags();
     init_ApiClientQueue();
@@ -8372,10 +8459,13 @@ var init_ApiClient = __esm({
        * should carry. Keep this tiny — it runs once per ApiClient instance.
        */
       buildSdkHeaders() {
+        const ua = buildUserAgent(SDK_VERSION);
         return {
           "x-sdk-version": SDK_VERSION,
-          "x-sdk-platform": import_react_native26.Platform.OS,
-          "x-sdk-environment": this.environment
+          "x-sdk-platform": import_react_native28.Platform.OS,
+          "x-sdk-environment": this.environment,
+          "User-Agent": ua,
+          "x-sdk-user-agent": ua
         };
       }
       async clearQueue() {
@@ -8404,7 +8494,7 @@ var init_ApiClient = __esm({
             message,
             context,
             sdkVersion: SDK_VERSION,
-            platform: import_react_native26.Platform.OS
+            platform: import_react_native28.Platform.OS
           }, true);
         } catch (err) {
           if (this.debug) console.log("[Paywallo:ApiClient] reportError failed", err);
@@ -8422,7 +8512,7 @@ var init_ApiClient = __esm({
       async identify(distinctId, properties, email, deviceId, pii) {
         const rawTraits = {
           email: email || void 0,
-          platform: import_react_native26.Platform.OS,
+          platform: import_react_native28.Platform.OS,
           name: properties?.name,
           country: properties?.country,
           locale: properties?.locale,
@@ -8618,7 +8708,6 @@ function setupNotifications(apiClient, config, environment, eventPipeline) {
     notificationsManager.setupHandlers({ eventBatcher: eventPipeline });
     notificationsManager.initialize({
       appKey: config.appKey,
-      apiBaseUrl: DEFAULT_API_URL,
       debug: config.debug,
       environment: environment === "Sandbox" ? "sandbox" : "production"
     }).catch((err) => {
@@ -8660,7 +8749,6 @@ var init_PaywalloInitHelpers = __esm({
     init_identity();
     init_notifications();
     init_NativePushBridge();
-    init_constants();
     init_SecureStorage();
   }
 });
@@ -8750,7 +8838,7 @@ function reportInitFailure(state, config, error, reason) {
       error: error instanceof Error ? error.message : String(error)
     });
   } catch (err) {
-    console.error("[Paywallo] reportInitFailure error", err);
+    if (config.debug) console.log("[Paywallo] reportInitFailure error", err);
   }
 }
 function reportInitSuccess(state, config, attempts) {
@@ -8759,7 +8847,7 @@ function reportInitSuccess(state, config, attempts) {
       void state.apiClient.reportError("INIT_RECOVERED", `Succeeded after ${attempts} retries`, { attempts });
     }
   } catch (err) {
-    console.error("[Paywallo] reportInitSuccess error", err);
+    if (config.debug) console.log("[Paywallo] reportInitSuccess error", err);
   }
 }
 async function resolveSessionFlags(state, keys, apiClient, distinctId) {
@@ -8835,9 +8923,14 @@ async function doInit(state, config) {
   } catch (err) {
     if (config.debug) console.log("[Paywallo ATTR] start error", err);
   }
-  void nativeDeviceInfo.getDeviceInfo().catch(() => null);
-  void advertisingIdManager.collect(false).catch(() => null);
-  void metaBridge.getAnonymousID().catch(() => null);
+  await Promise.race([
+    Promise.all([
+      nativeDeviceInfo.getDeviceInfo().catch(() => null),
+      advertisingIdManager.collect(false).catch(() => null),
+      metaBridge.getAnonymousID().catch(() => null)
+    ]),
+    new Promise((resolve) => setTimeout(resolve, 350))
+  ]);
   apiClient.setEventContextProvider(() => {
     const attr = attributionTracker.get();
     const attrEntries = attr ? [
@@ -8874,10 +8967,10 @@ async function doInit(state, config) {
     let screenHeight;
     let screenDensity;
     try {
-      const screen = import_react_native27.Dimensions.get("screen");
+      const screen = import_react_native29.Dimensions.get("screen");
       screenWidth = Math.round(screen.width) || void 0;
       screenHeight = Math.round(screen.height) || void 0;
-      screenDensity = import_react_native27.PixelRatio.get() || void 0;
+      screenDensity = import_react_native29.PixelRatio.get() || void 0;
     } catch {
     }
     return {
@@ -8913,12 +9006,15 @@ async function doInit(state, config) {
   setupNotifications(apiClient, config, environment, eventPipeline);
   if (config.autoStartSession !== false) {
     sessionManager.startSession().catch((err) => {
-      console.error("[Paywallo INIT] autoStart session error", err);
+      if (config.debug) console.log("[Paywallo INIT] autoStart session error", err);
     });
   }
   new InstallTracker(config.debug, {
     distinctIdProvider: () => identityManager.getDistinctId()
-  }).trackIfNeeded(apiClient, config.requestATT === true).catch(() => {
+  }).trackIfNeeded(apiClient, config.requestATT === true).then(() => {
+    if (config.debug) console.log("[Paywallo INSTALL] $app_installed sent");
+  }).catch(() => {
+    if (config.debug) console.log("[Paywallo INSTALL] $app_installed failed \u2014 will retry on next launch");
   });
   if (config.sessionFlags && config.sessionFlags.length > 0) {
     await resolveSessionFlags(state, config.sessionFlags, apiClient, distinctId);
@@ -8944,11 +9040,11 @@ async function doInit(state, config) {
   setupAutoPreload(state, apiClient, config, distinctId);
   startBatchPreload(apiClient, config.debug);
 }
-var import_react_native27;
+var import_react_native29;
 var init_PaywalloInitializer = __esm({
   "src/core/PaywalloInitializer.ts"() {
     "use strict";
-    import_react_native27 = require("react-native");
+    import_react_native29 = require("react-native");
     init_identity();
     init_AdvertisingIdManager();
     init_DeepLinkAttributionCapture();
@@ -9155,6 +9251,7 @@ var init_PaywalloClient = __esm({
         }
         if (this.state.config?.debug) console.log("[Paywallo IDENTIFY]", options ? { hasEmail: "email" in options && !!options.email, hasProperties: "properties" in options } : void 0);
         await identityManager.identify(options);
+        if (this.state.config?.debug) console.log("[Paywallo IDENTIFY] done");
       }
       async track(eventName, options) {
         return trackEvent(this.getApiClientOrThrow(), this.state, eventName, options);
@@ -9389,7 +9486,7 @@ __export(OfferingService_exports, {
   offeringService: () => offeringService
 });
 function resolveProductId(raw) {
-  const isIos = import_react_native28.Platform.OS === "ios";
+  const isIos = import_react_native30.Platform.OS === "ios";
   const productId = isIos ? raw.apple_product_id : raw.google_product_id;
   return productId ?? "";
 }
@@ -9408,7 +9505,7 @@ function mapProduct2(raw) {
   };
 }
 function pickPlatformProduct(products) {
-  const isIos = import_react_native28.Platform.OS === "ios";
+  const isIos = import_react_native30.Platform.OS === "ios";
   const match = products.find((p) => isIos ? p.apple_product_id : p.google_product_id);
   return match ?? products[0] ?? null;
 }
@@ -9424,11 +9521,11 @@ function mapOffering(raw) {
     product: mapProduct2(rawProduct)
   };
 }
-var import_react_native28, OFFERINGS_CACHE_KEY, DEFAULT_TTL3, OfferingService, offeringService;
+var import_react_native30, OFFERINGS_CACHE_KEY, DEFAULT_TTL3, OfferingService, offeringService;
 var init_OfferingService = __esm({
   "src/domains/offering/OfferingService.ts"() {
     "use strict";
-    import_react_native28 = require("react-native");
+    import_react_native30 = require("react-native");
     init_SecureStorage();
     OFFERINGS_CACHE_KEY = "@paywallo:offerings_cache";
     DEFAULT_TTL3 = 5 * 60 * 1e3;
@@ -9715,18 +9812,14 @@ var import_react15 = require("react");
 init_onboarding();
 function useOnboarding() {
   const step = (0, import_react15.useCallback)(
-    (stepName, order) => onboardingManager.step(stepName, order),
+    (stepName, order, options) => onboardingManager.step(stepName, order, options),
     []
   );
   const complete = (0, import_react15.useCallback)(
-    () => onboardingManager.complete(),
-    []
-  );
-  const drop = (0, import_react15.useCallback)(
-    (stepName) => onboardingManager.drop(stepName),
+    (options) => onboardingManager.complete(options),
     []
   );
-  return { step, complete, drop };
+  return { step, complete };
 }
 
 // src/hooks/usePaywallo.ts
@@ -10094,7 +10187,7 @@ function useSubscription() {
 
 // src/PaywalloProvider.tsx
 var import_react28 = require("react");
-var import_react_native29 = require("react-native");
+var import_react_native31 = require("react-native");
 init_PaywalloClient();
 init_NativeStorage();
 init_SecureStorage();
@@ -10986,8 +11079,8 @@ function PaywalloProvider({ children, config }) {
     });
   }, []);
   const { showingPreloadedWebView, presentPreloadedWebView, resolvePreloadedPaywall, handlePreloadedWebViewReady: baseHandlePreloadedWebViewReady, handlePreloadedClose: baseHandlePreloadedClose, setShowingPreloadedWebView, presentedAtRef } = usePaywallPresenter(preloadedWebView, setPreloadedWebView);
-  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 SCREEN_HEIGHT = (0, import_react28.useMemo)(() => import_react_native31.Dimensions.get("window").height, []);
+  const slideAnim = (0, import_react28.useRef)(new import_react_native31.Animated.Value(SCREEN_HEIGHT)).current;
   const handlePreloadedWebViewReady = (0, import_react28.useCallback)(() => {
     if (PaywalloClient.getConfig()?.debug) {
       console.log(`[Paywallo WEBVIEW] loaded \u2014 placement: ${preloadedWebView?.placement}`);
@@ -10996,7 +11089,7 @@ function PaywalloProvider({ children, config }) {
   }, [preloadedWebView?.placement, baseHandlePreloadedWebViewReady]);
   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(() => {
+    import_react_native31.Animated.timing(slideAnim, { toValue: SCREEN_HEIGHT, duration: 200, easing: import_react_native31.Easing.in(import_react_native31.Easing.cubic), useNativeDriver: true }).start(() => {
       baseHandlePreloadedClose();
       if (placement) triggerRepreload(placement);
     });
@@ -11040,6 +11133,7 @@ function PaywalloProvider({ children, config }) {
       void pushAttributionToSuperwall(configRef.current.debug);
       setDistinctId(PaywalloClient.getDistinctId());
       setIsInitialized(true);
+      if (configRef.current.debug) console.log("[Paywallo] SDK ready", PaywalloClient.getDistinctId()?.slice(0, 8));
       if (!autoPreloadTriggeredRef.current) {
         autoPreloadTriggeredRef.current = true;
         const placement = await PaywalloClient.waitForAutoPreloadedPlacement();
@@ -11280,7 +11374,7 @@ function PaywalloProvider({ children, config }) {
   (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();
+      import_react_native31.Animated.timing(slideAnim, { toValue: 0, duration: 200, easing: import_react_native31.Easing.out(import_react_native31.Easing.cubic), useNativeDriver: true }).start();
     }
   }, [showingPreloadedWebView, slideAnim, SCREEN_HEIGHT]);
   const preloadStyle = [
@@ -11290,7 +11384,7 @@ function PaywalloProvider({ children, config }) {
   ];
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(PaywalloContext.Provider, { value: contextValue, children: [
     children,
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PaywallErrorBoundary, { children: !!preloadedWebView?.craftData && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react_native29.Animated.View, { style: preloadStyle, pointerEvents: showingPreloadedWebView ? "auto" : "none", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PaywallErrorBoundary, { children: !!preloadedWebView?.craftData && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react_native31.Animated.View, { style: preloadStyle, pointerEvents: showingPreloadedWebView ? "auto" : "none", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
       PaywallWebView,
       {
         paywallId: preloadedWebView.paywallId,
@@ -11322,7 +11416,7 @@ function PaywalloProvider({ children, config }) {
     isInitialized && (config.preloadPaywalls?.length ?? 0) > 0 && PaywalloClient.getWebUrl() !== null && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PaywallWebViewPrewarmer, { webUrl: PaywalloClient.getWebUrl() })
   ] });
 }
-var styles5 = import_react_native29.StyleSheet.create({
+var styles5 = import_react_native31.StyleSheet.create({
   preloadOverlay: { position: "absolute", top: 0, left: 0, right: 0, bottom: 0, backgroundColor: "#ffffff" },
   hidden: { zIndex: -1, opacity: 0, width: 1, height: 1, overflow: "hidden" },
   visible: { zIndex: 9999, opacity: 1 }