@virex-tech/paywallo-sdk 2.5.2 → 2.6.0

package/dist/index.js

@@ -664,9 +664,12 @@ var init_IdentityManager = __esm({
               dateOfBirth: this.dateOfBirth ?? void 0,
               gender: this.gender ?? 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() {
@@ -2301,18 +2304,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;
   }
 });
 
@@ -2627,8 +2627,8 @@ var init_NotificationHandlerSetup = __esm({
 // src/core/version.ts
 function resolveVersion() {
   try {
-    if ("2.5.2") {
-      return "2.5.2";
+    if ("2.6.0") {
+      return "2.6.0";
     }
   } catch {
   }
@@ -3082,10 +3082,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 +3258,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 +3289,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 +3314,21 @@ var init_OnboardingManager = __esm({
        * Tracks successful completion of the onboarding flow.
        * Marks the flow as finished.
        */
-      async complete() {
+      async complete(options) {
         this.assertConfig();
         this.finished = true;
-        return this.emit("onboarding", { family: "onboarding", type: "complete" }, "complete");
-      }
-      /**
-       * Tracks an explicit drop (abandonment) at the given step.
-       * Marks the flow as finished.
-       *
-       * @param stepName - The step name where the user dropped off.
-       */
-      async drop(stepName) {
-        this.assertConfig();
-        this.validateStepName(stepName, "drop");
-        this.finished = true;
         const payload = {
           family: "onboarding",
-          type: "drop",
-          ...{ step_name: stepName }
+          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 +3360,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();
   }
@@ -4111,17 +4109,292 @@ var init_PaywallWebView = __esm({
   }
 });
 
+// src/domains/iap/PurchaseError.ts
+function createPurchaseError(code, message) {
+  return new PurchaseError(
+    PURCHASE_ERROR_CODES[code],
+    message ?? DEFAULT_MESSAGES[code] ?? "Unknown purchase error",
+    code === "USER_CANCELLED"
+  );
+}
+var PurchaseError, PURCHASE_ERROR_CODES, DEFAULT_MESSAGES;
+var init_PurchaseError = __esm({
+  "src/domains/iap/PurchaseError.ts"() {
+    "use strict";
+    init_PaywalloError();
+    PurchaseError = class extends PaywalloError {
+      constructor(code, message, userCancelled = false, httpStatus) {
+        super("purchase", code, message);
+        this.name = "PurchaseError";
+        this.userCancelled = userCancelled;
+        this.httpStatus = httpStatus;
+      }
+    };
+    PURCHASE_ERROR_CODES = {
+      NOT_INITIALIZED: "PURCHASE_NOT_INITIALIZED",
+      PRODUCT_NOT_FOUND: "PRODUCT_NOT_FOUND",
+      PURCHASE_FAILED: "PURCHASE_FAILED",
+      RESTORE_FAILED: "RESTORE_FAILED",
+      VALIDATION_FAILED: "VALIDATION_FAILED",
+      USER_CANCELLED: "USER_CANCELLED",
+      NETWORK_ERROR: "PURCHASE_NETWORK_ERROR",
+      STORE_ERROR: "PURCHASE_STORE_ERROR",
+      PENDING_PURCHASE: "PURCHASE_PENDING",
+      DEFERRED_PURCHASE: "PURCHASE_DEFERRED",
+      STORE_NOT_AVAILABLE: "PURCHASE_STORE_NOT_AVAILABLE"
+    };
+    DEFAULT_MESSAGES = {
+      NOT_INITIALIZED: "Purchase controller not initialized. Call init() first.",
+      PRODUCT_NOT_FOUND: "Product not found in store.",
+      PURCHASE_FAILED: "Purchase failed. Please try again.",
+      RESTORE_FAILED: "Failed to restore purchases. Please try again.",
+      VALIDATION_FAILED: "Failed to validate purchase with server.",
+      USER_CANCELLED: "Purchase was cancelled.",
+      NETWORK_ERROR: "Network error. Please check your connection.",
+      STORE_ERROR: "Store error. Please try again later.",
+      PENDING_PURCHASE: "Purchase is pending approval.",
+      DEFERRED_PURCHASE: "Purchase is deferred (e.g., parental approval required).",
+      STORE_NOT_AVAILABLE: "In-app purchases are not available on this device."
+    };
+  }
+});
+
+// src/domains/iap/NativeStoreKit.ts
+var NativeStoreKit_exports = {};
+__export(NativeStoreKit_exports, {
+  NativeStoreKit: () => NativeStoreKit,
+  nativeStoreKit: () => nativeStoreKit
+});
+function isAvailable3() {
+  return PaywalloStoreKitNative != null;
+}
+function mapNativeProduct(native) {
+  const product = {
+    productId: native.productId,
+    title: native.title,
+    description: native.description,
+    price: native.price,
+    priceValue: native.priceValue,
+    currency: native.currency ?? "USD",
+    localizedPrice: native.localizedPrice,
+    type: mapProductType(native.type),
+    subscriptionPeriod: native.subscriptionPeriod,
+    introductoryPrice: native.introductoryPrice,
+    introductoryPriceValue: native.introductoryPriceValue,
+    freeTrialPeriod: native.freeTrialPeriod
+  };
+  if (native.subscriptionPeriod) {
+    const prices = calculatePerPeriodPrices(native.priceValue, native.subscriptionPeriod);
+    product.pricePerMonth = prices.perMonth;
+    product.pricePerWeek = prices.perWeek;
+    product.pricePerDay = prices.perDay;
+  }
+  return product;
+}
+function mapProductType(type) {
+  switch (type) {
+    case "subscription":
+    case "autoRenewable":
+      return "subscription";
+    case "consumable":
+      return "consumable";
+    default:
+      return "non_consumable";
+  }
+}
+function calculatePerPeriodPrices(priceValue, period) {
+  const totalDays = periodToDays(period);
+  if (totalDays <= 0) return {};
+  const perDay = priceValue / totalDays;
+  const perWeek = perDay * 7;
+  const perMonth = perDay * 30;
+  return {
+    perDay: perDay.toFixed(2),
+    perWeek: perWeek.toFixed(2),
+    perMonth: perMonth.toFixed(2)
+  };
+}
+function periodToDays(period) {
+  const match = period.match(/^P(\d+)([DWMY])$/);
+  if (!match) return 0;
+  const value = parseInt(match[1], 10);
+  switch (match[2]) {
+    case "D":
+      return value;
+    case "W":
+      return value * 7;
+    case "M":
+      return value * 30;
+    case "Y":
+      return value * 365;
+    default:
+      return 0;
+  }
+}
+function mapNativePurchase(native) {
+  return {
+    productId: native.productId,
+    transactionId: native.transactionId,
+    transactionDate: native.transactionDate,
+    receipt: native.receipt,
+    platform: import_react_native16.Platform.OS
+  };
+}
+function normalizeTransactionUpdate(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const r = raw;
+  const type = r.type;
+  if (type !== "renewed" && type !== "refunded" && type !== "canceled") return null;
+  const transactionId = typeof r.transactionId === "string" ? r.transactionId : null;
+  const productId = typeof r.productId === "string" ? r.productId : null;
+  if (!transactionId) return null;
+  const update = {
+    type,
+    transactionId,
+    productId: productId ?? ""
+  };
+  if (typeof r.amount === "number") update.amount = r.amount;
+  if (typeof r.currency === "string") update.currency = r.currency;
+  return update;
+}
+var import_react_native16, TRANSACTION_UPDATE_EVENT, PaywalloStoreKitNative, nativeStoreKit, NativeStoreKit;
+var init_NativeStoreKit = __esm({
+  "src/domains/iap/NativeStoreKit.ts"() {
+    "use strict";
+    import_react_native16 = require("react-native");
+    init_PaywalloClient();
+    init_uuid();
+    init_IdentityManager();
+    init_PurchaseError();
+    TRANSACTION_UPDATE_EVENT = "PaywalloTransactionUpdate";
+    PaywalloStoreKitNative = import_react_native16.NativeModules.PaywalloStoreKit ?? null;
+    nativeStoreKit = {
+      isAvailable: isAvailable3,
+      async getProducts(productIds) {
+        if (!PaywalloStoreKitNative) {
+          return [];
+        }
+        const nativeProducts = await PaywalloStoreKitNative.getProducts(productIds);
+        return nativeProducts.map(mapNativeProduct);
+      },
+      async purchase(productId) {
+        if (!PaywalloStoreKitNative) {
+          throw new PurchaseError(
+            PURCHASE_ERROR_CODES.STORE_NOT_AVAILABLE,
+            "StoreKit native module not available"
+          );
+        }
+        const distinctId = identityManager.getDistinctId();
+        const rawUuid = distinctId?.startsWith("$paywallo_anon:") ? distinctId.slice("$paywallo_anon:".length) : distinctId;
+        const appAccountToken = isValidUUIDv4(rawUuid) ? rawUuid : null;
+        if (distinctId && appAccountToken === null) {
+          if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] distinctId is not a valid UUID v4 \u2014 passing null to appAccountToken:", distinctId);
+        }
+        try {
+          const result = await PaywalloStoreKitNative.purchase(productId, appAccountToken);
+          if (!result || result.pending) {
+            return null;
+          }
+          return mapNativePurchase(result);
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          if (message.toLowerCase().includes("cancel")) {
+            throw new PurchaseError(PURCHASE_ERROR_CODES.USER_CANCELLED, message, true);
+          }
+          throw new PurchaseError(PURCHASE_ERROR_CODES.PURCHASE_FAILED, message);
+        }
+      },
+      async finishTransaction(transactionId) {
+        if (!PaywalloStoreKitNative) return;
+        try {
+          await PaywalloStoreKitNative.finishTransaction(transactionId);
+        } catch (err) {
+          console.error("[Paywallo] finishTransaction native error", err);
+        }
+      },
+      async getActiveTransactions() {
+        if (!PaywalloStoreKitNative) return [];
+        try {
+          const results = await PaywalloStoreKitNative.getActiveTransactions();
+          return results.map(mapNativePurchase);
+        } catch (err) {
+          console.error("[Paywallo] getActiveTransactions failed", err);
+          return [];
+        }
+      },
+      /**
+       * Subscribes to native transaction update events (renewals, refunds,
+       * cancellations) from StoreKit 2 (`Transaction.updates`) on iOS or
+       * `PurchasesUpdatedListener` + refund diff on Android.
+       *
+       * Returns a subscription with a `remove()` method. The caller is
+       * responsible for cleanup (typically on `Paywallo.reset()`).
+       *
+       * Returns `null` when the native module isn't available (non-mobile env,
+       * native module not linked) — callers should treat null as a no-op.
+       */
+      subscribeToTransactionUpdates(listener) {
+        if (!PaywalloStoreKitNative) return null;
+        try {
+          const EmitterCtor = import_react_native16.NativeEventEmitter;
+          const emitter = new EmitterCtor(PaywalloStoreKitNative);
+          const sub = emitter.addListener(TRANSACTION_UPDATE_EVENT, (payload) => {
+            const update = normalizeTransactionUpdate(payload);
+            if (update) listener(update);
+          });
+          return { remove: () => sub.remove() };
+        } catch (err) {
+          if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] subscribeToTransactionUpdates failed", err);
+          return null;
+        }
+      }
+    };
+    NativeStoreKit = nativeStoreKit;
+  }
+});
+
 // src/domains/iap/IAPTransactionEmitter.ts
 var IAPTransactionEmitter;
 var init_IAPTransactionEmitter = __esm({
   "src/domains/iap/IAPTransactionEmitter.ts"() {
     "use strict";
     init_PaywalloClient();
+    init_NativeStoreKit();
     IAPTransactionEmitter = class {
       constructor(getProductFromCache, getApiClientFn, getDebug) {
         this.getProductFromCache = getProductFromCache;
         this.getApiClientFn = getApiClientFn;
         this.getDebug = getDebug;
+        this.transactionUpdateSubscription = null;
+      }
+      /**
+       * Emits `transaction {type: "completed"}` after a server-validated purchase.
+       * Fire-and-forget — a tracking failure must never poison the purchase flow.
+       */
+      async emitTransactionCompleted(purchase, productId, options) {
+        try {
+          const apiClient = this.getApiClientFn();
+          if (!apiClient) return;
+          const distinctId = PaywalloClient.getDistinctId();
+          if (!distinctId) return;
+          const product = this.getProductFromCache(productId);
+          const properties = {
+            type: "completed",
+            tx_id: purchase.transactionId,
+            product_id: purchase.productId
+          };
+          if (product?.priceValue !== void 0 && product.priceValue > 0) {
+            properties.amount = product.priceValue;
+          }
+          if (product?.currency) {
+            properties.currency = product.currency;
+          }
+          if (options?.paywallId) properties.paywall_id = options.paywallId;
+          if (options?.variantId) properties.variant_id = options.variantId;
+          await apiClient.trackEvent("transaction", distinctId, properties, void 0, { priority: "critical" });
+        } catch (err) {
+          if (this.getDebug()) console.log("[Paywallo PURCHASE] transaction event emission failed", err);
+        }
       }
       /**
        * Emits `checkout_started` quando o usuário inicia a compra (toca em comprar),
@@ -4150,15 +4423,65 @@ var init_IAPTransactionEmitter = __esm({
         }
       }
       /**
-       * No-op. Native transaction update listener removed — sale events are sourced
-       * exclusively from server-side webhooks (Apple/Google/Superwall/RevenueCat).
+       * Forwards a native transaction update to the EventBatcher.
+       * Public so tests can exercise the wiring without a fake NativeEventEmitter.
+       */
+      async emitTransactionUpdate(update) {
+        try {
+          const apiClient = this.getApiClientFn() ?? PaywalloClient.getApiClient();
+          if (!apiClient) {
+            if (this.getDebug()) console.log("[Paywallo IAP] transaction update dropped (no apiClient)", update.type);
+            return;
+          }
+          const distinctId = PaywalloClient.getDistinctId();
+          if (!distinctId) {
+            if (this.getDebug()) console.log("[Paywallo IAP] transaction update dropped (no distinctId)", update.type);
+            return;
+          }
+          const properties = {
+            type: update.type,
+            tx_id: update.transactionId,
+            product_id: update.productId
+          };
+          if (update.type !== "canceled") {
+            const cached2 = this.getProductFromCache(update.productId);
+            const amount = update.amount ?? cached2?.priceValue;
+            const currency = update.currency ?? cached2?.currency;
+            if (typeof amount === "number" && amount > 0) properties.amount = amount;
+            if (currency) properties.currency = currency;
+          }
+          await apiClient.trackEvent("transaction", distinctId, properties, void 0, { priority: "critical" });
+          if (this.getDebug()) console.log(`[Paywallo IAP] emitted transaction {${update.type}}`, update.transactionId);
+        } catch (err) {
+          if (this.getDebug()) console.log("[Paywallo IAP] transaction update emission failed", err);
+        }
+      }
+      /**
+       * Starts listening to native Transaction.updates. Idempotent.
        */
       startListener() {
+        if (this.transactionUpdateSubscription) return;
+        this.transactionUpdateSubscription = nativeStoreKit.subscribeToTransactionUpdates(
+          (update) => {
+            void this.emitTransactionUpdate(update);
+          }
+        );
+        if (this.getDebug() && this.transactionUpdateSubscription) {
+          console.log("[Paywallo IAP] transaction update listener started");
+        }
       }
       /**
-       * No-op. See startListener.
+       * Removes the native listener. Safe to call multiple times.
        */
       stopListener() {
+        if (!this.transactionUpdateSubscription) return;
+        try {
+          this.transactionUpdateSubscription.remove();
+        } catch (err) {
+          if (this.getDebug()) console.log("[Paywallo IAP] transaction listener removal failed", err);
+        }
+        this.transactionUpdateSubscription = null;
+        if (this.getDebug()) console.log("[Paywallo IAP] transaction update listener stopped");
       }
     };
   }
@@ -4646,11 +4969,11 @@ var init_types2 = __esm({
 });
 
 // src/core/network/NetworkMonitor.ts
-var import_react_native16, NetworkMonitorClass, networkMonitor;
+var import_react_native17, NetworkMonitorClass, networkMonitor;
 var init_NetworkMonitor = __esm({
   "src/core/network/NetworkMonitor.ts"() {
     "use strict";
-    import_react_native16 = require("react-native");
+    import_react_native17 = require("react-native");
     init_types2();
     NetworkMonitorClass = class {
       constructor() {
@@ -4679,7 +5002,7 @@ var init_NetworkMonitor = __esm({
         }, this.config.checkInterval);
       }
       setupAppStateListener() {
-        this.appStateSubscription = import_react_native16.AppState.addEventListener("change", (state) => {
+        this.appStateSubscription = import_react_native17.AppState.addEventListener("change", (state) => {
           if (state === "active") {
             if (!this.checkIntervalId) {
               this.checkIntervalId = setInterval(() => {
@@ -4901,7 +5224,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)
@@ -4914,7 +5237,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++;
@@ -4926,7 +5249,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,
@@ -4937,7 +5260,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
@@ -4967,7 +5290,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)
@@ -4978,7 +5301,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,
@@ -5024,85 +5347,35 @@ var init_QueueProcessor = __esm({
           this.queueUnsubscribe();
           this.queueUnsubscribe = null;
         }
-        this.httpClient = null;
-        this.initialized = false;
-      }
-      log(...args) {
-        if (this.config.debug) console.log("[Paywallo:QueueProcessor]", ...args);
-      }
-      setDebug(debug) {
-        this.config.debug = debug;
-      }
-    };
-    queueProcessor = new QueueProcessorClass();
-  }
-});
-
-// src/core/queue/index.ts
-var init_queue = __esm({
-  "src/core/queue/index.ts"() {
-    "use strict";
-    init_OfflineQueue();
-    init_QueueProcessor();
-  }
-});
-
-// src/domains/iap/PurchaseError.ts
-function createPurchaseError(code, message) {
-  return new PurchaseError(
-    PURCHASE_ERROR_CODES[code],
-    message ?? DEFAULT_MESSAGES[code] ?? "Unknown purchase error",
-    code === "USER_CANCELLED"
-  );
-}
-var PurchaseError, PURCHASE_ERROR_CODES, DEFAULT_MESSAGES;
-var init_PurchaseError = __esm({
-  "src/domains/iap/PurchaseError.ts"() {
-    "use strict";
-    init_PaywalloError();
-    PurchaseError = class extends PaywalloError {
-      constructor(code, message, userCancelled = false, httpStatus) {
-        super("purchase", code, message);
-        this.name = "PurchaseError";
-        this.userCancelled = userCancelled;
-        this.httpStatus = httpStatus;
+        this.httpClient = null;
+        this.initialized = false;
+      }
+      log(...args) {
+        if (this.config.debug) console.log("[Paywallo:QueueProcessor]", ...args);
+      }
+      setDebug(debug) {
+        this.config.debug = debug;
       }
     };
-    PURCHASE_ERROR_CODES = {
-      NOT_INITIALIZED: "PURCHASE_NOT_INITIALIZED",
-      PRODUCT_NOT_FOUND: "PRODUCT_NOT_FOUND",
-      PURCHASE_FAILED: "PURCHASE_FAILED",
-      RESTORE_FAILED: "RESTORE_FAILED",
-      VALIDATION_FAILED: "VALIDATION_FAILED",
-      USER_CANCELLED: "USER_CANCELLED",
-      NETWORK_ERROR: "PURCHASE_NETWORK_ERROR",
-      STORE_ERROR: "PURCHASE_STORE_ERROR",
-      PENDING_PURCHASE: "PURCHASE_PENDING",
-      DEFERRED_PURCHASE: "PURCHASE_DEFERRED",
-      STORE_NOT_AVAILABLE: "PURCHASE_STORE_NOT_AVAILABLE"
-    };
-    DEFAULT_MESSAGES = {
-      NOT_INITIALIZED: "Purchase controller not initialized. Call init() first.",
-      PRODUCT_NOT_FOUND: "Product not found in store.",
-      PURCHASE_FAILED: "Purchase failed. Please try again.",
-      RESTORE_FAILED: "Failed to restore purchases. Please try again.",
-      VALIDATION_FAILED: "Failed to validate purchase with server.",
-      USER_CANCELLED: "Purchase was cancelled.",
-      NETWORK_ERROR: "Network error. Please check your connection.",
-      STORE_ERROR: "Store error. Please try again later.",
-      PENDING_PURCHASE: "Purchase is pending approval.",
-      DEFERRED_PURCHASE: "Purchase is deferred (e.g., parental approval required).",
-      STORE_NOT_AVAILABLE: "In-app purchases are not available on this device."
-    };
+    queueProcessor = new QueueProcessorClass();
+  }
+});
+
+// src/core/queue/index.ts
+var init_queue = __esm({
+  "src/core/queue/index.ts"() {
+    "use strict";
+    init_OfflineQueue();
+    init_QueueProcessor();
   }
 });
 
 // src/domains/iap/IAPValidator.ts
-var import_react_native17, IAPValidator;
+var import_react_native18, IAPValidator;
 var init_IAPValidator = __esm({
   "src/domains/iap/IAPValidator.ts"() {
     "use strict";
-    import_react_native17 = require("react-native");
+    import_react_native18 = require("react-native");
     init_PaywalloClient();
     init_queue();
     init_PurchaseError();
@@ -5128,7 +5401,7 @@ var init_IAPValidator = __esm({
       async validateWithServer(purchase, productId, options) {
         const apiClient = this.getApiClientFn();
         const product = this.getProductFromCache(productId);
-        const platform = import_react_native17.Platform.OS;
+        const platform = import_react_native18.Platform.OS;
         const distinctId = PaywalloClient.getDistinctId();
         return this.validateWithRetry(
           () => apiClient.validatePurchase(
@@ -5163,7 +5436,7 @@ var init_IAPValidator = __esm({
         try {
           const apiClient = this.getApiClientFn();
           const product = this.getProductFromCache(productId);
-          const platform = import_react_native17.Platform.OS;
+          const platform = import_react_native18.Platform.OS;
           const distinctId = PaywalloClient.getDistinctId();
           const appKey = apiClient.getAppKey();
           const body = {
@@ -5195,200 +5468,6 @@ var init_IAPValidator = __esm({
   }
 });
 
-// src/domains/iap/NativeStoreKit.ts
-var NativeStoreKit_exports = {};
-__export(NativeStoreKit_exports, {
-  NativeStoreKit: () => NativeStoreKit,
-  nativeStoreKit: () => nativeStoreKit
-});
-function isAvailable3() {
-  return PaywalloStoreKitNative != null;
-}
-function mapNativeProduct(native) {
-  const product = {
-    productId: native.productId,
-    title: native.title,
-    description: native.description,
-    price: native.price,
-    priceValue: native.priceValue,
-    currency: native.currency ?? "USD",
-    localizedPrice: native.localizedPrice,
-    type: mapProductType(native.type),
-    subscriptionPeriod: native.subscriptionPeriod,
-    introductoryPrice: native.introductoryPrice,
-    introductoryPriceValue: native.introductoryPriceValue,
-    freeTrialPeriod: native.freeTrialPeriod
-  };
-  if (native.subscriptionPeriod) {
-    const prices = calculatePerPeriodPrices(native.priceValue, native.subscriptionPeriod);
-    product.pricePerMonth = prices.perMonth;
-    product.pricePerWeek = prices.perWeek;
-    product.pricePerDay = prices.perDay;
-  }
-  return product;
-}
-function mapProductType(type) {
-  switch (type) {
-    case "subscription":
-    case "autoRenewable":
-      return "subscription";
-    case "consumable":
-      return "consumable";
-    default:
-      return "non_consumable";
-  }
-}
-function calculatePerPeriodPrices(priceValue, period) {
-  const totalDays = periodToDays(period);
-  if (totalDays <= 0) return {};
-  const perDay = priceValue / totalDays;
-  const perWeek = perDay * 7;
-  const perMonth = perDay * 30;
-  return {
-    perDay: perDay.toFixed(2),
-    perWeek: perWeek.toFixed(2),
-    perMonth: perMonth.toFixed(2)
-  };
-}
-function periodToDays(period) {
-  const match = period.match(/^P(\d+)([DWMY])$/);
-  if (!match) return 0;
-  const value = parseInt(match[1], 10);
-  switch (match[2]) {
-    case "D":
-      return value;
-    case "W":
-      return value * 7;
-    case "M":
-      return value * 30;
-    case "Y":
-      return value * 365;
-    default:
-      return 0;
-  }
-}
-function mapNativePurchase(native) {
-  return {
-    productId: native.productId,
-    transactionId: native.transactionId,
-    transactionDate: native.transactionDate,
-    receipt: native.receipt,
-    platform: import_react_native18.Platform.OS
-  };
-}
-function normalizeTransactionUpdate(raw) {
-  if (!raw || typeof raw !== "object") return null;
-  const r = raw;
-  const type = r.type;
-  if (type !== "renewed" && type !== "refunded" && type !== "canceled") return null;
-  const transactionId = typeof r.transactionId === "string" ? r.transactionId : null;
-  const productId = typeof r.productId === "string" ? r.productId : null;
-  if (!transactionId) return null;
-  const update = {
-    type,
-    transactionId,
-    productId: productId ?? ""
-  };
-  if (typeof r.amount === "number") update.amount = r.amount;
-  if (typeof r.currency === "string") update.currency = r.currency;
-  return update;
-}
-var import_react_native18, TRANSACTION_UPDATE_EVENT, PaywalloStoreKitNative, nativeStoreKit, NativeStoreKit;
-var init_NativeStoreKit = __esm({
-  "src/domains/iap/NativeStoreKit.ts"() {
-    "use strict";
-    import_react_native18 = require("react-native");
-    init_PaywalloClient();
-    init_uuid();
-    init_IdentityManager();
-    init_PurchaseError();
-    TRANSACTION_UPDATE_EVENT = "PaywalloTransactionUpdate";
-    PaywalloStoreKitNative = import_react_native18.NativeModules.PaywalloStoreKit ?? null;
-    nativeStoreKit = {
-      isAvailable: isAvailable3,
-      async getProducts(productIds) {
-        if (!PaywalloStoreKitNative) {
-          return [];
-        }
-        const nativeProducts = await PaywalloStoreKitNative.getProducts(productIds);
-        return nativeProducts.map(mapNativeProduct);
-      },
-      async purchase(productId) {
-        if (!PaywalloStoreKitNative) {
-          throw new PurchaseError(
-            PURCHASE_ERROR_CODES.STORE_NOT_AVAILABLE,
-            "StoreKit native module not available"
-          );
-        }
-        const distinctId = identityManager.getDistinctId();
-        const rawUuid = distinctId?.startsWith("$paywallo_anon:") ? distinctId.slice("$paywallo_anon:".length) : distinctId;
-        const appAccountToken = isValidUUIDv4(rawUuid) ? rawUuid : null;
-        if (distinctId && appAccountToken === null) {
-          if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] distinctId is not a valid UUID v4 \u2014 passing null to appAccountToken:", distinctId);
-        }
-        try {
-          const result = await PaywalloStoreKitNative.purchase(productId, appAccountToken);
-          if (!result || result.pending) {
-            return null;
-          }
-          return mapNativePurchase(result);
-        } catch (err) {
-          const message = err instanceof Error ? err.message : String(err);
-          if (message.toLowerCase().includes("cancel")) {
-            throw new PurchaseError(PURCHASE_ERROR_CODES.USER_CANCELLED, message, true);
-          }
-          throw new PurchaseError(PURCHASE_ERROR_CODES.PURCHASE_FAILED, message);
-        }
-      },
-      async finishTransaction(transactionId) {
-        if (!PaywalloStoreKitNative) return;
-        try {
-          await PaywalloStoreKitNative.finishTransaction(transactionId);
-        } catch (err) {
-          console.error("[Paywallo] finishTransaction native error", err);
-        }
-      },
-      async getActiveTransactions() {
-        if (!PaywalloStoreKitNative) return [];
-        try {
-          const results = await PaywalloStoreKitNative.getActiveTransactions();
-          return results.map(mapNativePurchase);
-        } catch (err) {
-          console.error("[Paywallo] getActiveTransactions failed", err);
-          return [];
-        }
-      },
-      /**
-       * Subscribes to native transaction update events (renewals, refunds,
-       * cancellations) from StoreKit 2 (`Transaction.updates`) on iOS or
-       * `PurchasesUpdatedListener` + refund diff on Android.
-       *
-       * Returns a subscription with a `remove()` method. The caller is
-       * responsible for cleanup (typically on `Paywallo.reset()`).
-       *
-       * Returns `null` when the native module isn't available (non-mobile env,
-       * native module not linked) — callers should treat null as a no-op.
-       */
-      subscribeToTransactionUpdates(listener) {
-        if (!PaywalloStoreKitNative) return null;
-        try {
-          const EmitterCtor = import_react_native18.NativeEventEmitter;
-          const emitter = new EmitterCtor(PaywalloStoreKitNative);
-          const sub = emitter.addListener(TRANSACTION_UPDATE_EVENT, (payload) => {
-            const update = normalizeTransactionUpdate(payload);
-            if (update) listener(update);
-          });
-          return { remove: () => sub.remove() };
-        } catch (err) {
-          if (PaywalloClient.getConfig()?.debug) console.log("[Paywallo] subscribeToTransactionUpdates failed", err);
-          return null;
-        }
-      }
-    };
-    NativeStoreKit = nativeStoreKit;
-  }
-});
-
 // src/domains/iap/IAPService.ts
 function getIAPService() {
   if (!_instance) {
@@ -5489,8 +5568,8 @@ var init_IAPService = __esm({
       stopTransactionListener() {
         this.emitter.stopListener();
       }
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
-      async emitTransactionUpdate(_update) {
+      async emitTransactionUpdate(update) {
+        return this.emitter.emitTransactionUpdate(update);
       }
       async purchase(productId, options) {
         if (!nativeStoreKit.isAvailable()) {
@@ -5519,6 +5598,10 @@ var init_IAPService = __esm({
             if (this.debug) console.log(`[Paywallo PURCHASE] ${productId} server validated`);
             await this.finishTransaction(purchase.transactionId);
             if (this.debug) console.log(`[Paywallo PURCHASE] ${productId} finished`);
+            await this.emitter.emitTransactionCompleted(purchase, productId, {
+              paywallId: options?.paywallId,
+              variantId: options?.variantId
+            });
           }).catch(async (err) => {
             const kind = this.validator.classifyValidationError(err);
             if (kind === "server4xx") {
@@ -6736,8 +6819,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()
@@ -6834,7 +6918,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)) {
@@ -7569,6 +7653,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(
@@ -7590,6 +7679,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);
@@ -7886,7 +7978,7 @@ var init_EventBatcher = __esm({
           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) });
+            if (this.debug) console.log("[Paywallo:CRITICAL] critical event post failed", { eventName: event.eventName, error: err instanceof Error ? err.message : String(err) });
           }
         }
       }
@@ -7900,7 +7992,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") {
@@ -7915,7 +8007,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);
@@ -8533,7 +8625,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) => {
@@ -8575,7 +8666,6 @@ var init_PaywalloInitHelpers = __esm({
     init_identity();
     init_notifications();
     init_NativePushBridge();
-    init_constants();
     init_SecureStorage();
   }
 });
@@ -8665,7 +8755,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) {
@@ -8674,7 +8764,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) {
@@ -8828,12 +8918,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);
@@ -9070,6 +9163,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);
@@ -9630,18 +9724,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
@@ -10265,10 +10355,57 @@ function buildCallbacks() {
       const identifier = "paywallIdentifier" in safe && typeof safe.paywallIdentifier === "string" ? safe.paywallIdentifier : productId;
       log2("onPurchase", { productId, identifier });
       void trackPaywallEvent("purchased", identifier, ts, { product_id: productId });
+    },
+    // Global Superwall event listener — used specifically for `transactionComplete`
+    // which is the only event that exposes the full product (currency/price) +
+    // transaction (storeTransactionId) shape needed to create a server-side
+    // `transactions` row. Other events are skipped (paywallOpen/Dismiss already
+    // handled above with their typed callbacks).
+    onSuperwallEvent: (info) => {
+      const ev = info?.event;
+      if (!ev || ev.event !== "transactionComplete") return;
+      const ts = Date.now();
+      const product = ev.product;
+      const transaction = ev.transaction;
+      if (!product) {
+        log2("transactionComplete missing product \u2014 skipping transaction track");
+        return;
+      }
+      const productId = product.productIdentifier ?? product.id ?? "unknown";
+      const currency = product.currencyCode ?? "USD";
+      const price = product.price ?? 0;
+      const transactionId = transaction?.purchaseToken ?? transaction?.storeTransactionId ?? transaction?.originalTransactionIdentifier ?? `${productId}_${String(ts)}`;
+      const introPrice = product.trialPeriodPrice ?? 0;
+      const isTrial = product.hasFreeTrial === true && introPrice <= 0;
+      const isPaidIntro = introPrice > 0;
+      const paywallIdentifier = ev.paywallInfo?.identifier;
+      log2("onSuperwallEvent: transactionComplete", { productId, currency, price, introPrice, transactionId, isTrial });
+      void (async () => {
+        try {
+          await PaywalloClient.track("transaction", {
+            priority: "critical",
+            properties: {
+              type: isTrial ? "trial_started" : "completed",
+              // Server's IngestTranslator looks for `transaction_id`/`product_id`
+              // /`amount`/`currency`/`paywall_id` keys. A free trial MUST carry
+              // amount=0 (no revenue at start); a paid intro offer carries its
+              // intro amount (real revenue); a normal purchase carries `price`.
+              // `full_price` carries the recurring full price so the server can
+              // value the eventual conversion (free trial) or keep the headline
+              // price alongside the discounted intro amount (paid intro).
+              transaction_id: transactionId,
+              product_id: productId,
+              amount: isTrial ? 0 : isPaidIntro ? introPrice : price,
+              currency,
+              ...isTrial || isPaidIntro ? { full_price: price } : {},
+              ...paywallIdentifier ? { paywall_id: paywallIdentifier } : {}
+            }
+          });
+        } catch (err) {
+          log2("transactionComplete track error", { err: String(err) });
+        }
+      })();
     }
-    // onSuperwallEvent (transactionComplete → transaction track) removed —
-    // sale/transaction events are sourced exclusively from server-side webhooks
-    // (Apple/Google/Superwall/RevenueCat), the single source of truth for revenue.
   };
 }
 function startSuperwallAutoBridge(debug = false) {
@@ -10908,6 +11045,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();