@virex-tech/paywallo-sdk 2.5.3 → 2.6.2

package/dist/index.mjs

@@ -475,7 +475,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";
@@ -494,6 +494,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";
@@ -544,6 +545,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;
@@ -598,7 +600,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 {
@@ -639,6 +641,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, {
@@ -646,11 +652,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() {
@@ -693,6 +703,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),
@@ -701,7 +712,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() {
@@ -713,7 +725,8 @@ var init_IdentityManager = __esm({
           firstName: this.firstName,
           lastName: this.lastName,
           dateOfBirth: this.dateOfBirth,
-          gender: this.gender
+          gender: this.gender,
+          zipCode: this.zipCode
         };
       }
       isSecureStorageAvailable() {
@@ -931,17 +944,39 @@ var init_campaign = __esm({
   }
 });
 
+// src/domains/identity/NativeAdvertisingId.ts
+import { NativeModules as NativeModules2 } from "react-native";
+var nativeModule, nativeAdvertisingId;
+var init_NativeAdvertisingId = __esm({
+  "src/domains/identity/NativeAdvertisingId.ts"() {
+    "use strict";
+    nativeModule = NativeModules2.PaywalloAdvertisingId ?? null;
+    nativeAdvertisingId = {
+      async getAdvertisingId() {
+        try {
+          return await nativeModule?.getAdvertisingId?.() ?? null;
+        } catch {
+          return null;
+        }
+      }
+    };
+  }
+});
+
 // src/domains/identity/AdvertisingIdManager.ts
 import { Platform as Platform2 } from "react-native";
-var ZERO_IDFA, AdvertisingIdManager, advertisingIdManager;
+var ZERO_IDFA, ATT_PROMPT_TIMEOUT_MS, AdvertisingIdManager, advertisingIdManager;
 var init_AdvertisingIdManager = __esm({
   "src/domains/identity/AdvertisingIdManager.ts"() {
     "use strict";
     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
@@ -956,6 +991,9 @@ var init_AdvertisingIdManager = __esm({
           return this.cached;
         }
         const fallback = { idfv: null, idfa: null, gaid: null, attStatus: "unavailable" };
+        if (Platform2.OS === "android") {
+          return this.collectAndroid();
+        }
         try {
           const tracking = await import("expo-tracking-transparency");
           if (Platform2.OS === "ios") {
@@ -969,9 +1007,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;
@@ -979,12 +1028,6 @@ var init_AdvertisingIdManager = __esm({
             if (idfv !== null) this.cached = result;
             return result;
           }
-          if (Platform2.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 {
@@ -992,6 +1035,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;
@@ -1598,13 +1662,13 @@ var init_deferredAppLink = __esm({
 });
 
 // src/domains/identity/MetaBridge.ts
-import { NativeModules as NativeModules2 } from "react-native";
+import { NativeModules as NativeModules3 } from "react-native";
 var TIMEOUT_MS, NativeBridge, MetaBridge, metaBridge;
 var init_MetaBridge = __esm({
   "src/domains/identity/MetaBridge.ts"() {
     "use strict";
     TIMEOUT_MS = 2e3;
-    NativeBridge = NativeModules2.PaywalloFBBridge ?? null;
+    NativeBridge = NativeModules3.PaywalloFBBridge ?? null;
     MetaBridge = class {
       constructor() {
         this.cachedAnonId = null;
@@ -1937,6 +2001,7 @@ 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(() => {
             });
           }
@@ -1965,11 +2030,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;
@@ -1984,6 +2049,10 @@ var init_InstallTracker = __esm({
             headers: { "Content-Type": "application/json", "X-App-Key": appKey },
             body: JSON.stringify({
               platform: Platform4.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 },
@@ -2144,12 +2213,12 @@ var init_identity = __esm({
 });
 
 // src/domains/notifications/bridges/NativePushBridge.ts
-import { NativeEventEmitter, NativeModules as NativeModules3, Platform as Platform5 } from "react-native";
+import { NativeEventEmitter, NativeModules as NativeModules4, Platform as Platform5 } from "react-native";
 function getPaywalloNotifications() {
-  return NativeModules3.PaywalloNotifications ?? null;
+  return NativeModules4.PaywalloNotifications ?? null;
 }
 function isNativePushAvailable() {
-  return !!NativeModules3.PaywalloNotifications;
+  return !!NativeModules4.PaywalloNotifications;
 }
 function mapStatusToNumber(status) {
   switch (status) {
@@ -2171,7 +2240,7 @@ function mapStatusToNumber(status) {
 }
 function getEmitter() {
   if (_emitter) return _emitter;
-  const nativeMod = NativeModules3.PaywalloNotifications;
+  const nativeMod = NativeModules4.PaywalloNotifications;
   if (!nativeMod) return null;
   _emitter = new NativeEventEmitter(nativeMod);
   return _emitter;
@@ -2285,18 +2354,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;
   }
 });
 
@@ -2611,8 +2677,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 {
   }
@@ -3066,10 +3132,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);
       }
@@ -3245,7 +3308,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"
     };
   }
 });
@@ -3275,16 +3339,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",
@@ -3296,33 +3364,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;
       }
@@ -3354,6 +3410,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();
   }
@@ -3612,7 +3676,7 @@ var init_paywallHeartbeat = __esm({
 });
 
 // src/utils/localization.ts
-import { NativeModules as NativeModules4, Platform as Platform9 } from "react-native";
+import { NativeModules as NativeModules5, Platform as Platform9 } from "react-native";
 function setCurrentLanguage(language) {
   currentLanguage = language;
 }
@@ -3633,10 +3697,10 @@ function getLocalizedString(text) {
 function detectDeviceLanguage() {
   try {
     if (Platform9.OS === "ios") {
-      const settings = NativeModules4.SettingsManager?.settings;
+      const settings = NativeModules5.SettingsManager?.settings;
       return settings?.AppleLocale ?? settings?.AppleLanguages?.[0] ?? "en-US";
     }
-    return NativeModules4.I18nManager?.localeIdentifier ?? "en-US";
+    return NativeModules5.I18nManager?.localeIdentifier ?? "en-US";
   } catch {
     return "en-US";
   }
@@ -3807,7 +3871,7 @@ import {
   findNodeHandle,
   Linking as Linking2,
   NativeEventEmitter as NativeEventEmitter2,
-  NativeModules as NativeModules5,
+  NativeModules as NativeModules6,
   Platform as Platform10,
   requireNativeComponent,
   StyleSheet as StyleSheet2,
@@ -3828,7 +3892,7 @@ function getNativeWebView() {
 }
 function getWebViewEmitter() {
   if (webViewEmitter) return webViewEmitter;
-  const mod = NativeModules5.PaywalloWebViewModule;
+  const mod = NativeModules6.PaywalloWebViewModule;
   if (!mod) return null;
   webViewEmitter = new NativeEventEmitter2(mod);
   return webViewEmitter;
@@ -4162,7 +4226,7 @@ __export(NativeStoreKit_exports, {
   NativeStoreKit: () => NativeStoreKit,
   nativeStoreKit: () => nativeStoreKit
 });
-import { NativeEventEmitter as NativeEventEmitter3, NativeModules as NativeModules6, Platform as Platform11 } from "react-native";
+import { NativeEventEmitter as NativeEventEmitter3, NativeModules as NativeModules7, Platform as Platform11 } from "react-native";
 function isAvailable3() {
   return PaywalloStoreKitNative != null;
 }
@@ -4264,7 +4328,7 @@ var init_NativeStoreKit = __esm({
     init_IdentityManager();
     init_PurchaseError();
     TRANSACTION_UPDATE_EVENT = "PaywalloTransactionUpdate";
-    PaywalloStoreKitNative = NativeModules6.PaywalloStoreKit ?? null;
+    PaywalloStoreKitNative = NativeModules7.PaywalloStoreKit ?? null;
     nativeStoreKit = {
       isAvailable: isAvailable3,
       async getProducts(productIds) {
@@ -5221,7 +5285,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)
@@ -5234,7 +5298,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++;
@@ -5246,7 +5310,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,
@@ -5257,7 +5321,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
@@ -5287,7 +5351,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)
@@ -5298,7 +5362,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,
@@ -6821,8 +6885,9 @@ var init_schemas = __esm({
       path: ["transaction_id"]
     });
     onboardingEventSchema = z.object({
-      type: z.enum(["step", "complete", "drop"]),
-      step_index: z.number().int().nonnegative().optional(),
+      type: z.enum(["step", "complete"]),
+      family: z.literal("onboarding").optional(),
+      order: z.number().nonnegative().optional(),
       step_name: z.string().optional(),
       variant_key: z.string().optional(),
       time_on_prev_s: 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)) {
@@ -7335,19 +7400,19 @@ var init_SubscriptionManager = __esm({
 });
 
 // src/utils/detectEnvironment.ts
-import { NativeModules as NativeModules7 } from "react-native";
+import { NativeModules as NativeModules8 } from "react-native";
 async function detectEnvironment() {
   if (cached !== null) return cached;
   if (typeof globalThis.__DEV__ !== "undefined" && globalThis.__DEV__) {
     cached = "sandbox";
     return cached;
   }
-  if (!nativeModule) {
+  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 {
@@ -7355,11 +7420,11 @@ async function detectEnvironment() {
     return cached;
   }
 }
-var nativeModule, cached;
+var nativeModule2, cached;
 var init_detectEnvironment = __esm({
   "src/utils/detectEnvironment.ts"() {
     "use strict";
-    nativeModule = NativeModules7.PaywalloEnv ?? null;
+    nativeModule2 = NativeModules8.PaywalloEnv ?? null;
     cached = null;
   }
 });
@@ -7427,6 +7492,31 @@ var init_apiPurchaseMethods = __esm({
   }
 });
 
+// src/utils/userAgent.ts
+import { Platform as Platform14 } from "react-native";
+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(Platform14.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 init_userAgent = __esm({
+  "src/utils/userAgent.ts"() {
+    "use strict";
+    init_NativeDeviceInfo();
+  }
+});
+
 // src/core/ApiCache.ts
 var ApiCache;
 var init_ApiCache = __esm({
@@ -7654,6 +7744,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 +7760,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 +7775,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);
@@ -7694,7 +7797,7 @@ var init_ApiClientQueue = __esm({
 });
 
 // src/core/eventEnvelopeV2.ts
-import { Platform as Platform14 } from "react-native";
+import { Platform as Platform15 } from "react-native";
 import { z as z2 } from "zod";
 function buildV2Envelope(events, providerContext) {
   const context = { ...providerContext };
@@ -7721,7 +7824,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 = Platform14.OS;
+  if (context.platform === void 0) context.platform = Platform15.OS;
   if (context.distinct_id === void 0 && events.length > 0) {
     context.distinct_id = events[0].distinctId;
   }
@@ -7859,7 +7962,7 @@ var init_events = __esm({
 });
 
 // src/core/EventBatcher.ts
-import { Platform as Platform15 } from "react-native";
+import { Platform as Platform16 } from "react-native";
 var BATCH_MAX_SIZE, BATCH_FLUSH_MS, EVENT_NAME_REGEX, V2_BATCH_ENDPOINT, EventBatcher;
 var init_EventBatcher = __esm({
   "src/core/EventBatcher.ts"() {
@@ -7872,10 +7975,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 +8013,17 @@ var init_EventBatcher = __esm({
         const event = {
           eventName,
           distinctId,
-          properties: { ...properties, platform: Platform15.OS },
+          properties: { ...properties, platform: Platform16.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 +8044,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 +8057,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 +8069,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 +8084,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);
@@ -8238,7 +8322,7 @@ var init_http = __esm({
 });
 
 // src/core/ApiClient.ts
-import { Platform as Platform16 } from "react-native";
+import { Platform as Platform17 } from "react-native";
 function normalizeDateOfBirth(raw) {
   if (!raw) return void 0;
   if (DATE_OF_BIRTH_RE.test(raw)) return raw;
@@ -8259,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) {
@@ -8273,6 +8358,7 @@ var init_ApiClient = __esm({
   "src/core/ApiClient.ts"() {
     "use strict";
     init_apiPurchaseMethods();
+    init_userAgent();
     init_ApiCache();
     init_ApiClientFlags();
     init_ApiClientQueue();
@@ -8372,10 +8458,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": Platform16.OS,
-          "x-sdk-environment": this.environment
+          "x-sdk-platform": Platform17.OS,
+          "x-sdk-environment": this.environment,
+          "User-Agent": ua,
+          "x-sdk-user-agent": ua
         };
       }
       async clearQueue() {
@@ -8404,7 +8493,7 @@ var init_ApiClient = __esm({
             message,
             context,
             sdkVersion: SDK_VERSION,
-            platform: Platform16.OS
+            platform: Platform17.OS
           }, true);
         } catch (err) {
           if (this.debug) console.log("[Paywallo:ApiClient] reportError failed", err);
@@ -8422,7 +8511,7 @@ var init_ApiClient = __esm({
       async identify(distinctId, properties, email, deviceId, pii) {
         const rawTraits = {
           email: email || void 0,
-          platform: Platform16.OS,
+          platform: Platform17.OS,
           name: properties?.name,
           country: properties?.country,
           locale: properties?.locale,
@@ -8618,7 +8707,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 +8748,6 @@ var init_PaywalloInitHelpers = __esm({
     init_identity();
     init_notifications();
     init_NativePushBridge();
-    init_constants();
     init_SecureStorage();
   }
 });
@@ -8751,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) {
@@ -8760,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) {
@@ -8836,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 ? [
@@ -8914,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);
@@ -9154,6 +9249,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);
@@ -9387,9 +9483,9 @@ __export(OfferingService_exports, {
   OfferingService: () => OfferingService,
   offeringService: () => offeringService
 });
-import { Platform as Platform17 } from "react-native";
+import { Platform as Platform18 } from "react-native";
 function resolveProductId(raw) {
-  const isIos = Platform17.OS === "ios";
+  const isIos = Platform18.OS === "ios";
   const productId = isIos ? raw.apple_product_id : raw.google_product_id;
   return productId ?? "";
 }
@@ -9408,7 +9504,7 @@ function mapProduct2(raw) {
   };
 }
 function pickPlatformProduct(products) {
-  const isIos = Platform17.OS === "ios";
+  const isIos = Platform18.OS === "ios";
   const match = products.find((p) => isIos ? p.apple_product_id : p.google_product_id);
   return match ?? products[0] ?? null;
 }
@@ -9635,18 +9731,14 @@ init_onboarding();
 import { useCallback as useCallback9 } from "react";
 function useOnboarding() {
   const step = useCallback9(
-    (stepName, order) => onboardingManager.step(stepName, order),
+    (stepName, order, options) => onboardingManager.step(stepName, order, options),
     []
   );
   const complete = useCallback9(
-    () => onboardingManager.complete(),
-    []
-  );
-  const drop = useCallback9(
-    (stepName) => onboardingManager.drop(stepName),
+    (options) => onboardingManager.complete(options),
     []
   );
-  return { step, complete, drop };
+  return { step, complete };
 }
 
 // src/hooks/usePaywallo.ts
@@ -10960,6 +11052,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();