@virex-tech/paywallo-sdk 2.2.5 → 2.2.7

package/dist/index.mjs

@@ -814,9 +814,9 @@ var init_CampaignGateService = __esm({
         }
       }
       getPreloadedCampaign(placement) {
-        const cached = this.preloadedCampaigns.get(placement);
-        if (!cached) return null;
-        const age = Date.now() - cached.preloadedAt;
+        const cached2 = this.preloadedCampaigns.get(placement);
+        if (!cached2) return null;
+        const age = Date.now() - cached2.preloadedAt;
         if (age >= PRELOAD_CACHE_TTL_MS) {
           this.preloadedCampaigns.delete(placement);
           return null;
@@ -825,7 +825,7 @@ var init_CampaignGateService = __esm({
           void this.preloadCampaign(this.apiClientRef, placement).catch(() => {
           });
         }
-        return cached.campaign;
+        return cached2.campaign;
       }
       async preloadAllActive(apiClient, debug) {
         this.apiClientRef = apiClient;
@@ -2157,7 +2157,7 @@ function extractPayload(data) {
 }
 function setupForegroundHandler(deps, onReceive) {
   const { bridge, tracker, debug } = deps;
-  const unsubscribe = bridge.onMessage(async (message) => {
+  const unsubscribe2 = bridge.onMessage(async (message) => {
     const data = message.data ?? {};
     const payload = extractPayload({
       ...data,
@@ -2175,7 +2175,7 @@ function setupForegroundHandler(deps, onReceive) {
       messageId
     });
   });
-  return unsubscribe;
+  return unsubscribe2;
 }
 var init_ForegroundHandler = __esm({
   "src/domains/notifications/handlers/ForegroundHandler.ts"() {
@@ -2370,8 +2370,8 @@ var init_NotificationHandlerSetup = __esm({
 // src/core/version.ts
 function resolveVersion() {
   try {
-    if ("2.2.5") {
-      return "2.2.5";
+    if ("2.2.7") {
+      return "2.2.7";
     }
   } catch {
   }
@@ -2444,9 +2444,6 @@ function mapPermissionStatus(status) {
 function detectPlatform2() {
   return Platform6.OS === "ios" ? "ios" : "android";
 }
-function detectEnvironment() {
-  return typeof __DEV__ !== "undefined" && __DEV__ ? "sandbox" : "production";
-}
 async function getAppVersion() {
   try {
     const { collectDeviceInfo: collectDeviceInfo2 } = await Promise.resolve().then(() => (init_deviceInfo(), deviceInfo_exports));
@@ -2486,7 +2483,7 @@ async function clearPersistedToken(secureStorage2) {
   } catch {
   }
 }
-async function buildRegistration(token, getDeviceId, getDistinctId) {
+async function buildRegistration(token, getDeviceId, getDistinctId, environment) {
   const appVersion = await getAppVersion();
   return {
     token,
@@ -2497,7 +2494,7 @@ async function buildRegistration(token, getDeviceId, getDistinctId) {
     deviceId: getDeviceId?.() ?? void 0,
     locale: await getLocale(),
     timezone: getTimezone2(),
-    environment: detectEnvironment()
+    environment
   };
 }
 async function registerToken(deps, token) {
@@ -2506,7 +2503,8 @@ async function registerToken(deps, token) {
     if (debug) console.log("[Paywallo PUSH] httpClient not ready, skipping token registration");
     return;
   }
-  const registration = await buildRegistration(token, getDeviceId, getDistinctId);
+  const { environment } = deps;
+  const registration = await buildRegistration(token, getDeviceId, getDistinctId, environment);
   try {
     await httpClient.post(
       TOKEN_ENDPOINT,
@@ -2556,7 +2554,8 @@ async function registerAndPersistToken(deps, token) {
       appKey: deps.appKey,
       getDeviceId: deps.getDeviceId,
       getDistinctId: deps.getDistinctId,
-      debug: deps.debug
+      debug: deps.debug,
+      environment: deps.environment
     },
     token
   );
@@ -2573,7 +2572,8 @@ function subscribeTokenRefresh(bridge, deps, onToken) {
         appKey: deps.appKey,
         getDeviceId: deps.getDeviceId,
         getDistinctId: deps.getDistinctId,
-        debug: deps.debug
+        debug: deps.debug,
+        environment: deps.environment
       },
       newToken
     ).catch(() => void 0);
@@ -2781,6 +2781,7 @@ var init_NotificationsManager = __esm({
         this.getDistinctId = null;
         this.appKey = null;
         this.apiBaseUrl = null;
+        this.environment = "production";
         this.tokenRefreshCleanup = null;
         this.foregroundCleanup = null;
         this.pendingHandlersConfig = null;
@@ -2800,6 +2801,7 @@ var init_NotificationsManager = __esm({
         this.secureStorage = deps.secureStorage;
         this.getDeviceId = deps.getDeviceId;
         if (deps.getDistinctId) this.getDistinctId = deps.getDistinctId;
+        if (deps.environment) this.environment = deps.environment;
       }
       async initialize(config) {
         this.applyConfig(config);
@@ -2842,7 +2844,8 @@ var init_NotificationsManager = __esm({
           appKey: this.appKey,
           getDeviceId: this.getDeviceId,
           getDistinctId: this.getDistinctId,
-          debug: this.debug
+          debug: this.debug,
+          environment: this.environment
         };
       }
       async doRegisterToken(token) {
@@ -3038,6 +3041,41 @@ var init_emitPaywallClosed = __esm({
   }
 });
 
+// src/domains/paywall/extractFirstPageBackground.ts
+function extractFirstPageBackground(craftData) {
+  if (!craftData) return DEFAULT_BACKGROUND;
+  try {
+    const data = JSON.parse(craftData);
+    const nodes = { ...data.nodes, ...data.sharedNodes };
+    const rootId = data.rootId;
+    if (!rootId || !nodes[rootId]) return DEFAULT_BACKGROUND;
+    const firstPageId = nodes[rootId].children?.[0];
+    if (!firstPageId) return DEFAULT_BACKGROUND;
+    const bg = nodes[firstPageId]?.props?.backgroundColor;
+    return typeof bg === "string" && bg.length > 0 && bg !== "transparent" ? bg : DEFAULT_BACKGROUND;
+  } catch {
+    return DEFAULT_BACKGROUND;
+  }
+}
+function isColorDark(color) {
+  const hex = color.replace("#", "").trim();
+  const normalized = hex.length === 3 ? hex.split("").map((c) => c + c).join("") : hex;
+  if (normalized.length !== 6) return false;
+  const r = parseInt(normalized.slice(0, 2), 16);
+  const g = parseInt(normalized.slice(2, 4), 16);
+  const b = parseInt(normalized.slice(4, 6), 16);
+  if (Number.isNaN(r) || Number.isNaN(g) || Number.isNaN(b)) return false;
+  const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
+  return luminance < 0.5;
+}
+var DEFAULT_BACKGROUND;
+var init_extractFirstPageBackground = __esm({
+  "src/domains/paywall/extractFirstPageBackground.ts"() {
+    "use strict";
+    DEFAULT_BACKGROUND = "#FFFFFF";
+  }
+});
+
 // src/domains/paywall/parseWebViewMessage.ts
 function deriveMessageId(message) {
   if (message.id) return message.id;
@@ -3280,6 +3318,66 @@ var init_localization = __esm({
   }
 });
 
+// src/domains/paywall/PaywallSkeleton.tsx
+import { useEffect, useRef } from "react";
+import { Animated, StyleSheet, View } from "react-native";
+import { jsx, jsxs } from "react/jsx-runtime";
+function SkeletonBlock({ style, color, opacity }) {
+  return /* @__PURE__ */ jsx(Animated.View, { style: [style, { backgroundColor: color, opacity }] });
+}
+function PaywallSkeleton({ backgroundColor = "#FFFFFF" }) {
+  const pulse = useRef(new Animated.Value(0.4)).current;
+  useEffect(() => {
+    const loop = Animated.loop(
+      Animated.sequence([
+        Animated.timing(pulse, { toValue: 1, duration: 700, useNativeDriver: true }),
+        Animated.timing(pulse, { toValue: 0.4, duration: 700, useNativeDriver: true })
+      ])
+    );
+    loop.start();
+    return () => loop.stop();
+  }, [pulse]);
+  const placeholder = isColorDark(backgroundColor) ? "rgba(255,255,255,0.13)" : "rgba(0,0,0,0.07)";
+  return /* @__PURE__ */ jsxs(View, { style: [styles.container, { backgroundColor }], pointerEvents: "none", children: [
+    /* @__PURE__ */ jsx(View, { style: styles.header, children: /* @__PURE__ */ jsx(SkeletonBlock, { style: styles.logo, color: placeholder, opacity: pulse }) }),
+    /* @__PURE__ */ jsx(SkeletonBlock, { style: styles.hero, color: placeholder, opacity: pulse }),
+    /* @__PURE__ */ jsxs(View, { style: styles.titleGroup, children: [
+      /* @__PURE__ */ jsx(SkeletonBlock, { style: styles.titleLine, color: placeholder, opacity: pulse }),
+      /* @__PURE__ */ jsx(SkeletonBlock, { style: styles.titleLineShort, color: placeholder, opacity: pulse })
+    ] }),
+    /* @__PURE__ */ jsxs(View, { style: styles.cardsRow, children: [
+      /* @__PURE__ */ jsx(SkeletonBlock, { style: styles.card, color: placeholder, opacity: pulse }),
+      /* @__PURE__ */ jsx(SkeletonBlock, { style: styles.card, color: placeholder, opacity: pulse })
+    ] }),
+    /* @__PURE__ */ jsxs(View, { style: styles.footerGroup, children: [
+      /* @__PURE__ */ jsx(SkeletonBlock, { style: styles.cta, color: placeholder, opacity: pulse }),
+      /* @__PURE__ */ jsx(SkeletonBlock, { style: styles.footer, color: placeholder, opacity: pulse })
+    ] })
+  ] });
+}
+var RADIUS, styles;
+var init_PaywallSkeleton = __esm({
+  "src/domains/paywall/PaywallSkeleton.tsx"() {
+    "use strict";
+    init_extractFirstPageBackground();
+    RADIUS = 14;
+    styles = StyleSheet.create({
+      card: { borderRadius: RADIUS, flex: 1, height: 120 },
+      cardsRow: { flexDirection: "row", gap: 12, marginTop: "auto", paddingHorizontal: 24 },
+      container: { flex: 1, paddingBottom: 40, paddingTop: 64 },
+      cta: { borderRadius: 30, height: 58, marginHorizontal: 24 },
+      footer: { alignSelf: "center", borderRadius: 6, height: 12, marginTop: 20, width: 180 },
+      footerGroup: { marginTop: 28 },
+      header: { alignItems: "center", paddingVertical: 12 },
+      hero: { alignSelf: "center", borderRadius: 20, height: 220, marginTop: 16, width: "70%" },
+      logo: { borderRadius: 6, height: 22, width: 110 },
+      titleGroup: { alignItems: "center", gap: 12, marginTop: 28, paddingHorizontal: 24 },
+      titleLine: { borderRadius: 8, height: 26, width: "85%" },
+      titleLineShort: { borderRadius: 8, height: 26, width: "60%" }
+    });
+  }
+});
+
 // src/domains/paywall/paywallScripts.ts
 function buildPaywallInjectionScript(data) {
   const paywallData = {
@@ -3324,7 +3422,7 @@ var init_paywallScripts = __esm({
 });
 
 // src/domains/paywall/PaywallWebView.tsx
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useCallback, useEffect as useEffect2, useMemo, useRef as useRef2, useState } from "react";
 import {
   BackHandler,
   findNodeHandle,
@@ -3333,11 +3431,11 @@ import {
   NativeModules as NativeModules6,
   Platform as Platform9,
   requireNativeComponent,
-  StyleSheet,
+  StyleSheet as StyleSheet2,
   UIManager,
-  View
+  View as View2
 } from "react-native";
-import { jsx } from "react/jsx-runtime";
+import { jsx as jsx2 } from "react/jsx-runtime";
 function getNativeWebView() {
   if (NativeWebViewComponent) return NativeWebViewComponent;
   if (nativeWebViewLookupFailed) return null;
@@ -3395,16 +3493,16 @@ function PaywallWebView({
   onReady,
   onError
 }) {
-  const paywallDataSent = useRef(false);
-  const loadEndReceived = useRef(false);
+  const paywallDataSent = useRef2(false);
+  const loadEndReceived = useRef2(false);
   const [scriptToInject, setScriptToInject] = useState(void 0);
-  const webViewRef = useRef(null);
-  const onErrorRef = useRef(onError);
+  const webViewRef = useRef2(null);
+  const onErrorRef = useRef2(onError);
   onErrorRef.current = onError;
-  const onReadyRef = useRef(onReady);
+  const onReadyRef = useRef2(onReady);
   onReadyRef.current = onReady;
   const NativeWebView = useMemo(() => getNativeWebView(), []);
-  useEffect(() => {
+  useEffect2(() => {
     if (!NativeWebView) {
       onErrorRef.current?.({
         code: -1,
@@ -3415,7 +3513,7 @@ function PaywallWebView({
   const [resolvedWebUrl, setResolvedWebUrl] = useState(
     () => webUrlProp ?? PaywalloClient.getWebUrl()
   );
-  useEffect(() => {
+  useEffect2(() => {
     if (webUrlProp !== void 0) {
       setResolvedWebUrl(webUrlProp ?? null);
       return;
@@ -3434,7 +3532,7 @@ function PaywallWebView({
     }, 200);
     return () => clearInterval(interval);
   }, [webUrlProp]);
-  useEffect(() => {
+  useEffect2(() => {
     if (!resolvedWebUrl) {
       onErrorRef.current?.({
         code: -1,
@@ -3462,9 +3560,9 @@ function PaywallWebView({
     });
     injectScript(script);
   }, [craftData, products, primaryProductId, secondaryProductId, injectScript]);
-  const processedIdsRef = useRef(/* @__PURE__ */ new Set());
-  const dedupeTimersRef = useRef(/* @__PURE__ */ new Map());
-  useEffect(() => {
+  const processedIdsRef = useRef2(/* @__PURE__ */ new Set());
+  const dedupeTimersRef = useRef2(/* @__PURE__ */ new Map());
+  useEffect2(() => {
     return () => {
       for (const timerId of dedupeTimersRef.current.values()) clearTimeout(timerId);
       dedupeTimersRef.current.clear();
@@ -3516,7 +3614,7 @@ function PaywallWebView({
     },
     [buildAndSetInjectionScript, onPurchase, onClose, onRestore]
   );
-  useEffect(() => {
+  useEffect2(() => {
     const emitter = getWebViewEmitter();
     if (!emitter) return;
     const loadEndSub = emitter.addListener("PaywalloWebViewLoadEnd", () => {
@@ -3541,7 +3639,7 @@ function PaywallWebView({
       errorSub.remove();
     };
   }, [buildAndSetInjectionScript, handleParsedMessage]);
-  useEffect(() => {
+  useEffect2(() => {
     const timer = setTimeout(() => {
       if (!paywallDataSent.current) {
         onErrorRef.current?.({
@@ -3581,11 +3679,11 @@ function PaywallWebView({
     },
     [handleParsedMessage]
   );
-  useEffect(() => {
+  useEffect2(() => {
     if (!paywallDataSent.current) return;
     injectScript(buildPurchaseStateScript(isPurchasing));
   }, [isPurchasing, injectScript]);
-  useEffect(() => {
+  useEffect2(() => {
     if (Platform9.OS !== "android") return;
     const onBackPress = () => {
       if (!paywallDataSent.current) return false;
@@ -3597,7 +3695,7 @@ function PaywallWebView({
   }, [injectScript]);
   if (!resolvedWebUrl || !NativeWebView) return null;
   const paywallUrl = `${resolvedWebUrl}/paywall/${paywallId}`;
-  return /* @__PURE__ */ jsx(View, { style: styles.container, children: /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx2(View2, { style: styles2.container, children: /* @__PURE__ */ jsx2(
     NativeWebView,
     {
       ref: webViewRef,
@@ -3606,11 +3704,11 @@ function PaywallWebView({
       onMessage: handleMessage,
       onLoadEnd: handleLoadEnd,
       onError: handleNativeError,
-      style: styles.webview
+      style: styles2.webview
     }
   ) });
 }
-var NativeWebViewComponent, nativeWebViewLookupFailed, webViewEmitter, styles;
+var NativeWebViewComponent, nativeWebViewLookupFailed, webViewEmitter, styles2;
 var init_PaywallWebView = __esm({
   "src/domains/paywall/PaywallWebView.tsx"() {
     "use strict";
@@ -3620,7 +3718,7 @@ var init_PaywallWebView = __esm({
     NativeWebViewComponent = null;
     nativeWebViewLookupFailed = false;
     webViewEmitter = null;
-    styles = StyleSheet.create({
+    styles2 = StyleSheet2.create({
       container: { flex: 1 },
       webview: { flex: 1, backgroundColor: "transparent" }
     });
@@ -3914,6 +4012,32 @@ var init_IAPTransactionEmitter = __esm({
           if (this.getDebug()) console.log("[Paywallo PURCHASE] transaction event emission failed", err);
         }
       }
+      /**
+       * Emits `checkout_started` quando o usuário inicia a compra (toca em comprar),
+       * antes do StoreKit/Billing abrir — conta mesmo que a sheet nativa seja cancelada.
+       * Vira InitiateCheckout no Meta/TikTok. Fire-and-forget — uma falha de tracking
+       * nunca pode travar a compra.
+       */
+      async emitCheckoutStarted(productId) {
+        try {
+          const apiClient = this.getApiClientFn();
+          if (!apiClient) return;
+          const distinctId = PaywalloClient.getDistinctId();
+          if (!distinctId) return;
+          const product = this.getProductFromCache(productId);
+          const properties = {
+            product_id: productId,
+            amount: product?.priceValue ?? 0,
+            currency: product?.currency ?? "USD"
+          };
+          await apiClient.trackEvent("checkout_started", distinctId, properties, void 0, {
+            priority: "critical"
+          });
+          if (this.getDebug()) console.log("[Paywallo PURCHASE] emitted checkout_started", productId);
+        } catch (err) {
+          if (this.getDebug()) console.log("[Paywallo PURCHASE] checkout_started emission failed", err);
+        }
+      }
       /**
        * Forwards a native transaction update to the EventBatcher.
        * Public so tests can exercise the wiring without a fake NativeEventEmitter.
@@ -3936,9 +4060,9 @@ var init_IAPTransactionEmitter = __esm({
             product_id: update.productId
           };
           if (update.type !== "canceled") {
-            const cached = this.getProductFromCache(update.productId);
-            const amount = update.amount ?? cached?.priceValue;
-            const currency = update.currency ?? cached?.currency;
+            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;
           }
@@ -4117,10 +4241,10 @@ var init_OfflineQueueStorage = __esm({
     init_NativeStorage();
     init_QueueJournal();
     OfflineQueueStorage = class {
-      constructor(config, emit, log) {
+      constructor(config, emit, log2) {
         this.config = config;
         this.emit = emit;
-        this.log = log;
+        this.log = log2;
       }
       async loadFromStorage(queue) {
         const { merged, recovered, hadJournal } = await mergeJournalIntoMain(
@@ -4739,6 +4863,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) });
             this.log("Event batch threw network error - will retry", {
               size: batch.length,
               error: error instanceof Error ? error.message : String(error)
@@ -4756,14 +4881,25 @@ var init_QueueProcessor = __esm({
               await offlineQueue.removeItem(item.id);
               failed++;
             }
+            const responseError = typeof response.data === "object" && response.data !== null && "error" in response.data ? response.data.error : void 0;
+            const isDuplicate = typeof responseError === "string" && responseError.toUpperCase().includes("DUPLICATE");
+            if (isDuplicate) {
+              if (this.config.debug) {
+                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) });
+            }
             this.log("Event batch failed permanently (4xx) - removing from queue", {
               status: response.status,
-              size: batch.length
+              size: batch.length,
+              isDuplicate
             });
           } else {
             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 });
             this.log("Event batch failed with server error - will retry", {
               status: response.status,
               size: batch.length
@@ -4793,6 +4929,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) });
           this.log("Request threw network error - will retry", {
             id: item.id,
             error: error instanceof Error ? error.message : String(error)
@@ -5089,6 +5226,7 @@ var init_IAPService = __esm({
         this.purchaseInFlight = productId;
         if (this.debug) console.log(`[Paywallo PURCHASE] starting ${productId}`);
         try {
+          void this.emitter.emitCheckoutStarted(productId);
           const purchase = await nativeStoreKit.purchase(productId);
           if (!purchase) {
             if (this.debug) console.log(`[Paywallo PURCHASE] ${productId} cancelled`);
@@ -5221,21 +5359,21 @@ var init_usePaywallTracking = __esm({
 });
 
 // src/domains/paywall/usePaywallActions.ts
-import { useCallback as useCallback3, useEffect as useEffect2, useRef as useRef2, useState as useState2 } from "react";
-import { Animated, AppState as AppState3, Dimensions as Dimensions2 } from "react-native";
+import { useCallback as useCallback3, useEffect as useEffect3, useRef as useRef3, useState as useState2 } from "react";
+import { Animated as Animated2, AppState as AppState3, Dimensions as Dimensions2 } from "react-native";
 function usePaywallActions(placement, paywallConfig, onResult, variantKey, campaignId, openAnim, variantId) {
   const [isPurchasing, setIsPurchasing] = useState2(false);
-  const isPurchasingRef = useRef2(false);
+  const isPurchasingRef = useRef3(false);
   const [isClosing, setIsClosing] = useState2(false);
-  const slideAnim = useRef2(new Animated.Value(0)).current;
-  const presentedAtRef = useRef2(Date.now());
-  const closedRef = useRef2(false);
+  const slideAnim = useRef3(new Animated2.Value(0)).current;
+  const presentedAtRef = useRef3(Date.now());
+  const closedRef = useRef3(false);
   const { trackDismissed, trackProductSelected, trackPurchased } = usePaywallTracking();
   const closeWithReason = useCallback3((reason, resultOverride) => {
     if (closedRef.current) return;
     closedRef.current = true;
     const animTarget = openAnim ?? slideAnim;
-    Animated.timing(animTarget, {
+    Animated2.timing(animTarget, {
       toValue: Dimensions2.get("window").height,
       duration: 350,
       useNativeDriver: true
@@ -5255,7 +5393,7 @@ function usePaywallActions(placement, paywallConfig, onResult, variantKey, campa
     setIsClosing(true);
     closeWithReason("dismissed");
   }, [isClosing, closeWithReason]);
-  useEffect2(() => {
+  useEffect3(() => {
     const sub = AppState3.addEventListener("change", (nextState) => {
       if (isPurchasingRef.current) return;
       if (nextState === "background" || nextState === "inactive") {
@@ -5264,7 +5402,7 @@ function usePaywallActions(placement, paywallConfig, onResult, variantKey, campa
     });
     return () => sub.remove();
   }, [closeWithReason]);
-  useEffect2(() => {
+  useEffect3(() => {
     const timer = setTimeout(() => {
       closeWithReason("timeout");
     }, PAYWALL_TIMEOUT_MS);
@@ -5335,17 +5473,17 @@ var init_usePaywallActions = __esm({
 });
 
 // src/domains/paywall/usePaywallLoader.ts
-import { useEffect as useEffect3, useRef as useRef3, useState as useState3 } from "react";
+import { useEffect as useEffect4, useRef as useRef4, useState as useState3 } from "react";
 function usePaywallLoader(placement, visible, preloadedConfig, preloadedProducts, variantKey, campaignId, variantId) {
   const [error, setError] = useState3(null);
   const [paywallConfig, setPaywallConfig] = useState3(null);
   const [products, setProducts] = useState3(/* @__PURE__ */ new Map());
-  const preloadedConfigRef = useRef3(preloadedConfig);
+  const preloadedConfigRef = useRef4(preloadedConfig);
   preloadedConfigRef.current = preloadedConfig;
-  const preloadedProductsRef = useRef3(preloadedProducts);
+  const preloadedProductsRef = useRef4(preloadedProducts);
   preloadedProductsRef.current = preloadedProducts;
-  const trackingDoneRef = useRef3(false);
-  useEffect3(() => {
+  const trackingDoneRef = useRef4(false);
+  useEffect4(() => {
     if (!visible) {
       trackingDoneRef.current = false;
       return;
@@ -5440,28 +5578,28 @@ var init_usePaywallLoader = __esm({
 });
 
 // src/domains/paywall/PaywallModal.tsx
-import { useCallback as useCallback4, useEffect as useEffect4, useRef as useRef4, useState as useState4 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect5, useRef as useRef5, useState as useState4 } from "react";
 import {
-  Animated as Animated2,
+  Animated as Animated3,
   Dimensions as Dimensions3,
   Easing,
   Modal,
   Pressable,
-  StyleSheet as StyleSheet2,
+  StyleSheet as StyleSheet3,
   Text,
-  View as View2
+  View as View3
 } from "react-native";
-import { Fragment, jsx as jsx2, jsxs } from "react/jsx-runtime";
+import { Fragment, jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 function ErrorFallback({ description, onRetry, onClose }) {
   const overrides = PaywalloClient.getConfig()?.errorStrings;
   const title = overrides?.title ?? getSdkString("paywallErrorTitle");
   const retryLabel = overrides?.retry ?? getSdkString("paywallRetryButton");
   const closeLabel = overrides?.close ?? getSdkString("paywallCloseButton");
-  return /* @__PURE__ */ jsx2(View2, { style: styles2.fallbackContainer, children: /* @__PURE__ */ jsxs(View2, { style: styles2.fallbackCard, children: [
-    /* @__PURE__ */ jsx2(Text, { style: styles2.fallbackTitle, children: title }),
-    /* @__PURE__ */ jsx2(Text, { style: styles2.fallbackDescription, children: description }),
-    /* @__PURE__ */ jsx2(Pressable, { style: styles2.retryButton, onPress: onRetry, children: /* @__PURE__ */ jsx2(Text, { style: styles2.retryButtonText, children: retryLabel }) }),
-    /* @__PURE__ */ jsx2(Pressable, { style: styles2.closeButton, onPress: onClose, children: /* @__PURE__ */ jsx2(Text, { style: styles2.closeButtonText, children: closeLabel }) })
+  return /* @__PURE__ */ jsx3(View3, { style: styles3.fallbackContainer, children: /* @__PURE__ */ jsxs2(View3, { style: styles3.fallbackCard, children: [
+    /* @__PURE__ */ jsx3(Text, { style: styles3.fallbackTitle, children: title }),
+    /* @__PURE__ */ jsx3(Text, { style: styles3.fallbackDescription, children: description }),
+    /* @__PURE__ */ jsx3(Pressable, { style: styles3.retryButton, onPress: onRetry, children: /* @__PURE__ */ jsx3(Text, { style: styles3.retryButtonText, children: retryLabel }) }),
+    /* @__PURE__ */ jsx3(Pressable, { style: styles3.closeButton, onPress: onClose, children: /* @__PURE__ */ jsx3(Text, { style: styles3.closeButtonText, children: closeLabel }) })
   ] }) });
 }
 function PaywallModal({
@@ -5484,7 +5622,7 @@ function PaywallModal({
     variantId
   );
   const screenHeight = Dimensions3.get("window").height;
-  const openAnim = useRef4(new Animated2.Value(screenHeight)).current;
+  const openAnim = useRef5(new Animated3.Value(screenHeight)).current;
   const [modalVisible, setModalVisible] = useState4(false);
   const handleResult = useCallback4((result) => {
     setModalVisible(false);
@@ -5493,7 +5631,9 @@ function PaywallModal({
   const { isPurchasing, slideAnim, handleClose, handlePurchase, handleRestore } = usePaywallActions(placement, paywallConfig, handleResult, variantKey, campaignId, openAnim, variantId);
   const [webViewError, setWebViewError] = useState4(null);
   const [retryCount, setRetryCount] = useState4(0);
-  const retryCountRef = useRef4(0);
+  const [showSkeleton, setShowSkeleton] = useState4(true);
+  const skeletonOpacity = useRef5(new Animated3.Value(1)).current;
+  const retryCountRef = useRef5(0);
   const handleWebViewError = useCallback4(
     (err) => {
       if (retryCountRef.current >= 1) {
@@ -5509,21 +5649,39 @@ function PaywallModal({
     retryCountRef.current = 0;
     setWebViewError(null);
     setRetryCount(0);
-  }, []);
-  useEffect4(() => {
+    setShowSkeleton(true);
+    skeletonOpacity.setValue(1);
+  }, [skeletonOpacity]);
+  const handleWebViewReady = useCallback4(() => {
+    Animated3.timing(skeletonOpacity, {
+      toValue: 0,
+      duration: 250,
+      easing: Easing.out(Easing.cubic),
+      useNativeDriver: true
+    }).start(() => setShowSkeleton(false));
+  }, [skeletonOpacity]);
+  useEffect5(() => {
+    if (!visible || !showSkeleton) return;
+    const timer = setTimeout(handleWebViewReady, 8e3);
+    return () => clearTimeout(timer);
+  }, [visible, showSkeleton, handleWebViewReady]);
+  useEffect5(() => {
     if (visible) {
       setModalVisible(true);
+      setShowSkeleton(true);
+      skeletonOpacity.setValue(1);
       openAnim.setValue(Dimensions3.get("window").height);
-      Animated2.timing(openAnim, {
+      Animated3.timing(openAnim, {
         toValue: 0,
         duration: 550,
         easing: Easing.out(Easing.cubic),
         useNativeDriver: true
       }).start();
     }
-  }, [visible, openAnim]);
+  }, [visible, openAnim, skeletonOpacity]);
   if (!modalVisible && !visible) return null;
-  return /* @__PURE__ */ jsx2(
+  const skeletonBackground = paywallConfig && "craftData" in paywallConfig.config ? extractFirstPageBackground(paywallConfig.config.craftData) : "#FFFFFF";
+  return /* @__PURE__ */ jsx3(
     Modal,
     {
       visible: modalVisible,
@@ -5532,16 +5690,16 @@ function PaywallModal({
       onRequestClose: handleClose,
       transparent: true,
       statusBarTranslucent: true,
-      children: /* @__PURE__ */ jsx2(View2, { style: styles2.overlay, children: /* @__PURE__ */ jsx2(Animated2.View, { style: [styles2.animatedContainer, { transform: [{ translateY: openAnim }] }], children: /* @__PURE__ */ jsxs(View2, { style: styles2.container, children: [
-        error && /* @__PURE__ */ jsx2(View2, { style: styles2.errorContainer, children: /* @__PURE__ */ jsx2(Text, { style: styles2.errorText, children: error.message }) }),
-        !error && paywallConfig && "craftData" in paywallConfig.config && /* @__PURE__ */ jsx2(Fragment, { children: webViewError ? /* @__PURE__ */ jsx2(
+      children: /* @__PURE__ */ jsx3(View3, { style: styles3.overlay, children: /* @__PURE__ */ jsx3(Animated3.View, { style: [styles3.animatedContainer, { transform: [{ translateY: openAnim }] }], children: /* @__PURE__ */ jsxs2(View3, { style: styles3.container, children: [
+        error && /* @__PURE__ */ jsx3(View3, { style: styles3.errorContainer, children: /* @__PURE__ */ jsx3(Text, { style: styles3.errorText, children: error.message }) }),
+        !error && paywallConfig && "craftData" in paywallConfig.config && /* @__PURE__ */ jsx3(Fragment, { children: webViewError ? /* @__PURE__ */ jsx3(
           ErrorFallback,
           {
             description: webViewError.description,
             onRetry: handleRetry,
             onClose: handleClose
           }
-        ) : /* @__PURE__ */ jsx2(
+        ) : /* @__PURE__ */ jsx3(
           PaywallWebView,
           {
             paywallId: paywallConfig.id,
@@ -5550,27 +5708,38 @@ function PaywallModal({
             primaryProductId: paywallConfig.primaryProductId,
             secondaryProductId: paywallConfig.secondaryProductId,
             isPurchasing,
+            onReady: handleWebViewReady,
             onClose: handleClose,
             onPurchase: handlePurchase,
             onRestore: handleRestore,
             onError: handleWebViewError
           },
           retryCount
-        ) })
+        ) }),
+        showSkeleton && !error && !webViewError && /* @__PURE__ */ jsx3(
+          Animated3.View,
+          {
+            style: [StyleSheet3.absoluteFill, { opacity: skeletonOpacity }],
+            pointerEvents: "none",
+            children: /* @__PURE__ */ jsx3(PaywallSkeleton, { backgroundColor: skeletonBackground })
+          }
+        )
       ] }) }) })
     }
   );
 }
-var styles2;
+var styles3;
 var init_PaywallModal = __esm({
   "src/domains/paywall/PaywallModal.tsx"() {
     "use strict";
     init_PaywalloClient();
     init_localization();
+    init_extractFirstPageBackground();
+    init_PaywallSkeleton();
     init_PaywallWebView();
     init_usePaywallActions();
     init_usePaywallLoader();
-    styles2 = StyleSheet2.create({
+    styles3 = StyleSheet3.create({
       overlay: { flex: 1, backgroundColor: "rgba(0,0,0,0.3)" },
       animatedContainer: { flex: 1, backgroundColor: "#fff" },
       container: { flex: 1, backgroundColor: "#fff" },
@@ -5626,13 +5795,176 @@ var init_PaywallModal = __esm({
   }
 });
 
+// src/domains/paywall/PaywallPreloadService.ts
+var PRELOAD_TTL_MS, STALE_THRESHOLD, PaywallPreloadService, paywallPreloadService;
+var init_PaywallPreloadService = __esm({
+  "src/domains/paywall/PaywallPreloadService.ts"() {
+    "use strict";
+    init_PaywalloClient();
+    init_IAPService();
+    init_PaywallError();
+    PRELOAD_TTL_MS = 5 * 60 * 1e3;
+    STALE_THRESHOLD = 0.75;
+    PaywallPreloadService = class {
+      constructor() {
+        this.preloaded = /* @__PURE__ */ new Map();
+        this.activePreloads = /* @__PURE__ */ new Map();
+        this.apiClientRef = null;
+      }
+      async preload(apiClient, placement) {
+        this.apiClientRef = apiClient;
+        const existing = this.activePreloads.get(placement);
+        if (existing) return existing;
+        const promise = this.doPreload(apiClient, placement);
+        this.activePreloads.set(placement, promise);
+        try {
+          return await promise;
+        } finally {
+          this.activePreloads.delete(placement);
+        }
+      }
+      async preloadMany(apiClient, placements) {
+        this.apiClientRef = apiClient;
+        if (placements.length === 0) return;
+        const debug = PaywalloClient.getConfig()?.debug;
+        if (debug) console.log(`[Paywallo PRELOAD] paywalls: ${placements.length} placements`);
+        for (let i = 0; i < placements.length; i++) {
+          if (i > 0) await new Promise((r) => setTimeout(r, 200));
+          void this.preload(apiClient, placements[i]).catch((err) => {
+            if (debug) console.log(`[Paywallo PRELOAD] paywall failed ${placements[i]}:`, err);
+          });
+        }
+      }
+      getPreloaded(placement) {
+        const cached2 = this.preloaded.get(placement);
+        if (!cached2) return null;
+        const age = Date.now() - cached2.preloadedAt;
+        if (age >= PRELOAD_TTL_MS) {
+          this.preloaded.delete(placement);
+          return null;
+        }
+        if (age >= PRELOAD_TTL_MS * STALE_THRESHOLD && this.apiClientRef) {
+          void this.preload(this.apiClientRef, placement).catch(() => {
+          });
+        }
+        return { config: cached2.config, products: new Map(cached2.products) };
+      }
+      isPreloaded(placement) {
+        return this.getPreloaded(placement) !== null;
+      }
+      clear() {
+        this.preloaded.clear();
+        this.activePreloads.clear();
+      }
+      async doPreload(apiClient, placement) {
+        try {
+          const config = await apiClient.getPaywall(placement);
+          if (!config) {
+            return {
+              success: false,
+              error: new PaywallError(
+                PAYWALL_ERROR_CODES.NOT_FOUND,
+                `Paywall not found for placement: ${placement}`
+              )
+            };
+          }
+          const products = await this.loadProductsFor(config);
+          this.preloaded.set(placement, { config, products, preloadedAt: Date.now() });
+          if (PaywalloClient.getConfig()?.debug) {
+            console.log(`[Paywallo PRELOAD] paywall cached \u2014 placement: ${placement}`);
+          }
+          return { success: true };
+        } catch (error) {
+          return {
+            success: false,
+            error: error instanceof Error ? error : new PaywallError(PAYWALL_ERROR_CODES.LOAD_FAILED, String(error))
+          };
+        }
+      }
+      async loadProductsFor(config) {
+        const productIds = [];
+        if (config.primaryProductId) productIds.push(config.primaryProductId);
+        if (config.secondaryProductId) productIds.push(config.secondaryProductId);
+        if (productIds.length === 0) return /* @__PURE__ */ new Map();
+        try {
+          const loaded = await getIAPService().loadProducts(productIds);
+          const map = /* @__PURE__ */ new Map();
+          for (const p of loaded) map.set(p.productId, p);
+          return map;
+        } catch (err) {
+          if (PaywalloClient.getConfig()?.debug) {
+            console.log("[Paywallo PRELOAD] products failed, caching config only:", err);
+          }
+          return /* @__PURE__ */ new Map();
+        }
+      }
+    };
+    paywallPreloadService = new PaywallPreloadService();
+  }
+});
+
+// src/domains/paywall/PaywallWebViewPrewarmer.tsx
+import { useEffect as useEffect6, useMemo as useMemo2, useState as useState5 } from "react";
+import { requireNativeComponent as requireNativeComponent2, StyleSheet as StyleSheet4, View as View4 } from "react-native";
+import { jsx as jsx4 } from "react/jsx-runtime";
+function getNativeWebView2() {
+  if (NativeWebViewComponent2) return NativeWebViewComponent2;
+  if (nativeLookupFailed) return null;
+  try {
+    NativeWebViewComponent2 = requireNativeComponent2("PaywalloWebView");
+    return NativeWebViewComponent2;
+  } catch {
+    nativeLookupFailed = true;
+    return null;
+  }
+}
+function PaywallWebViewPrewarmer({
+  webUrl,
+  durationMs = DEFAULT_DURATION_MS
+}) {
+  const NativeWebView = useMemo2(() => getNativeWebView2(), []);
+  const [mounted, setMounted] = useState5(true);
+  useEffect6(() => {
+    if (!NativeWebView) return;
+    const timer = setTimeout(() => setMounted(false), durationMs);
+    return () => clearTimeout(timer);
+  }, [NativeWebView, durationMs]);
+  if (!NativeWebView || !mounted) return null;
+  const preheatUrl = `${webUrl}/paywall/preheat`;
+  if (PaywalloClient.getConfig()?.debug) {
+    console.log(`[Paywallo PREWARM] mounting hidden WebView: ${preheatUrl}`);
+  }
+  return /* @__PURE__ */ jsx4(View4, { pointerEvents: "none", style: styles4.hidden, children: /* @__PURE__ */ jsx4(NativeWebView, { sourceUrl: preheatUrl, style: styles4.fill }) });
+}
+var NativeWebViewComponent2, nativeLookupFailed, DEFAULT_DURATION_MS, styles4;
+var init_PaywallWebViewPrewarmer = __esm({
+  "src/domains/paywall/PaywallWebViewPrewarmer.tsx"() {
+    "use strict";
+    init_PaywalloClient();
+    NativeWebViewComponent2 = null;
+    nativeLookupFailed = false;
+    DEFAULT_DURATION_MS = 60 * 1e3;
+    styles4 = StyleSheet4.create({
+      hidden: {
+        height: 1,
+        left: -9999,
+        opacity: 0,
+        position: "absolute",
+        top: -9999,
+        width: 1
+      },
+      fill: { flex: 1 }
+    });
+  }
+});
+
 // src/domains/paywall/usePaywallSession.ts
-import { useCallback as useCallback5, useEffect as useEffect5, useRef as useRef5 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect7, useRef as useRef6 } from "react";
 function usePaywallSession(options) {
-  const closedRef = useRef5(false);
-  const optsRef = useRef5(options);
+  const closedRef = useRef6(false);
+  const optsRef = useRef6(options);
   optsRef.current = options;
-  useEffect5(() => {
+  useEffect7(() => {
     if (!options) return;
     closedRef.current = false;
     startHeartbeat({
@@ -5676,11 +6008,11 @@ var init_usePaywallSession = __esm({
 });
 
 // src/domains/paywall/usePaywallPresenter.ts
-import { useCallback as useCallback6, useEffect as useEffect6, useRef as useRef6, useState as useState5 } from "react";
+import { useCallback as useCallback6, useEffect as useEffect8, useRef as useRef7, useState as useState6 } from "react";
 function usePaywallPresenter(preloadedWebView, setPreloadedWebView) {
-  const [showingPreloadedWebView, setShowingPreloadedWebView] = useState5(false);
-  const resolverRef = useRef6(null);
-  const presentedAtRef = useRef6(Date.now());
+  const [showingPreloadedWebView, setShowingPreloadedWebView] = useState6(false);
+  const resolverRef = useRef7(null);
+  const presentedAtRef = useRef7(Date.now());
   const sessionOpts = showingPreloadedWebView && preloadedWebView ? {
     placement: preloadedWebView.placement,
     paywallId: preloadedWebView.paywallId,
@@ -5690,7 +6022,7 @@ function usePaywallPresenter(preloadedWebView, setPreloadedWebView) {
     ...preloadedWebView.campaignId && { campaignId: preloadedWebView.campaignId }
   } : null;
   const { markClosed } = usePaywallSession(sessionOpts);
-  useEffect6(() => {
+  useEffect8(() => {
     return () => {
       if (resolverRef.current) {
         resolverRef.current({ presented: false, purchased: false, cancelled: true, restored: false });
@@ -5777,7 +6109,9 @@ var init_paywall = __esm({
     init_PaywallError();
     init_PaywallErrorBoundary();
     init_PaywallModal();
+    init_PaywallPreloadService();
     init_PaywallWebView();
+    init_PaywallWebViewPrewarmer();
     init_usePaywallPresenter();
     init_usePaywallTracking();
   }
@@ -5883,10 +6217,10 @@ var init_PlanService = __esm({
       }
       async getCurrentPlan(forceRefresh = false) {
         if (!forceRefresh) {
-          const cached = this.cache.get();
-          if (cached && !cached.isStale) {
-            const current = cached.data.plans.find(
-              (p) => p.identifier === cached.data.currentIdentifier
+          const cached2 = this.cache.get();
+          if (cached2 && !cached2.isStale) {
+            const current = cached2.data.plans.find(
+              (p) => p.identifier === cached2.data.currentIdentifier
             );
             return current ?? null;
           }
@@ -5913,8 +6247,8 @@ var init_PlanService = __esm({
       }
       async getAllPlans(forceRefresh = false) {
         if (!forceRefresh) {
-          const cached = this.cache.get();
-          if (cached && !cached.isStale) return cached.data;
+          const cached2 = this.cache.get();
+          if (cached2 && !cached2.isStale) return cached2.data;
         }
         if (!this.cache.get()) {
           try {
@@ -6032,112 +6366,274 @@ var init_analytics = __esm({
   }
 });
 
-// src/core/PaywalloAnalytics.ts
-function isValidEventName(name) {
-  if (name.startsWith("$")) return /^\$[a-z][a-z0-9]*(_[a-z0-9]+)*$/.test(name);
-  return /^[a-z][a-z0-9]*(_[a-z0-9]+)*$/.test(name);
-}
-async function trackEvent(apiClient, state, eventName, options) {
-  const distinctId = identityManager.getDistinctId();
-  if (!distinctId) {
-    if (state.config?.debug) console.log(`[Paywallo TRACK] ${eventName} skipped (no distinctId)`);
-    return;
-  }
-  if (!isValidEventName(eventName)) {
-    const msg = `Invalid event name: "${eventName}". Use snake_case or $reserved_name.`;
-    throw new ClientError(CLIENT_ERROR_CODES.INVALID_EVENT_NAME, msg);
-  }
-  if (state.config?.debug && eventName.startsWith("$purchase")) console.log(`[Paywallo TRACK] ${eventName}`, options?.properties ?? {});
-  const sessionId = sessionManager.getSessionId();
-  await apiClient.trackEvent(
-    eventName,
-    distinctId,
-    { ...identityManager.getProperties(), ...options?.properties, ...sessionId && { sessionId } },
-    options?.timestamp,
-    options?.priority ? { priority: options.priority } : void 0
-  );
-}
-async function trackOnboardingStep(apiClient, state, index, name) {
-  const distinctId = identityManager.getDistinctId();
-  if (!distinctId) return;
-  if (!Number.isInteger(index) || index < 0) {
-    const msg = `Invalid stepIndex: "${index}". Must be a non-negative integer.`;
-    throw new AnalyticsError(ANALYTICS_ERROR_CODES.INVALID_STEP_INDEX, msg);
-  }
-  const now = Date.now();
-  const timeOnPreviousStep = state.lastOnboardingStepTimestamp !== null ? Math.round((now - state.lastOnboardingStepTimestamp) / 1e3) : 0;
-  state.lastOnboardingStepTimestamp = now;
-  await apiClient.trackEvent("$onboarding_step", distinctId, { stepIndex: index, stepName: name, timeOnPreviousStep });
-}
-function validateCoreAction(actionName) {
-  if (!actionName || typeof actionName !== "string") {
-    const msg = `Invalid actionName: "${actionName}". Must be a non-empty string.`;
-    throw new AnalyticsError(ANALYTICS_ERROR_CODES.INVALID_ACTION_NAME, msg);
-  }
-}
-var init_PaywalloAnalytics = __esm({
-  "src/core/PaywalloAnalytics.ts"() {
-    "use strict";
-    init_analytics();
-    init_identity();
-    init_session();
-    init_ClientError();
-  }
-});
-
-// src/core/PaywalloFlags.ts
-async function getVariantCached(apiClient, flagKey, defaultValue) {
-  const distinctId = identityManager.getDistinctId();
-  const result = await apiClient.getVariantFromCache(flagKey, distinctId);
-  if (result) return result;
-  void apiClient.getVariant(flagKey, distinctId).catch(() => {
-  });
-  return { variant: defaultValue ?? null, payload: void 0 };
-}
-async function getVariant(apiClient, state, flagKey) {
-  try {
-    const distinctId = identityManager.getDistinctId();
-    if (!distinctId) {
-      if (state.config?.debug) console.log(`[Paywallo FLAG] ${flagKey} \u2192 null (no distinctId)`);
-      return { variant: null };
-    }
-    const result = await apiClient.getVariant(flagKey, distinctId);
-    if (state.config?.debug) console.log(`[Paywallo FLAG] ${flagKey} \u2192`, result.variant);
-    return result;
-  } catch (error) {
-    if (state.config?.debug) console.log(`[Paywallo FLAG] ${flagKey} \u2192 error`, error);
-    if (state.apiClient) void state.apiClient.reportError("GET_VARIANT_FAILED", error instanceof Error ? error.message : String(error));
-    return { variant: null };
-  }
-}
-function evaluateFlags(apiClient, keys) {
-  return apiClient.evaluateFlags(keys, identityManager.getDistinctId());
-}
-async function getConditionalFlag(apiClient, state, flagKey, context) {
-  try {
-    const distinctId = identityManager.getDistinctId();
-    if (!distinctId) return false;
-    const result = await apiClient.getConditionalFlag(flagKey, { distinctId, ...context });
-    return result.value;
-  } catch (error) {
-    if (state.apiClient) void state.apiClient.reportError("GET_CONDITIONAL_FLAG_FAILED", error instanceof Error ? error.message : String(error));
-    return false;
-  }
-}
-var init_PaywalloFlags = __esm({
-  "src/core/PaywalloFlags.ts"() {
-    "use strict";
-    init_identity();
-  }
-});
-
-// src/domains/onboarding/OnboardingError.ts
-var OnboardingError, ONBOARDING_ERROR_CODES;
-var init_OnboardingError = __esm({
-  "src/domains/onboarding/OnboardingError.ts"() {
+// src/core/events/schemas.ts
+import { z } from "zod";
+var lifecycleEventSchema, identifyEventSchema, paywallEventSchema, transactionEventSchema, onboardingEventSchema, notificationEventSchema, customEventSchema, EVENT_SCHEMAS;
+var init_schemas = __esm({
+  "src/core/events/schemas.ts"() {
     "use strict";
-    init_PaywalloError();
-    OnboardingError = class extends PaywalloError {
+    lifecycleEventSchema = z.object({
+      type: z.enum([
+        "install",
+        "cold_start",
+        "foreground",
+        "background",
+        "session_start",
+        "session_end"
+      ]),
+      session_id: z.string().optional(),
+      duration_s: z.number().nonnegative().optional(),
+      first_ever: z.boolean().optional(),
+      // Contexto leve transportado em lifecycle (útil pra cold_start/install)
+      app_version: z.string().optional(),
+      device_type: z.enum(["ios", "android"]).optional(),
+      os_version: z.string().optional(),
+      // Timestamps opcionais — o EventBatcher injeta `timestamp` no envelope
+      started_at: z.string().optional(),
+      ended_at: z.string().optional()
+    }).strict();
+    identifyEventSchema = z.object({
+      distinct_id: z.string().min(1),
+      email: z.email().optional(),
+      traits: z.record(z.string(), z.unknown()).optional(),
+      attribution: z.record(z.string(), z.unknown()).optional(),
+      device: z.record(z.string(), z.unknown()).optional()
+    }).strict();
+    paywallEventSchema = z.object({
+      type: z.enum(["viewed", "closed", "purchased"]),
+      paywall_id: z.string().min(1),
+      placement: z.string().optional(),
+      variant_id: z.string().optional(),
+      variant_key: z.string().optional(),
+      campaign_id: z.string().optional(),
+      // `closed`-specific
+      closed_at: z.string().optional(),
+      duration_s: z.number().nonnegative().optional(),
+      close_reason: z.enum(["dismiss", "cta", "purchase", "error", "timeout"]).optional(),
+      scroll_depth: z.number().min(0).max(1).optional(),
+      // `purchased`-specific (mínimo — transaction canônica leva detalhes)
+      product_id: z.string().optional()
+    }).strict();
+    transactionEventSchema = z.object({
+      type: z.enum([
+        "completed",
+        "failed",
+        "refunded",
+        "renewed",
+        "canceled",
+        "expired"
+      ]),
+      tx_id: z.string().min(1),
+      amount: z.number().optional(),
+      currency: z.string().length(3).optional(),
+      product_id: z.string().optional(),
+      subscription_id: z.string().optional(),
+      paywall_id: z.string().optional(),
+      variant_id: z.string().optional(),
+      reason: z.string().optional()
+    }).strict();
+    onboardingEventSchema = z.object({
+      type: z.enum(["step", "complete", "drop"]),
+      step_index: z.number().int().nonnegative().optional(),
+      step_name: z.string().optional(),
+      variant_key: z.string().optional(),
+      time_on_prev_s: z.number().nonnegative().optional()
+    }).strict();
+    notificationEventSchema = z.object({
+      type: z.enum(["delivered", "displayed", "clicked", "dismissed"]),
+      notification_id: z.string().optional(),
+      campaign_id: z.string().optional(),
+      variant_key: z.string().nullable().optional(),
+      message_id: z.string().optional(),
+      device_id: z.string().optional(),
+      push_platform: z.enum(["ios", "android"]).optional(),
+      timezone: z.string().optional(),
+      failure_reason: z.string().optional(),
+      app_user_id: z.string().optional()
+    }).strict();
+    customEventSchema = z.object({
+      name: z.string().min(1).regex(
+        /^(\$[a-zA-Z0-9_]+|[a-z][a-z0-9_]*)$/,
+        "custom event name must be snake_case or $reserved"
+      ),
+      props: z.record(z.string(), z.unknown()).optional()
+    }).strict();
+    EVENT_SCHEMAS = {
+      lifecycle: lifecycleEventSchema,
+      identify: identifyEventSchema,
+      paywall: paywallEventSchema,
+      transaction: transactionEventSchema,
+      onboarding: onboardingEventSchema,
+      notification: notificationEventSchema,
+      custom: customEventSchema
+    };
+  }
+});
+
+// src/core/events/eventFamilies.ts
+function isDeprecatedEvent(eventName) {
+  return DEPRECATED_EVENT_NAMES.includes(eventName);
+}
+function isCanonicalFamily(name) {
+  return CANONICAL_FAMILIES.includes(name);
+}
+function detectFamily(eventName) {
+  if (isCanonicalFamily(eventName) && eventName !== "custom") {
+    return eventName;
+  }
+  return "custom";
+}
+function validateEvent(eventName, properties) {
+  const family = detectFamily(eventName);
+  const schema = EVENT_SCHEMAS[family];
+  const input = family === "custom" ? { name: eventName, ...properties ? { props: properties } : {} } : properties ?? {};
+  const parsed = schema.safeParse(input);
+  if (parsed.success) {
+    return { ok: true, family, data: parsed.data };
+  }
+  return { ok: false, family, error: parsed.error };
+}
+function formatValidationError(error) {
+  return error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+}
+var CANONICAL_FAMILIES, DEPRECATED_EVENT_NAMES;
+var init_eventFamilies = __esm({
+  "src/core/events/eventFamilies.ts"() {
+    "use strict";
+    init_schemas();
+    CANONICAL_FAMILIES = [
+      "lifecycle",
+      "identify",
+      "paywall",
+      "transaction",
+      "onboarding",
+      "notification",
+      "custom"
+    ];
+    DEPRECATED_EVENT_NAMES = [
+      "$paywall_purchased",
+      "$paywall_product_selected",
+      "$core_action",
+      "$campaign_impression",
+      "$app_open",
+      "$app_background",
+      "$app_foreground",
+      "session.end"
+    ];
+  }
+});
+
+// src/core/PaywalloAnalytics.ts
+function isValidEventName(name) {
+  if (name.startsWith("$")) return /^\$[a-z][a-z0-9]*(_[a-z0-9]+)*$/.test(name);
+  return /^[a-z][a-z0-9]*(_[a-z0-9]+)*$/.test(name);
+}
+async function trackEvent(apiClient, state, eventName, options) {
+  const distinctId = identityManager.getDistinctId();
+  if (!distinctId) {
+    console.error("[Paywallo:DROP] event dropped \u2014 no distinctId available yet", { eventName });
+    return;
+  }
+  if (!isValidEventName(eventName)) {
+    const msg = `Invalid event name: "${eventName}". Use snake_case or $reserved_name.`;
+    throw new ClientError(CLIENT_ERROR_CODES.INVALID_EVENT_NAME, msg);
+  }
+  if (state.config?.debug && eventName.startsWith("$purchase")) console.log(`[Paywallo TRACK] ${eventName}`, options?.properties ?? {});
+  const sessionId = sessionManager.getSessionId();
+  const family = detectFamily(eventName);
+  const isCustomFamily = family === "custom";
+  const identityProps = isCustomFamily ? identityManager.getProperties() : {};
+  const sessionProp = isCustomFamily && sessionId ? { sessionId } : {};
+  await apiClient.trackEvent(
+    eventName,
+    distinctId,
+    { ...identityProps, ...options?.properties, ...sessionProp },
+    options?.timestamp,
+    options?.priority ? { priority: options.priority } : void 0
+  );
+}
+async function trackOnboardingStep(apiClient, state, index, name) {
+  const distinctId = identityManager.getDistinctId();
+  if (!distinctId) return;
+  if (!Number.isInteger(index) || index < 0) {
+    const msg = `Invalid stepIndex: "${index}". Must be a non-negative integer.`;
+    throw new AnalyticsError(ANALYTICS_ERROR_CODES.INVALID_STEP_INDEX, msg);
+  }
+  const now = Date.now();
+  const timeOnPreviousStep = state.lastOnboardingStepTimestamp !== null ? Math.round((now - state.lastOnboardingStepTimestamp) / 1e3) : 0;
+  state.lastOnboardingStepTimestamp = now;
+  await apiClient.trackEvent("$onboarding_step", distinctId, { stepIndex: index, stepName: name, timeOnPreviousStep });
+}
+function validateCoreAction(actionName) {
+  if (!actionName || typeof actionName !== "string") {
+    const msg = `Invalid actionName: "${actionName}". Must be a non-empty string.`;
+    throw new AnalyticsError(ANALYTICS_ERROR_CODES.INVALID_ACTION_NAME, msg);
+  }
+}
+var init_PaywalloAnalytics = __esm({
+  "src/core/PaywalloAnalytics.ts"() {
+    "use strict";
+    init_analytics();
+    init_identity();
+    init_session();
+    init_ClientError();
+    init_eventFamilies();
+  }
+});
+
+// src/core/PaywalloFlags.ts
+async function getVariantCached(apiClient, flagKey, defaultValue) {
+  const distinctId = identityManager.getDistinctId();
+  const result = await apiClient.getVariantFromCache(flagKey, distinctId);
+  if (result) return result;
+  void apiClient.getVariant(flagKey, distinctId).catch(() => {
+  });
+  return { variant: defaultValue ?? null, payload: void 0 };
+}
+async function getVariant(apiClient, state, flagKey) {
+  try {
+    const distinctId = identityManager.getDistinctId();
+    if (!distinctId) {
+      if (state.config?.debug) console.log(`[Paywallo FLAG] ${flagKey} \u2192 null (no distinctId)`);
+      return { variant: null };
+    }
+    const result = await apiClient.getVariant(flagKey, distinctId);
+    if (state.config?.debug) console.log(`[Paywallo FLAG] ${flagKey} \u2192`, result.variant);
+    return result;
+  } catch (error) {
+    if (state.config?.debug) console.log(`[Paywallo FLAG] ${flagKey} \u2192 error`, error);
+    if (state.apiClient) void state.apiClient.reportError("GET_VARIANT_FAILED", error instanceof Error ? error.message : String(error));
+    return { variant: null };
+  }
+}
+function evaluateFlags(apiClient, keys) {
+  return apiClient.evaluateFlags(keys, identityManager.getDistinctId());
+}
+async function getConditionalFlag(apiClient, state, flagKey, context) {
+  try {
+    const distinctId = identityManager.getDistinctId();
+    if (!distinctId) return false;
+    const result = await apiClient.getConditionalFlag(flagKey, { distinctId, ...context });
+    return result.value;
+  } catch (error) {
+    if (state.apiClient) void state.apiClient.reportError("GET_CONDITIONAL_FLAG_FAILED", error instanceof Error ? error.message : String(error));
+    return false;
+  }
+}
+var init_PaywalloFlags = __esm({
+  "src/core/PaywalloFlags.ts"() {
+    "use strict";
+    init_identity();
+  }
+});
+
+// src/domains/onboarding/OnboardingError.ts
+var OnboardingError, ONBOARDING_ERROR_CODES;
+var init_OnboardingError = __esm({
+  "src/domains/onboarding/OnboardingError.ts"() {
+    "use strict";
+    init_PaywalloError();
+    OnboardingError = class extends PaywalloError {
       constructor(code, message) {
         super("onboarding", code, message);
         this.name = "OnboardingError";
@@ -6346,49 +6842,49 @@ var init_SubscriptionCache = __esm({
             await this.storage.remove(keyFor(distinctId));
             return null;
           }
-          const cached = parsed;
-          if (cached.data.subscription?.expiresAt) {
-            cached.data.subscription.expiresAt = new Date(cached.data.subscription.expiresAt);
+          const cached2 = parsed;
+          if (cached2.data.subscription?.expiresAt) {
+            cached2.data.subscription.expiresAt = new Date(cached2.data.subscription.expiresAt);
           }
-          if (cached.data.subscription?.originalPurchaseDate) {
-            cached.data.subscription.originalPurchaseDate = new Date(
-              cached.data.subscription.originalPurchaseDate
+          if (cached2.data.subscription?.originalPurchaseDate) {
+            cached2.data.subscription.originalPurchaseDate = new Date(
+              cached2.data.subscription.originalPurchaseDate
             );
           }
-          if (cached.data.subscription?.latestPurchaseDate) {
-            cached.data.subscription.latestPurchaseDate = new Date(
-              cached.data.subscription.latestPurchaseDate
+          if (cached2.data.subscription?.latestPurchaseDate) {
+            cached2.data.subscription.latestPurchaseDate = new Date(
+              cached2.data.subscription.latestPurchaseDate
             );
           }
-          if (cached.data.subscription?.cancellationDate) {
-            cached.data.subscription.cancellationDate = new Date(
-              cached.data.subscription.cancellationDate
+          if (cached2.data.subscription?.cancellationDate) {
+            cached2.data.subscription.cancellationDate = new Date(
+              cached2.data.subscription.cancellationDate
             );
           }
-          if (cached.data.subscription?.gracePeriodExpiresAt) {
-            cached.data.subscription.gracePeriodExpiresAt = new Date(
-              cached.data.subscription.gracePeriodExpiresAt
+          if (cached2.data.subscription?.gracePeriodExpiresAt) {
+            cached2.data.subscription.gracePeriodExpiresAt = new Date(
+              cached2.data.subscription.gracePeriodExpiresAt
             );
           }
-          cached.isStale = this.isExpired(cached);
-          if (!cached.isStale) {
-            this.memoryCache.set(distinctId, cached);
+          cached2.isStale = this.isExpired(cached2);
+          if (!cached2.isStale) {
+            this.memoryCache.set(distinctId, cached2);
           }
-          return cached;
+          return cached2;
         } catch {
           return null;
         }
       }
       async set(distinctId, data) {
         if (!distinctId) return;
-        const cached = {
+        const cached2 = {
           data,
           cachedAt: Date.now(),
           isStale: false
         };
-        this.memoryCache.set(distinctId, cached);
+        this.memoryCache.set(distinctId, cached2);
         try {
-          await this.storage.set(keyFor(distinctId), JSON.stringify(cached));
+          await this.storage.set(keyFor(distinctId), JSON.stringify(cached2));
           await this.addToIndex(distinctId);
         } catch {
         }
@@ -6432,8 +6928,8 @@ var init_SubscriptionCache = __esm({
           ...allKeys.map((k) => this.storage.remove(keyFor(k)))
         ]);
       }
-      isExpired(cached) {
-        return Date.now() - cached.cachedAt > this.ttl;
+      isExpired(cached2) {
+        return Date.now() - cached2.cachedAt > this.ttl;
       }
       setTTL(ttl) {
         this.ttl = ttl;
@@ -6489,9 +6985,9 @@ var init_SubscriptionManager = __esm({
           return this.getEmptyStatus();
         }
         if (!forceRefresh) {
-          const cached = await this.cache.get(this.cacheKey());
-          if (cached && !cached.isStale) {
-            return cached.data;
+          const cached2 = await this.cache.get(this.cacheKey());
+          if (cached2 && !cached2.isStale) {
+            return cached2.data;
           }
         }
         try {
@@ -6501,9 +6997,9 @@ var init_SubscriptionManager = __esm({
           return status;
         } catch (error) {
           this.log("Failed to fetch subscription status", error);
-          const cached = await this.cache.get(this.cacheKey());
-          if (cached) {
-            return cached.data;
+          const cached2 = await this.cache.get(this.cacheKey());
+          if (cached2) {
+            return cached2.data;
           }
           return this.getEmptyStatus();
         }
@@ -6790,288 +7286,131 @@ async function writeFlagToStorage(flagKey, distinctId, flag) {
   }
 }
 var FLAG_MAX_AGE_MS;
-var init_FlagStorage = __esm({
-  "src/core/FlagStorage.ts"() {
-    "use strict";
-    init_SecureStorage();
-    FLAG_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
-  }
-});
-
-// src/core/ApiClientFlags.ts
-async function getVariant2(deps, flagKey, distinctId) {
-  const key = `${flagKey}:${distinctId}`;
-  const hit = deps.cache.getVariant(key);
-  if (hit !== void 0) return hit;
-  const persisted = await readFlagFromStorage(flagKey, distinctId);
-  if (persisted !== null) {
-    deps.cache.setVariant(key, persisted);
-    return persisted;
-  }
-  try {
-    const res = await deps.get(`/sdk/flags/${flagKey}?distinctId=${encodeURIComponent(distinctId)}`);
-    if (res.status === 404) {
-      const v = { variant: null };
-      deps.cache.setVariant(key, v, deps.cache.nullTTL);
-      return v;
-    }
-    if (!res.ok) {
-      const stale = deps.cache.getStaleVariant(key);
-      return stale !== void 0 ? stale : { variant: null };
-    }
-    deps.cache.setVariant(key, res.data);
-    await writeFlagToStorage(flagKey, distinctId, res.data);
-    return res.data;
-  } catch {
-    const stale = deps.cache.getStaleVariant(key);
-    return stale !== void 0 ? stale : { variant: null };
-  }
-}
-async function evaluateFlags2(deps, keys, distinctId) {
-  const query = keys.map(encodeURIComponent).join(",");
-  try {
-    const res = await deps.httpClient.get(`/sdk/flags/evaluate?keys=${query}`, {
-      headers: { "X-App-Key": deps.appKey, "x-distinct-id": distinctId }
-    });
-    if (!res.ok || typeof res.data !== "object" || res.data === null || Array.isArray(res.data)) return {};
-    const record = res.data;
-    const result = {};
-    for (const key of Object.keys(record)) {
-      const value = record[key];
-      const variant = typeof value === "string" ? value : null;
-      result[key] = variant;
-      const flagVariant = { variant };
-      deps.cache.setVariant(`${key}:${distinctId}`, flagVariant);
-      await writeFlagToStorage(key, distinctId, flagVariant);
-    }
-    return result;
-  } catch {
-    return {};
-  }
-}
-async function getConditionalFlag2(deps, flagKey, context) {
-  try {
-    const url = buildConditionalFlagUrl(deps.baseUrl, flagKey, context);
-    const response = await deps.get(url);
-    if (response.status === 404 || !response.ok) return { value: false, flagKey };
-    return { value: response.data.value, flagKey };
-  } catch {
-    return { value: false, flagKey };
-  }
-}
-async function getVariantFromCache(deps, flagKey, distinctId) {
-  const key = `${flagKey}:${distinctId}`;
-  const hit = deps.cache.getVariant(key);
-  if (hit !== void 0) return hit;
-  const persisted = await readFlagFromStorage(flagKey, distinctId);
-  if (persisted !== null) {
-    deps.cache.setVariant(key, persisted);
-    return persisted;
-  }
-  return null;
-}
-var init_ApiClientFlags = __esm({
-  "src/core/ApiClientFlags.ts"() {
-    "use strict";
-    init_apiUrlUtils();
-    init_FlagStorage();
-  }
-});
-
-// src/core/ApiClientQueue.ts
-async function postWithQueue(deps, url, payload, label, priority) {
-  if (deps.isOfflineQueueEnabled() && !networkMonitor.isOnline()) {
-    await offlineQueue.enqueue(
-      "POST",
-      url,
-      payload,
-      { "X-App-Key": deps.getAppKey() },
-      void 0,
-      priority
-    );
-    if (deps.isDebug()) console.log("[Paywallo:ApiClient] Queued for offline:", label, priority ?? "normal");
-    return;
-  }
-  try {
-    await deps.post(url, payload);
-  } catch (error) {
-    if (deps.isDebug()) console.log("[Paywallo:ApiClient] Request failed:", label, error);
-    if (deps.isOfflineQueueEnabled()) {
-      await offlineQueue.enqueue(
-        "POST",
-        url,
-        payload,
-        { "X-App-Key": deps.getAppKey() },
-        void 0,
-        priority
-      );
-      return;
-    }
-    throw error;
-  }
-}
-var init_ApiClientQueue = __esm({
-  "src/core/ApiClientQueue.ts"() {
-    "use strict";
-    init_network();
-    init_queue();
-  }
-});
-
-// src/core/events/schemas.ts
-import { z } from "zod";
-var lifecycleEventSchema, identifyEventSchema, paywallEventSchema, transactionEventSchema, onboardingEventSchema, notificationEventSchema, customEventSchema, EVENT_SCHEMAS;
-var init_schemas = __esm({
-  "src/core/events/schemas.ts"() {
-    "use strict";
-    lifecycleEventSchema = z.object({
-      type: z.enum([
-        "install",
-        "cold_start",
-        "foreground",
-        "background",
-        "session_start",
-        "session_end"
-      ]),
-      session_id: z.string().optional(),
-      duration_s: z.number().nonnegative().optional(),
-      first_ever: z.boolean().optional(),
-      // Contexto leve transportado em lifecycle (útil pra cold_start/install)
-      app_version: z.string().optional(),
-      device_type: z.enum(["ios", "android"]).optional(),
-      os_version: z.string().optional(),
-      // Timestamps opcionais — o EventBatcher injeta `timestamp` no envelope
-      started_at: z.string().optional(),
-      ended_at: z.string().optional()
-    }).strict();
-    identifyEventSchema = z.object({
-      distinct_id: z.string().min(1),
-      email: z.email().optional(),
-      traits: z.record(z.string(), z.unknown()).optional(),
-      attribution: z.record(z.string(), z.unknown()).optional(),
-      device: z.record(z.string(), z.unknown()).optional()
-    }).strict();
-    paywallEventSchema = z.object({
-      type: z.enum(["viewed", "closed", "purchased"]),
-      paywall_id: z.string().min(1),
-      placement: z.string().optional(),
-      variant_id: z.string().optional(),
-      variant_key: z.string().optional(),
-      campaign_id: z.string().optional(),
-      // `closed`-specific
-      closed_at: z.string().optional(),
-      duration_s: z.number().nonnegative().optional(),
-      close_reason: z.enum(["dismiss", "cta", "purchase", "error", "timeout"]).optional(),
-      scroll_depth: z.number().min(0).max(1).optional(),
-      // `purchased`-specific (mínimo — transaction canônica leva detalhes)
-      product_id: z.string().optional()
-    }).strict();
-    transactionEventSchema = z.object({
-      type: z.enum([
-        "completed",
-        "failed",
-        "refunded",
-        "renewed",
-        "canceled",
-        "expired"
-      ]),
-      tx_id: z.string().min(1),
-      amount: z.number().optional(),
-      currency: z.string().length(3).optional(),
-      product_id: z.string().optional(),
-      subscription_id: z.string().optional(),
-      paywall_id: z.string().optional(),
-      variant_id: z.string().optional(),
-      reason: z.string().optional()
-    }).strict();
-    onboardingEventSchema = z.object({
-      type: z.enum(["step", "complete", "drop"]),
-      step_index: z.number().int().nonnegative().optional(),
-      step_name: z.string().optional(),
-      variant_key: z.string().optional(),
-      time_on_prev_s: z.number().nonnegative().optional()
-    }).strict();
-    notificationEventSchema = z.object({
-      type: z.enum(["delivered", "displayed", "clicked", "dismissed"]),
-      notification_id: z.string().optional(),
-      campaign_id: z.string().optional(),
-      variant_key: z.string().nullable().optional(),
-      message_id: z.string().optional(),
-      device_id: z.string().optional(),
-      push_platform: z.enum(["ios", "android"]).optional(),
-      timezone: z.string().optional(),
-      failure_reason: z.string().optional(),
-      app_user_id: z.string().optional()
-    }).strict();
-    customEventSchema = z.object({
-      name: z.string().min(1).regex(
-        /^(\$[a-zA-Z0-9_]+|[a-z][a-z0-9_]*)$/,
-        "custom event name must be snake_case or $reserved"
-      ),
-      props: z.record(z.string(), z.unknown()).optional()
-    }).strict();
-    EVENT_SCHEMAS = {
-      lifecycle: lifecycleEventSchema,
-      identify: identifyEventSchema,
-      paywall: paywallEventSchema,
-      transaction: transactionEventSchema,
-      onboarding: onboardingEventSchema,
-      notification: notificationEventSchema,
-      custom: customEventSchema
-    };
+var init_FlagStorage = __esm({
+  "src/core/FlagStorage.ts"() {
+    "use strict";
+    init_SecureStorage();
+    FLAG_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
   }
 });
 
-// src/core/events/eventFamilies.ts
-function isDeprecatedEvent(eventName) {
-  return DEPRECATED_EVENT_NAMES.includes(eventName);
+// src/core/ApiClientFlags.ts
+async function getVariant2(deps, flagKey, distinctId) {
+  const key = `${flagKey}:${distinctId}`;
+  const hit = deps.cache.getVariant(key);
+  if (hit !== void 0) return hit;
+  const persisted = await readFlagFromStorage(flagKey, distinctId);
+  if (persisted !== null) {
+    deps.cache.setVariant(key, persisted);
+    return persisted;
+  }
+  try {
+    const res = await deps.get(`/sdk/flags/${flagKey}?distinctId=${encodeURIComponent(distinctId)}`);
+    if (res.status === 404) {
+      const v = { variant: null };
+      deps.cache.setVariant(key, v, deps.cache.nullTTL);
+      return v;
+    }
+    if (!res.ok) {
+      const stale = deps.cache.getStaleVariant(key);
+      return stale !== void 0 ? stale : { variant: null };
+    }
+    deps.cache.setVariant(key, res.data);
+    await writeFlagToStorage(flagKey, distinctId, res.data);
+    return res.data;
+  } catch {
+    const stale = deps.cache.getStaleVariant(key);
+    return stale !== void 0 ? stale : { variant: null };
+  }
 }
-function isCanonicalFamily(name) {
-  return CANONICAL_FAMILIES.includes(name);
+async function evaluateFlags2(deps, keys, distinctId) {
+  const query = keys.map(encodeURIComponent).join(",");
+  try {
+    const res = await deps.httpClient.get(`/sdk/flags/evaluate?keys=${query}`, {
+      headers: { "X-App-Key": deps.appKey, "x-distinct-id": distinctId }
+    });
+    if (!res.ok || typeof res.data !== "object" || res.data === null || Array.isArray(res.data)) return {};
+    const record = res.data;
+    const result = {};
+    for (const key of Object.keys(record)) {
+      const value = record[key];
+      const variant = typeof value === "string" ? value : null;
+      result[key] = variant;
+      const flagVariant = { variant };
+      deps.cache.setVariant(`${key}:${distinctId}`, flagVariant);
+      await writeFlagToStorage(key, distinctId, flagVariant);
+    }
+    return result;
+  } catch {
+    return {};
+  }
 }
-function detectFamily(eventName) {
-  if (isCanonicalFamily(eventName) && eventName !== "custom") {
-    return eventName;
+async function getConditionalFlag2(deps, flagKey, context) {
+  try {
+    const url = buildConditionalFlagUrl(deps.baseUrl, flagKey, context);
+    const response = await deps.get(url);
+    if (response.status === 404 || !response.ok) return { value: false, flagKey };
+    return { value: response.data.value, flagKey };
+  } catch {
+    return { value: false, flagKey };
   }
-  return "custom";
 }
-function validateEvent(eventName, properties) {
-  const family = detectFamily(eventName);
-  const schema = EVENT_SCHEMAS[family];
-  const input = family === "custom" ? { name: eventName, ...properties ? { props: properties } : {} } : properties ?? {};
-  const parsed = schema.safeParse(input);
-  if (parsed.success) {
-    return { ok: true, family, data: parsed.data };
+async function getVariantFromCache(deps, flagKey, distinctId) {
+  const key = `${flagKey}:${distinctId}`;
+  const hit = deps.cache.getVariant(key);
+  if (hit !== void 0) return hit;
+  const persisted = await readFlagFromStorage(flagKey, distinctId);
+  if (persisted !== null) {
+    deps.cache.setVariant(key, persisted);
+    return persisted;
   }
-  return { ok: false, family, error: parsed.error };
+  return null;
 }
-function formatValidationError(error) {
-  return error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+var init_ApiClientFlags = __esm({
+  "src/core/ApiClientFlags.ts"() {
+    "use strict";
+    init_apiUrlUtils();
+    init_FlagStorage();
+  }
+});
+
+// src/core/ApiClientQueue.ts
+async function postWithQueue(deps, url, payload, label, priority) {
+  if (deps.isOfflineQueueEnabled() && !networkMonitor.isOnline()) {
+    await offlineQueue.enqueue(
+      "POST",
+      url,
+      payload,
+      { "X-App-Key": deps.getAppKey() },
+      void 0,
+      priority
+    );
+    if (deps.isDebug()) console.log("[Paywallo:ApiClient] Queued for offline:", label, priority ?? "normal");
+    return;
+  }
+  try {
+    await deps.post(url, payload);
+  } catch (error) {
+    if (deps.isDebug()) console.log("[Paywallo:ApiClient] Request failed:", label, error);
+    if (deps.isOfflineQueueEnabled()) {
+      await offlineQueue.enqueue(
+        "POST",
+        url,
+        payload,
+        { "X-App-Key": deps.getAppKey() },
+        void 0,
+        priority
+      );
+      return;
+    }
+    throw error;
+  }
 }
-var CANONICAL_FAMILIES, DEPRECATED_EVENT_NAMES;
-var init_eventFamilies = __esm({
-  "src/core/events/eventFamilies.ts"() {
+var init_ApiClientQueue = __esm({
+  "src/core/ApiClientQueue.ts"() {
     "use strict";
-    init_schemas();
-    CANONICAL_FAMILIES = [
-      "lifecycle",
-      "identify",
-      "paywall",
-      "transaction",
-      "onboarding",
-      "notification",
-      "custom"
-    ];
-    DEPRECATED_EVENT_NAMES = [
-      "$paywall_purchased",
-      "$paywall_product_selected",
-      "$core_action",
-      "$campaign_impression",
-      "$app_open",
-      "$app_background",
-      "$app_foreground",
-      "session.end"
-    ];
+    init_network();
+    init_queue();
   }
 });
 
@@ -7104,6 +7443,9 @@ function buildV2Envelope(events, providerContext) {
   if (context.distinct_id === void 0 && events.length > 0) {
     context.distinct_id = events[0].distinctId;
   }
+  if (!context.distinct_id || context.distinct_id.length === 0) {
+    console.error("[Paywallo:ENVELOPE] distinct_id is empty after resolution \u2014 envelope will fail schema", { providerContext, eventCount: events.length, firstEventName: events[0]?.eventName });
+  }
   return { context, events: v2Events };
 }
 function resolveProviderContext(provider) {
@@ -7155,12 +7497,18 @@ var init_eventEnvelopeV2 = __esm({
       session_id: z2.string().optional(),
       device_id: z2.string().optional(),
       app_version: z2.string().optional(),
+      app_build: z2.string().optional(),
+      bundle_id: z2.string().optional(),
       sdk_version: z2.string().optional(),
       platform: z2.string().optional(),
       os_version: z2.string().optional(),
       device_model: z2.string().optional(),
       timezone: z2.string().optional(),
       locale: z2.string().optional(),
+      carrier: z2.string().optional(),
+      screen_width: z2.number().optional(),
+      screen_height: z2.number().optional(),
+      screen_density: z2.number().optional(),
       attribution: z2.record(z2.string(), z2.unknown()).optional(),
       ids: z2.record(z2.string(), z2.unknown()).optional()
     });
@@ -7173,12 +7521,21 @@ var init_eventEnvelopeV2 = __esm({
       session_id: ["session_id", "sessionId"],
       device_id: ["device_id", "deviceId"],
       app_version: ["app_version", "appVersion"],
+      // F2.2 — alias só snake_case canônico: campos vêm do context provider, não
+      // de properties de evento. Evita promover (e deletar) chaves do payload do
+      // $app_installed que o server lê (screenWidth etc.).
+      app_build: ["app_build"],
+      bundle_id: ["bundle_id"],
       sdk_version: ["sdk_version", "sdkVersion"],
       platform: ["platform"],
       os_version: ["os_version", "osVersion", "systemVersion"],
       device_model: ["device_model", "deviceModel", "model"],
       timezone: ["timezone", "timeZone"],
       locale: ["locale"],
+      carrier: ["carrier_ctx"],
+      screen_width: ["screen_width"],
+      screen_height: ["screen_height"],
+      screen_density: ["screen_density"],
       attribution: ["attribution"],
       ids: ["ids"]
     };
@@ -7305,8 +7662,8 @@ var init_EventBatcher = __esm({
         for (const event of drained) {
           try {
             await this.postBatch([event], `event_critical:${event.eventName}`, "critical");
-          } catch {
-            if (this.debug) console.log(`[Paywallo] critical event ${event.eventName} post failed`);
+          } catch (err) {
+            console.error("[Paywallo:CRITICAL] critical event post failed", { eventName: event.eventName, error: err instanceof Error ? err.message : String(err) });
           }
         }
       }
@@ -7319,8 +7676,8 @@ var init_EventBatcher = __esm({
         }
         try {
           await this.postBatch(batch, `event_batch:${batch.length}`);
-        } catch {
-          if (this.debug) console.log(`[Paywallo] normal batch post failed \u2014 OfflineQueue will handle durability`);
+        } catch (err) {
+          console.error("[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") {
@@ -7335,6 +7692,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 });
           throw parsed.error;
         }
         await this.post(V2_BATCH_ENDPOINT, parsed.data, label, priority);
@@ -7917,7 +8275,8 @@ function setupNotifications(apiClient, config, environment, eventPipeline) {
       httpClient: apiClient.getHttpClient(),
       secureStorage: new SecureStorage(config.debug),
       getDeviceId: () => identityManager.getDeviceId(),
-      getDistinctId: () => identityManager.getDistinctId()
+      getDistinctId: () => identityManager.getDistinctId(),
+      environment: environment === "Sandbox" ? "sandbox" : "production"
     });
     notificationsManager.setupHandlers({ eventBatcher: eventPipeline });
     notificationsManager.initialize({
@@ -8001,7 +8360,38 @@ var init_PaywalloState = __esm({
   }
 });
 
+// src/utils/detectEnvironment.ts
+import { NativeModules as NativeModules8 } from "react-native";
+async function detectEnvironment() {
+  if (cached !== null) return cached;
+  if (typeof globalThis.__DEV__ !== "undefined" && globalThis.__DEV__) {
+    cached = "sandbox";
+    return cached;
+  }
+  if (!nativeModule) {
+    cached = "production";
+    return cached;
+  }
+  try {
+    const result = await nativeModule.detect();
+    cached = result === "sandbox" ? "sandbox" : "production";
+    return cached;
+  } catch {
+    cached = "production";
+    return cached;
+  }
+}
+var nativeModule, cached;
+var init_detectEnvironment = __esm({
+  "src/utils/detectEnvironment.ts"() {
+    "use strict";
+    nativeModule = NativeModules8.PaywalloEnv ?? null;
+    cached = null;
+  }
+});
+
 // src/core/PaywalloInitializer.ts
+import { Dimensions as Dimensions4, PixelRatio as PixelRatio2 } from "react-native";
 async function initWithRetry(state, config) {
   while (state.initAttempts <= MAX_INIT_RETRIES) {
     try {
@@ -8080,7 +8470,13 @@ async function resolveSessionFlags(state, keys, apiClient, distinctId) {
   }
 }
 async function doInit(state, config) {
-  const environment = config.environment ?? (typeof __DEV__ !== "undefined" && __DEV__ ? "Sandbox" : "Production");
+  let environment;
+  if (config.environment) {
+    environment = config.environment;
+  } else {
+    const detected = await detectEnvironment();
+    environment = detected === "sandbox" ? "Sandbox" : "Production";
+  }
   const offlineQueueEnabled = config.offlineQueueEnabled !== false;
   await Promise.all([
     networkMonitor.initialize({ debug: config.debug }),
@@ -8168,15 +8564,31 @@ async function doInit(state, config) {
       timezone = opts.timeZone || void 0;
     } catch {
     }
+    let screenWidth;
+    let screenHeight;
+    let screenDensity;
+    try {
+      const screen = Dimensions4.get("screen");
+      screenWidth = Math.round(screen.width) || void 0;
+      screenHeight = Math.round(screen.height) || void 0;
+      screenDensity = PixelRatio2.get() || void 0;
+    } catch {
+    }
     return {
       distinct_id: identityManager.getDistinctId() || void 0,
       device_id: identityManager.getDeviceId() ?? void 0,
       session_id: sessionManager.getSessionId() ?? void 0,
       app_version: device?.appVersion && device.appVersion !== "0.0.0" ? device.appVersion : void 0,
+      app_build: device?.buildNumber && device.buildNumber !== "0" ? device.buildNumber : void 0,
+      bundle_id: device?.bundleId || void 0,
       os_version: device?.systemVersion && device.systemVersion !== "0.0.0" ? device.systemVersion : void 0,
       device_model: device?.modelId || device?.model || void 0,
       timezone,
       locale,
+      carrier: device?.carrier || void 0,
+      screen_width: screenWidth,
+      screen_height: screenHeight,
+      screen_density: screenDensity,
       ...attribution && Object.keys(attribution).length > 0 && { attribution },
       ...ids && Object.keys(ids).length > 0 && { ids }
     };
@@ -8248,6 +8660,7 @@ var init_PaywalloInitializer = __esm({
     init_PaywalloState();
     init_queue();
     init_NativeStorage();
+    init_detectEnvironment();
   }
 });
 
@@ -8270,6 +8683,7 @@ async function doFullReset(state) {
   offlineQueue.dispose();
   networkMonitor.dispose();
   campaignGateService.clearPreloaded();
+  paywallPreloadService.clear();
   await notificationsManager.invalidateLocalToken().catch(() => void 0);
   notificationsManager.destroy();
   deepLinkAttributionCapture.stop();
@@ -8304,6 +8718,7 @@ var init_PaywalloLifecycle = __esm({
     init_identity();
     init_DeepLinkAttributionCapture();
     init_notifications();
+    init_paywall();
     init_session();
     init_SubscriptionCache();
     init_network();
@@ -8607,6 +9022,15 @@ var init_PaywalloClient = __esm({
       isPreloaded(placement) {
         return campaignGateService.getPreloadedCampaign(placement) !== null;
       }
+      async preloadPaywall(placement) {
+        return paywallPreloadService.preload(this.getApiClientOrThrow(), placement);
+      }
+      async preloadPaywalls(placements) {
+        return paywallPreloadService.preloadMany(this.getApiClientOrThrow(), placements);
+      }
+      isPaywallPreloaded(placement) {
+        return paywallPreloadService.isPreloaded(placement);
+      }
       getAutoPreloadedPlacement() {
         return this.state.autoPreloadedPlacement;
       }
@@ -8705,8 +9129,8 @@ var init_OfferingService = __esm({
         this.config = config;
       }
       async getOfferings(ids) {
-        const cached = this.getMemCache();
-        if (cached && !cached.isStale) return this.filterByIds(cached.data, ids);
+        const cached2 = this.getMemCache();
+        if (cached2 && !cached2.isStale) return this.filterByIds(cached2.data, ids);
         if (!this.cache) {
           try {
             const stored = await secureStorage.get(OFFERINGS_CACHE_KEY);
@@ -8821,7 +9245,7 @@ init_session();
 init_PaywalloError();
 
 // src/hooks/useOfferingPurchase.ts
-import { useCallback as useCallback7, useState as useState6 } from "react";
+import { useCallback as useCallback7, useState as useState7 } from "react";
 
 // src/domains/plan/invalidateCache.ts
 async function invalidatePlanCache() {
@@ -8834,7 +9258,7 @@ async function invalidatePlanCache() {
 
 // src/hooks/useOfferingPurchase.ts
 function useOfferingPurchase() {
-  const [state, setState] = useState6("idle");
+  const [state, setState] = useState7("idle");
   const purchase = useCallback7(async (productId) => {
     setState("purchasing");
     try {
@@ -8859,7 +9283,7 @@ function useOfferingPurchase() {
 }
 
 // src/hooks/useOfferings.ts
-import { useCallback as useCallback8, useEffect as useEffect7, useState as useState7 } from "react";
+import { useCallback as useCallback8, useEffect as useEffect9, useState as useState8 } from "react";
 async function getOfferingService() {
   try {
     const mod = await Promise.resolve().then(() => (init_OfferingService(), OfferingService_exports));
@@ -8869,8 +9293,8 @@ async function getOfferingService() {
   }
 }
 function useOfferings(ids) {
-  const [offerings, setOfferings] = useState7([]);
-  const [isLoading, setIsLoading] = useState7(true);
+  const [offerings, setOfferings] = useState8([]);
+  const [isLoading, setIsLoading] = useState8(true);
   const idsKey = ids?.join(",") ?? "";
   const fetchOfferings = useCallback8(async () => {
     setIsLoading(true);
@@ -8888,7 +9312,7 @@ function useOfferings(ids) {
       setIsLoading(false);
     }
   }, [idsKey]);
-  useEffect7(() => {
+  useEffect9(() => {
     void fetchOfferings();
   }, [fetchOfferings]);
   return { offerings, isLoading };
@@ -8925,10 +9349,10 @@ function usePaywallo() {
 }
 
 // src/hooks/usePlanPurchase.ts
-import { useCallback as useCallback10, useState as useState8 } from "react";
+import { useCallback as useCallback10, useState as useState9 } from "react";
 function usePlanPurchase() {
-  const [state, setState] = useState8("idle");
-  const [error, setError] = useState8(null);
+  const [state, setState] = useState9("idle");
+  const [error, setError] = useState9(null);
   const purchase = useCallback10(async (productId) => {
     setState("purchasing");
     setError(null);
@@ -8981,7 +9405,7 @@ function usePlanPurchase() {
 }
 
 // src/hooks/usePlans.ts
-import { useCallback as useCallback11, useEffect as useEffect8, useState as useState9 } from "react";
+import { useCallback as useCallback11, useEffect as useEffect10, useState as useState10 } from "react";
 async function getPlanService() {
   try {
     const mod = await Promise.resolve().then(() => (init_PlanService(), PlanService_exports));
@@ -8991,10 +9415,10 @@ async function getPlanService() {
   }
 }
 function usePlans() {
-  const [allPlans, setAllPlans] = useState9([]);
-  const [currentPlan, setCurrentPlan] = useState9(null);
-  const [isLoading, setIsLoading] = useState9(true);
-  const [error, setError] = useState9(null);
+  const [allPlans, setAllPlans] = useState10([]);
+  const [currentPlan, setCurrentPlan] = useState10(null);
+  const [isLoading, setIsLoading] = useState10(true);
+  const [error, setError] = useState10(null);
   const fetchPlans = useCallback11(async (forceRefresh = false) => {
     setIsLoading(true);
     setError(null);
@@ -9019,14 +9443,14 @@ function usePlans() {
   const refresh = useCallback11(() => {
     return fetchPlans(true);
   }, [fetchPlans]);
-  useEffect8(() => {
+  useEffect10(() => {
     void fetchPlans(false);
   }, [fetchPlans]);
   return { currentPlan, allPlans, isLoading, error, refresh };
 }
 
 // src/hooks/useProducts.ts
-import { useCallback as useCallback12, useEffect as useEffect9, useState as useState10 } from "react";
+import { useCallback as useCallback12, useEffect as useEffect11, useState as useState11 } from "react";
 
 // src/utils/productMappers.ts
 function mapToIAPProduct(product) {
@@ -9065,10 +9489,10 @@ function mapToFormattedProduct(product) {
 
 // src/hooks/useProducts.ts
 function useProducts(initialProductIds) {
-  const [products, setProducts] = useState10([]);
-  const [formattedProducts, setFormattedProducts] = useState10([]);
-  const [isLoading, setIsLoading] = useState10(false);
-  const [error, setError] = useState10(null);
+  const [products, setProducts] = useState11([]);
+  const [formattedProducts, setFormattedProducts] = useState11([]);
+  const [isLoading, setIsLoading] = useState11(false);
+  const [error, setError] = useState11(null);
   const loadProducts = useCallback12(async (productIds) => {
     setIsLoading(true);
     setError(null);
@@ -9083,7 +9507,7 @@ function useProducts(initialProductIds) {
       setIsLoading(false);
     }
   }, []);
-  useEffect9(() => {
+  useEffect11(() => {
     if (initialProductIds && initialProductIds.length > 0) {
       void loadProducts(initialProductIds);
     }
@@ -9129,13 +9553,13 @@ function useProducts(initialProductIds) {
 }
 
 // src/hooks/usePurchase.ts
-import { useCallback as useCallback13, useState as useState11 } from "react";
+import { useCallback as useCallback13, useState as useState12 } from "react";
 function toIAPPurchase(p) {
   return { productId: p.productId, transactionId: p.transactionId, transactionDate: p.transactionDate, transactionReceipt: p.receipt };
 }
 function usePurchase() {
-  const [state, setState] = useState11("idle");
-  const [error, setError] = useState11(null);
+  const [state, setState] = useState12("idle");
+  const [error, setError] = useState12(null);
   const purchase = useCallback13(async (productId) => {
     setState("purchasing");
     setError(null);
@@ -9183,13 +9607,13 @@ function usePurchase() {
 }
 
 // src/hooks/useSubscription.ts
-import { useCallback as useCallback14, useEffect as useEffect10, useState as useState12 } from "react";
+import { useCallback as useCallback14, useEffect as useEffect12, useState as useState13 } from "react";
 init_SubscriptionManager();
 var EMPTY_ENTITLEMENTS = [];
 function useSubscription() {
-  const [status, setStatus] = useState12(null);
-  const [isLoading, setIsLoading] = useState12(true);
-  const [error, setError] = useState12(null);
+  const [status, setStatus] = useState13(null);
+  const [isLoading, setIsLoading] = useState13(true);
+  const [error, setError] = useState13(null);
   const refresh = useCallback14(async () => {
     setIsLoading(true);
     setError(null);
@@ -9216,7 +9640,7 @@ function useSubscription() {
       setIsLoading(false);
     }
   }, []);
-  useEffect10(() => {
+  useEffect12(() => {
     void subscriptionManager.getSubscriptionStatus().then((s) => {
       setStatus(s);
       setIsLoading(false);
@@ -9244,20 +9668,215 @@ function useSubscription() {
 }
 
 // src/PaywalloProvider.tsx
-import { useCallback as useCallback19, useEffect as useEffect12, useLayoutEffect, useMemo as useMemo2, useRef as useRef10, useState as useState16 } from "react";
-import { Animated as Animated3, Dimensions as Dimensions4, Easing as Easing2, StyleSheet as StyleSheet3 } from "react-native";
+import { useCallback as useCallback19, useEffect as useEffect14, useLayoutEffect, useMemo as useMemo3, useRef as useRef11, useState as useState17 } from "react";
+import { Animated as Animated4, Dimensions as Dimensions5, Easing as Easing2, StyleSheet as StyleSheet5 } from "react-native";
 init_PaywalloClient();
+init_NativeStorage();
 init_SecureStorage();
 init_campaign();
 init_paywall();
 init_paywall();
 init_paywall();
 init_paywall();
+init_paywall();
+init_paywall();
+
+// src/domains/paywall/SuperwallAutoBridge.ts
+init_PaywalloClient();
+
+// src/core/utils/eventId.ts
+function hashString(input) {
+  let h1 = 3735928559;
+  let h2 = 1103547991;
+  for (let i = 0; i < input.length; i++) {
+    const ch = input.charCodeAt(i);
+    h1 = Math.imul(h1 ^ ch, 2654435769);
+    h2 = Math.imul(h2 ^ ch, 1598716949);
+  }
+  h1 = Math.imul(h1 ^ h1 >>> 16, 73244475);
+  h1 ^= Math.imul(h2 ^ h2 >>> 13, 351452291);
+  h2 = Math.imul(h2 ^ h2 >>> 16, 73244475);
+  h2 ^= Math.imul(h1 ^ h1 >>> 13, 351452291);
+  const toHex = (n) => (n >>> 0).toString(16).padStart(8, "0");
+  return toHex(h1) + toHex(h2);
+}
+function buildDeterministicEventId(parts) {
+  const raw = hashString(parts.join("|"));
+  const p1 = raw.slice(0, 8);
+  const p2 = raw.slice(8, 12);
+  const p3 = "4" + raw.slice(13, 16);
+  const p4 = (parseInt(raw[16], 16) & 3 | 8).toString(16) + raw.slice(17, 20);
+  const p5 = raw.padEnd(32, "0").slice(20, 32);
+  return `${p1}-${p2}-${p3}-${p4}-${p5}`;
+}
+
+// src/domains/paywall/SuperwallAutoBridge.ts
+var bridgeStarted = false;
+var unsubscribe = null;
+var debugEnabled = false;
+function log(msg, data) {
+  if (!debugEnabled) return;
+  if (data !== void 0) {
+    console.log(`[Paywallo:SuperwallBridge] ${msg}`, data);
+  } else {
+    console.log(`[Paywallo:SuperwallBridge] ${msg}`);
+  }
+}
+function minuteBucket(ts) {
+  return String(Math.floor(ts / 6e4));
+}
+function buildEventId(type, identifier, ts) {
+  return buildDeterministicEventId(["sw", type, identifier, minuteBucket(ts)]);
+}
+async function trackPaywallEvent(type, identifier, ts, extra) {
+  const _eventId = buildEventId(type, identifier, ts);
+  try {
+    const cleanExtra = {};
+    if (extra) {
+      for (const [k, v] of Object.entries(extra)) if (v !== void 0) cleanExtra[k] = v;
+    }
+    await PaywalloClient.track("paywall", {
+      priority: "critical",
+      properties: {
+        type,
+        paywall_id: identifier,
+        ...cleanExtra
+      }
+    });
+  } catch (err) {
+    log("track error", { type, identifier, eventId: _eventId, err: String(err) });
+  }
+}
+function mapDismissToCloseReason(resultType) {
+  switch (resultType) {
+    case "purchased":
+      return "purchased";
+    case "restored":
+      return "purchased";
+    // restore counts as a purchase outcome for funnel
+    case "declined":
+      return "dismissed";
+    default:
+      return void 0;
+  }
+}
+function buildCallbacks() {
+  return {
+    onPaywallPresent: (info) => {
+      const ts = Date.now();
+      log("onPaywallPresent", { identifier: info.identifier });
+      void trackPaywallEvent("viewed", info.identifier, ts, {
+        placement: info.presentedByEventWithName,
+        variant_id: info.experiment?.variant?.id,
+        campaign_id: info.experiment?.id
+      });
+    },
+    onPaywallDismiss: (info, result) => {
+      const ts = Date.now();
+      log("onPaywallDismiss", { identifier: info.identifier, result: result.type });
+      void trackPaywallEvent("closed", info.identifier, ts, {
+        placement: info.presentedByEventWithName,
+        variant_id: info.experiment?.variant?.id,
+        campaign_id: info.experiment?.id,
+        close_reason: mapDismissToCloseReason(result.type),
+        closed_at: new Date(ts).toISOString()
+      });
+    },
+    onPurchase: (params) => {
+      const ts = Date.now();
+      const safe = params !== null && typeof params === "object" ? params : {};
+      const productId = "productId" in safe && typeof safe.productId === "string" ? safe.productId : "unknown";
+      const identifier = "paywallIdentifier" in safe && typeof safe.paywallIdentifier === "string" ? safe.paywallIdentifier : productId;
+      log("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) {
+        log("transactionComplete missing product \u2014 skipping transaction track");
+        return;
+      }
+      const productId = product.productIdentifier ?? product.id ?? "unknown";
+      const currency = product.currencyCode ?? "USD";
+      const price = product.price ?? 0;
+      const transactionId = transaction?.storeTransactionId ?? transaction?.originalTransactionIdentifier ?? `${productId}_${String(ts)}`;
+      const isTrial = product.hasFreeTrial === true || (product.trialPeriodPrice ?? 0) > 0;
+      const paywallIdentifier = ev.paywallInfo?.identifier;
+      log("onSuperwallEvent: transactionComplete", { productId, currency, price, transactionId, isTrial });
+      void (async () => {
+        try {
+          await PaywalloClient.track("transaction", {
+            priority: "critical",
+            properties: {
+              type: isTrial ? "trial_started" : "completed",
+              // Server's IngestTranslator looks for `transaction_id`/`product_id`
+              // /`amount`/`currency`/`paywall_id` keys (not `tx_id`). PurchaseHandler
+              // then resolves type=trial/new/renewal based on amount being 0 vs >0.
+              transaction_id: transactionId,
+              product_id: productId,
+              amount: price,
+              currency,
+              ...paywallIdentifier ? { paywall_id: paywallIdentifier } : {}
+            }
+          });
+        } catch (err) {
+          log("transactionComplete track error", { err: String(err) });
+        }
+      })();
+    }
+  };
+}
+function startSuperwallAutoBridge(debug = false) {
+  debugEnabled = debug;
+  if (bridgeStarted) {
+    log("already started, skipping");
+    return;
+  }
+  void detectAndStart();
+}
+async function detectAndStart() {
+  let subscribeFn;
+  try {
+    const mod = await import("expo-superwall");
+    if (!mod || typeof mod.subscribeToSuperwallEvents !== "function") {
+      const internal = await import("expo-superwall/build/src/internal/superwallEventBridge");
+      if (typeof internal.subscribeToSuperwallEvents !== "function") {
+        log("expo-superwall subscribeToSuperwallEvents not found \u2014 bridge inactive");
+        return;
+      }
+      subscribeFn = internal.subscribeToSuperwallEvents;
+    } else {
+      subscribeFn = mod.subscribeToSuperwallEvents;
+    }
+  } catch {
+    log("expo-superwall not installed \u2014 bridge inactive");
+    return;
+  }
+  try {
+    const callbacks = buildCallbacks();
+    unsubscribe = subscribeFn(void 0, () => callbacks);
+    bridgeStarted = true;
+    log("bridge started");
+  } catch (err) {
+    log("subscribe failed", { err: String(err) });
+  }
+}
+
+// src/PaywalloProvider.tsx
 init_session();
 init_ClientError();
 
 // src/hooks/useAppAutoEvents.ts
-import { useEffect as useEffect11, useRef as useRef7 } from "react";
+import { useEffect as useEffect13, useRef as useRef8 } from "react";
 
 // src/utils/platformDetection.ts
 async function detectPlatform3() {
@@ -9279,12 +9898,13 @@ async function detectOsVersion() {
 }
 
 // src/hooks/useAppAutoEvents.ts
-var FIRST_SEEN_KEY = "@paywallo:firstSeen";
+var FIRST_SEEN_KEY = "@paywallo:firstSeen_v226";
 var DEBOUNCE_MS = 1e3;
 function useAppAutoEvents(config) {
   const { isInitialized, getAppVersion: getAppVersion2, getSessionId, emitLifecycle, storageGet, storageSet, debug } = config;
-  const didRunRef = useRef7(false);
-  useEffect11(() => {
+  const didRunRef = useRef8(false);
+  useEffect13(() => {
+    if (debug) console.log("[Paywallo EVENTS] useEffect fired", { isInitialized, didRunRefCurrent: didRunRef.current });
     if (!isInitialized || didRunRef.current) return;
     const timer = setTimeout(() => {
       if (didRunRef.current) return;
@@ -9294,17 +9914,23 @@ function useAppAutoEvents(config) {
         const appVersion = getAppVersion2();
         const deviceType = await detectPlatform3();
         const osVersion = await detectOsVersion();
+        if (debug) console.log("[Paywallo EVENTS] computed device context", { deviceType, osVersion, appVersion, sessionId, hasSessionId: !!sessionId });
         try {
+          if (debug) console.log("[Paywallo EVENTS] checking install \u2014 about to read FIRST_SEEN_KEY");
           const firstSeen = await storageGet(FIRST_SEEN_KEY);
           if (!firstSeen) {
             await emitLifecycle({ type: "install", device_type: deviceType, os_version: osVersion, app_version: appVersion, ...sessionId ? { session_id: sessionId } : {} }, "critical");
             await storageSet(FIRST_SEEN_KEY, (/* @__PURE__ */ new Date()).toISOString());
+            if (debug) console.log("[Paywallo EVENTS] install event emitted (first time)");
             if (debug) console.log("[Paywallo EVENTS] lifecycle install emitted");
+          } else {
+            if (debug) console.log("[Paywallo EVENTS] install skipped \u2014 firstSeen already exists", { firstSeen });
           }
         } catch (err) {
           if (debug) console.log("[Paywallo EVENTS] lifecycle install check failed", err);
         }
         try {
+          if (debug) console.log("[Paywallo EVENTS] emitting cold_start");
           await emitLifecycle({ type: "cold_start", app_version: appVersion, device_type: deviceType, os_version: osVersion, ...sessionId ? { session_id: sessionId } : {} }, "normal");
           if (debug) console.log("[Paywallo EVENTS] lifecycle cold_start emitted");
         } catch (err) {
@@ -9319,7 +9945,7 @@ function useAppAutoEvents(config) {
 // src/hooks/useCampaignPreload.ts
 init_PaywalloClient();
 init_CampaignError();
-import { useCallback as useCallback15, useRef as useRef8, useState as useState13 } from "react";
+import { useCallback as useCallback15, useRef as useRef9, useState as useState14 } from "react";
 
 // src/utils/loadCampaignProducts.ts
 init_IAPService();
@@ -9388,8 +10014,8 @@ function getCacheEntry(cache, placement) {
 
 // src/hooks/useCampaignPreload.ts
 function useCampaignPreload() {
-  const [preloadedWebView, setPreloadedWebView] = useState13(null);
-  const preloadedCampaignsRef = useRef8(/* @__PURE__ */ new Map());
+  const [preloadedWebView, setPreloadedWebView] = useState14(null);
+  const preloadedCampaignsRef = useRef9(/* @__PURE__ */ new Map());
   const isPreloadValid = useCallback15(
     (placement) => isCacheEntryValid(preloadedCampaignsRef.current.get(placement)),
     []
@@ -9467,10 +10093,10 @@ function useCampaignPreload() {
 }
 
 // src/hooks/useProductLoader.ts
-import { useCallback as useCallback16, useState as useState14 } from "react";
+import { useCallback as useCallback16, useState as useState15 } from "react";
 function useProductLoader() {
-  const [products, setProducts] = useState14(/* @__PURE__ */ new Map());
-  const [isLoadingProducts, setIsLoadingProducts] = useState14(false);
+  const [products, setProducts] = useState15(/* @__PURE__ */ new Map());
+  const [isLoadingProducts, setIsLoadingProducts] = useState15(false);
   const refreshProducts = useCallback16(async (productIds) => {
     setIsLoadingProducts(true);
     try {
@@ -9556,7 +10182,7 @@ function usePurchaseOrchestrator(preloadedWebView, resolvePreloadedPaywall, clea
 // src/hooks/useSubscriptionSync.ts
 init_PaywalloClient();
 init_SubscriptionCache();
-import { useCallback as useCallback18, useRef as useRef9, useState as useState15 } from "react";
+import { useCallback as useCallback18, useRef as useRef10, useState as useState16 } from "react";
 
 // src/hooks/subscriptionSyncHelpers.ts
 init_SubscriptionCache();
@@ -9619,9 +10245,9 @@ function subscriptionInfoToSub(s) {
 }
 async function resolveOfflineFromCache(distinctId) {
   try {
-    const cached = await subscriptionCache.get(distinctId);
-    if (!cached) return false;
-    const sub = cached.data.subscription;
+    const cached2 = await subscriptionCache.get(distinctId);
+    if (!cached2) return false;
+    const sub = cached2.data.subscription;
     return isSubscriptionStillActive(
       sub ? { status: sub.status, expiresAt: sub.expiresAt ?? null } : null
     );
@@ -9664,8 +10290,8 @@ async function checkPersistedCache(distinctId, onHit) {
 
 // src/hooks/useSubscriptionSync.ts
 function useSubscriptionSync() {
-  const [subscription, setSubscription] = useState15(null);
-  const cacheRef = useRef9(null);
+  const [subscription, setSubscription] = useState16(null);
+  const cacheRef = useRef10(null);
   const setCacheAndState = useCallback18((sub) => {
     cacheRef.current = { data: sub, expiresAt: Date.now() + CACHE_TTL_MS2 };
     setSubscription(sub);
@@ -9691,8 +10317,8 @@ function useSubscriptionSync() {
     if (!apiClient || !distinctId) return false;
     const storeKitResult = await checkStoreKitActive(PaywalloClient.getConfig()?.debug);
     if (storeKitResult !== null) return storeKitResult;
-    const cached = cacheRef.current;
-    if (cached && cached.expiresAt > Date.now()) return isActiveCacheEntry(cached);
+    const cached2 = cacheRef.current;
+    if (cached2 && cached2.expiresAt > Date.now()) return isActiveCacheEntry(cached2);
     const persistedResult = await checkPersistedCache(distinctId, (sub) => setCacheAndState(sub));
     if (persistedResult !== null) return persistedResult;
     try {
@@ -9709,8 +10335,8 @@ function useSubscriptionSync() {
     const apiClient = PaywalloClient.getApiClient();
     const distinctId = PaywalloClient.getDistinctId();
     if (!apiClient || !distinctId) return null;
-    const cached = cacheRef.current;
-    if (cached && cached.expiresAt > Date.now()) return cached.data;
+    const cached2 = cacheRef.current;
+    if (cached2 && cached2.expiresAt > Date.now()) return cached2.data;
     try {
       return await fetchAndCache();
     } catch {
@@ -9728,22 +10354,22 @@ function useSubscriptionSync() {
 
 // src/PaywalloProvider.tsx
 init_localization();
-import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
+import { jsx as jsx5, jsxs as jsxs3 } from "react/jsx-runtime";
 function PaywalloProvider({ children, config }) {
-  const [isInitialized, setIsInitialized] = useState16(false);
-  const [initError, setInitError] = useState16(null);
-  const [distinctId, setDistinctId] = useState16(null);
-  const [activePaywall, setActivePaywall] = useState16(null);
+  const [isInitialized, setIsInitialized] = useState17(false);
+  const [initError, setInitError] = useState17(null);
+  const [distinctId, setDistinctId] = useState17(null);
+  const [activePaywall, setActivePaywall] = useState17(null);
   const { products, isLoadingProducts, refreshProducts } = useProductLoader();
   const { subscription, hasActiveSubscription, getSubscription, invalidateCache } = useSubscriptionSync();
   const { preloadedWebView, setPreloadedWebView, preloadCampaign, consumePreloadedCampaign, isPreloadValid } = useCampaignPreload();
   const clearPreloadedWebView = useCallback19(() => setPreloadedWebView(null), [setPreloadedWebView]);
-  const autoPreloadTriggeredRef = useRef10(false);
-  const preloadedWebViewRef = useRef10(preloadedWebView);
-  const pollTimerRef = useRef10(null);
-  const pollCancelledRef = useRef10(false);
-  const secureStorageRef = useRef10(new SecureStorage(config.debug));
-  useEffect12(() => {
+  const autoPreloadTriggeredRef = useRef11(false);
+  const preloadedWebViewRef = useRef11(preloadedWebView);
+  const pollTimerRef = useRef11(null);
+  const pollCancelledRef = useRef11(false);
+  const secureStorageRef = useRef11(new SecureStorage(config.debug));
+  useEffect14(() => {
     preloadedWebViewRef.current = preloadedWebView;
   }, [preloadedWebView]);
   useAppAutoEvents({
@@ -9755,8 +10381,18 @@ function PaywalloProvider({ children, config }) {
       for (const [k, v] of Object.entries(props)) if (v !== void 0) flat[k] = v;
       return PaywalloClient.track("lifecycle", { properties: flat, priority });
     },
-    storageGet: (key) => secureStorageRef.current.get(key),
-    storageSet: (key, value) => secureStorageRef.current.set(key, value),
+    storageGet: async (key) => {
+      if (key === "@paywallo:firstSeen_v226") {
+        return nativeStorage.get(key);
+      }
+      return secureStorageRef.current.get(key);
+    },
+    storageSet: async (key, value) => {
+      if (key === "@paywallo:firstSeen_v226") {
+        return nativeStorage.set(key, value);
+      }
+      return secureStorageRef.current.set(key, value);
+    },
     debug: config.debug
   });
   const triggerRepreload = useCallback19((placement) => {
@@ -9764,8 +10400,8 @@ function PaywalloProvider({ children, config }) {
     });
   }, []);
   const { showingPreloadedWebView, presentPreloadedWebView, resolvePreloadedPaywall, handlePreloadedWebViewReady: baseHandlePreloadedWebViewReady, handlePreloadedClose: baseHandlePreloadedClose, setShowingPreloadedWebView, presentedAtRef } = usePaywallPresenter(preloadedWebView, setPreloadedWebView);
-  const SCREEN_HEIGHT = useMemo2(() => Dimensions4.get("window").height, []);
-  const slideAnim = useRef10(new Animated3.Value(SCREEN_HEIGHT)).current;
+  const SCREEN_HEIGHT = useMemo3(() => Dimensions5.get("window").height, []);
+  const slideAnim = useRef11(new Animated4.Value(SCREEN_HEIGHT)).current;
   const handlePreloadedWebViewReady = useCallback19(() => {
     if (PaywalloClient.getConfig()?.debug) {
       console.log(`[Paywallo WEBVIEW] loaded \u2014 placement: ${preloadedWebView?.placement}`);
@@ -9774,7 +10410,7 @@ function PaywalloProvider({ children, config }) {
   }, [preloadedWebView?.placement, baseHandlePreloadedWebViewReady]);
   const handlePreloadedClose = useCallback19(() => {
     const placement = preloadedWebView?.placement;
-    Animated3.timing(slideAnim, { toValue: SCREEN_HEIGHT, duration: 200, easing: Easing2.in(Easing2.cubic), useNativeDriver: true }).start(() => {
+    Animated4.timing(slideAnim, { toValue: SCREEN_HEIGHT, duration: 200, easing: Easing2.in(Easing2.cubic), useNativeDriver: true }).start(() => {
       baseHandlePreloadedClose();
       if (placement) triggerRepreload(placement);
     });
@@ -9787,7 +10423,7 @@ function PaywalloProvider({ children, config }) {
     presentedAtRef,
     invalidateCache
   );
-  const [isPreloadPurchasing, setIsPreloadPurchasing] = useState16(false);
+  const [isPreloadPurchasing, setIsPreloadPurchasing] = useState17(false);
   const handlePreloadedPurchase = useCallback19(async (productId) => {
     setIsPreloadPurchasing(true);
     try {
@@ -9796,19 +10432,25 @@ function PaywalloProvider({ children, config }) {
       setIsPreloadPurchasing(false);
     }
   }, [rawPreloadedPurchase]);
-  const configRef = useRef10(config);
-  useEffect12(() => {
+  const configRef = useRef11(config);
+  useEffect14(() => {
     let mounted = true;
     initLocalization({ detectDevice: true });
     PaywalloClient.init(configRef.current).then(async () => {
       if (!mounted) return;
       setDistinctId(PaywalloClient.getDistinctId());
+      startSuperwallAutoBridge(configRef.current.debug);
       setIsInitialized(true);
       if (!autoPreloadTriggeredRef.current) {
         autoPreloadTriggeredRef.current = true;
         const placement = await PaywalloClient.waitForAutoPreloadedPlacement();
         if (mounted && placement) void preloadCampaign(placement).catch(() => {
         });
+        const preloadPlacements = configRef.current.preloadPaywalls;
+        if (mounted && preloadPlacements && preloadPlacements.length > 0) {
+          void PaywalloClient.preloadPaywalls(preloadPlacements).catch(() => {
+          });
+        }
       }
     }).catch((err) => {
       if (!mounted) return;
@@ -9823,7 +10465,21 @@ function PaywalloProvider({ children, config }) {
     return api ? api.getPaywall(p) : null;
   }, []);
   const presentPaywall = useCallback19((placement) => {
-    return new Promise((resolve) => setActivePaywall({ placement, resolver: resolve }));
+    const preloaded = paywallPreloadService.getPreloaded(placement);
+    return new Promise((resolve) => setActivePaywall({
+      placement,
+      resolver: resolve,
+      ...preloaded && {
+        paywallConfig: {
+          id: preloaded.config.id,
+          placement: preloaded.config.placement,
+          config: preloaded.config.config,
+          primaryProductId: preloaded.config.primaryProductId,
+          secondaryProductId: preloaded.config.secondaryProductId
+        },
+        preloadedProducts: preloaded.products
+      }
+    }));
   }, []);
   const trackCampaignImpression = useCallback19((placement, variantKey, campaignId) => {
     const api = PaywalloClient.getApiClient();
@@ -9957,7 +10613,7 @@ function PaywalloProvider({ children, config }) {
     }
     return presentCampaign(placement);
   }, [presentPreloadedWebView, presentCampaign]);
-  useEffect12(() => {
+  useEffect14(() => {
     if (!isInitialized) return;
     const onEmergency = async (id) => {
       try {
@@ -9986,7 +10642,7 @@ function PaywalloProvider({ children, config }) {
   const isReady = isInitialized && !isLoadingProducts;
   const noOp = useCallback19(() => {
   }, []);
-  const contextValue = useMemo2(() => ({
+  const contextValue = useMemo3(() => ({
     config: PaywalloClient.getConfig(),
     isInitialized,
     isReady,
@@ -10023,17 +10679,17 @@ function PaywalloProvider({ children, config }) {
   useLayoutEffect(() => {
     if (showingPreloadedWebView) {
       slideAnim.setValue(SCREEN_HEIGHT);
-      Animated3.timing(slideAnim, { toValue: 0, duration: 200, easing: Easing2.out(Easing2.cubic), useNativeDriver: true }).start();
+      Animated4.timing(slideAnim, { toValue: 0, duration: 200, easing: Easing2.out(Easing2.cubic), useNativeDriver: true }).start();
     }
   }, [showingPreloadedWebView, slideAnim, SCREEN_HEIGHT]);
   const preloadStyle = [
-    styles3.preloadOverlay,
-    showingPreloadedWebView ? styles3.visible : styles3.hidden,
+    styles5.preloadOverlay,
+    showingPreloadedWebView ? styles5.visible : styles5.hidden,
     showingPreloadedWebView ? { transform: [{ translateY: slideAnim }] } : void 0
   ];
-  return /* @__PURE__ */ jsxs2(PaywalloContext.Provider, { value: contextValue, children: [
+  return /* @__PURE__ */ jsxs3(PaywalloContext.Provider, { value: contextValue, children: [
     children,
-    /* @__PURE__ */ jsx3(PaywallErrorBoundary, { children: !!preloadedWebView?.craftData && /* @__PURE__ */ jsx3(Animated3.View, { style: preloadStyle, pointerEvents: showingPreloadedWebView ? "auto" : "none", children: /* @__PURE__ */ jsx3(
+    /* @__PURE__ */ jsx5(PaywallErrorBoundary, { children: !!preloadedWebView?.craftData && /* @__PURE__ */ jsx5(Animated4.View, { style: preloadStyle, pointerEvents: showingPreloadedWebView ? "auto" : "none", children: /* @__PURE__ */ jsx5(
       PaywallWebView,
       {
         paywallId: preloadedWebView.paywallId,
@@ -10049,7 +10705,7 @@ function PaywalloProvider({ children, config }) {
         onRestore: showingPreloadedWebView ? handlePreloadedRestore : noOp
       }
     ) }) }),
-    /* @__PURE__ */ jsx3(PaywallErrorBoundary, { children: activePaywall && /* @__PURE__ */ jsx3(
+    /* @__PURE__ */ jsx5(PaywallErrorBoundary, { children: activePaywall && /* @__PURE__ */ jsx5(
       PaywallModal,
       {
         placement: activePaywall.placement,
@@ -10061,10 +10717,11 @@ function PaywalloProvider({ children, config }) {
         campaignId: activePaywall.campaignId,
         variantId: activePaywall.variantId
       }
-    ) })
+    ) }),
+    isInitialized && (config.preloadPaywalls?.length ?? 0) > 0 && PaywalloClient.getWebUrl() !== null && /* @__PURE__ */ jsx5(PaywallWebViewPrewarmer, { webUrl: PaywalloClient.getWebUrl() })
   ] });
 }
-var styles3 = StyleSheet3.create({
+var styles5 = StyleSheet5.create({
   preloadOverlay: { position: "absolute", top: 0, left: 0, right: 0, bottom: 0, backgroundColor: "#ffffff" },
   hidden: { zIndex: -1, opacity: 0, width: 1, height: 1, overflow: "hidden" },
   visible: { zIndex: 9999, opacity: 1 }