@virex-tech/paywallo-sdk 2.2.4 → 2.2.6

package/dist/index.js

@@ -830,9 +830,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;
@@ -841,7 +841,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;
@@ -2024,13 +2024,21 @@ var init_NativePushBridge = __esm({
           if (!raw || typeof raw !== "object") return null;
           const r = raw;
           const notification = r["notification"];
+          const asString = (v) => typeof v === "string" ? v : void 0;
           return {
-            messageId: typeof r["messageId"] === "string" ? r["messageId"] : void 0,
+            messageId: asString(r["messageId"]),
             data: typeof r["data"] === "object" && r["data"] !== null ? r["data"] : void 0,
             notification: notification && typeof notification === "object" ? {
-              title: typeof notification["title"] === "string" ? notification["title"] : void 0,
-              body: typeof notification["body"] === "string" ? notification["body"] : void 0
+              title: asString(notification["title"]),
+              body: asString(notification["body"]),
+              imageUrl: asString(notification["imageUrl"])
             } : void 0,
+            // Pass through top-level title/body/imageUrl emitted by the native modules
+            // (both iOS and Android currently emit these at the top level rather than
+            // nested under `notification`).
+            title: asString(r["title"]),
+            body: asString(r["body"]),
+            imageUrl: asString(r["imageUrl"]),
             sentTime: typeof r["sentTime"] === "number" ? r["sentTime"] : void 0
           };
         } catch {
@@ -2165,12 +2173,13 @@ 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,
-      title: data["title"] ?? message.notification?.title ?? "",
-      body: data["body"] ?? message.notification?.body ?? ""
+      title: data["title"] ?? message.notification?.title ?? message.title ?? "",
+      body: data["body"] ?? message.notification?.body ?? message.body ?? "",
+      imageUrl: data["imageUrl"] ?? message.notification?.imageUrl ?? message.imageUrl
     });
     if (debug) console.log("[Paywallo PUSH] foreground message received:", payload.notificationId);
     onReceive(payload);
@@ -2182,7 +2191,7 @@ function setupForegroundHandler(deps, onReceive) {
       messageId
     });
   });
-  return unsubscribe;
+  return unsubscribe2;
 }
 var init_ForegroundHandler = __esm({
   "src/domains/notifications/handlers/ForegroundHandler.ts"() {
@@ -2361,8 +2370,8 @@ async function getInitialNotificationPayload(bridge) {
     notificationId: String(data["notificationId"] ?? data["notification_id"] ?? ""),
     campaignId: String(data["campaignId"] ?? data["campaign_id"] ?? ""),
     variantKey: data["variantKey"] != null ? String(data["variantKey"]) : void 0,
-    title: String(data["title"] ?? message.notification?.title ?? ""),
-    body: String(data["body"] ?? message.notification?.body ?? ""),
+    title: String(data["title"] ?? message.notification?.title ?? message.title ?? ""),
+    body: String(data["body"] ?? message.notification?.body ?? message.body ?? ""),
     data
   };
 }
@@ -2377,8 +2386,8 @@ var init_NotificationHandlerSetup = __esm({
 // src/core/version.ts
 function resolveVersion() {
   try {
-    if ("2.2.4") {
-      return "2.2.4";
+    if ("2.2.6") {
+      return "2.2.6";
     }
   } catch {
   }
@@ -2450,9 +2459,6 @@ function mapPermissionStatus(status) {
 function detectPlatform2() {
   return import_react_native11.Platform.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));
@@ -2493,7 +2499,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,
@@ -2504,7 +2510,7 @@ async function buildRegistration(token, getDeviceId, getDistinctId) {
     deviceId: getDeviceId?.() ?? void 0,
     locale: await getLocale(),
     timezone: getTimezone2(),
-    environment: detectEnvironment()
+    environment
   };
 }
 async function registerToken(deps, token) {
@@ -2513,7 +2519,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,
@@ -2563,7 +2570,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
   );
@@ -2580,7 +2588,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);
@@ -2788,6 +2797,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;
@@ -2807,6 +2817,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);
@@ -2849,7 +2860,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) {
@@ -3910,6 +3922,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.
@@ -3932,9 +3970,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;
           }
@@ -4113,10 +4151,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(
@@ -4723,12 +4761,25 @@ var init_QueueProcessor = __esm({
           const freshHeaders = this.config.getFreshHeaders?.() ?? {};
           const headers = { ...persistedHeaders, ...freshHeaders };
           this.log("Sending event batch", { size: batch.length, batchIndex: Math.floor(i / BATCH_SIZE) });
-          const response = await this.httpClient.request("/sdk/ingest/batch", {
-            method: "POST",
-            body: { events: bodies },
-            headers,
-            skipRetry: false
-          });
+          let response;
+          try {
+            response = await this.httpClient.request("/sdk/ingest/batch", {
+              method: "POST",
+              body: { events: bodies },
+              headers,
+              skipRetry: false
+            });
+          } catch (error) {
+            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)
+            });
+            continue;
+          }
           if (response.ok) {
             for (const item of batch) {
               await offlineQueue.removeItem(item.id);
@@ -4740,14 +4791,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
@@ -4768,12 +4830,22 @@ var init_QueueProcessor = __esm({
         });
         const persistedHeaders = item.headers ?? {};
         const freshHeaders = this.config.getFreshHeaders?.() ?? {};
-        const response = await this.httpClient.request(item.url, {
-          method: item.method,
-          body: item.body,
-          headers: { ...persistedHeaders, ...freshHeaders },
-          skipRetry: false
-        });
+        let response;
+        try {
+          response = await this.httpClient.request(item.url, {
+            method: item.method,
+            body: item.body,
+            headers: { ...persistedHeaders, ...freshHeaders },
+            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)
+          });
+          return { success: false, permanent: false };
+        }
         if (response.ok) {
           this.log("Queue item processed successfully", { id: item.id });
           return { success: true, permanent: false };
@@ -5064,6 +5136,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`);
@@ -5853,10 +5926,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;
           }
@@ -5883,8 +5956,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 {
@@ -6002,6 +6075,163 @@ var init_analytics = __esm({
   }
 });
 
+// src/core/events/schemas.ts
+var import_zod, lifecycleEventSchema, identifyEventSchema, paywallEventSchema, transactionEventSchema, onboardingEventSchema, notificationEventSchema, customEventSchema, EVENT_SCHEMAS;
+var init_schemas = __esm({
+  "src/core/events/schemas.ts"() {
+    "use strict";
+    import_zod = require("zod");
+    lifecycleEventSchema = import_zod.z.object({
+      type: import_zod.z.enum([
+        "install",
+        "cold_start",
+        "foreground",
+        "background",
+        "session_start",
+        "session_end"
+      ]),
+      session_id: import_zod.z.string().optional(),
+      duration_s: import_zod.z.number().nonnegative().optional(),
+      first_ever: import_zod.z.boolean().optional(),
+      // Contexto leve transportado em lifecycle (útil pra cold_start/install)
+      app_version: import_zod.z.string().optional(),
+      device_type: import_zod.z.enum(["ios", "android"]).optional(),
+      os_version: import_zod.z.string().optional(),
+      // Timestamps opcionais — o EventBatcher injeta `timestamp` no envelope
+      started_at: import_zod.z.string().optional(),
+      ended_at: import_zod.z.string().optional()
+    }).strict();
+    identifyEventSchema = import_zod.z.object({
+      distinct_id: import_zod.z.string().min(1),
+      email: import_zod.z.email().optional(),
+      traits: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional(),
+      attribution: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional(),
+      device: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional()
+    }).strict();
+    paywallEventSchema = import_zod.z.object({
+      type: import_zod.z.enum(["viewed", "closed", "purchased"]),
+      paywall_id: import_zod.z.string().min(1),
+      placement: import_zod.z.string().optional(),
+      variant_id: import_zod.z.string().optional(),
+      variant_key: import_zod.z.string().optional(),
+      campaign_id: import_zod.z.string().optional(),
+      // `closed`-specific
+      closed_at: import_zod.z.string().optional(),
+      duration_s: import_zod.z.number().nonnegative().optional(),
+      close_reason: import_zod.z.enum(["dismiss", "cta", "purchase", "error", "timeout"]).optional(),
+      scroll_depth: import_zod.z.number().min(0).max(1).optional(),
+      // `purchased`-specific (mínimo — transaction canônica leva detalhes)
+      product_id: import_zod.z.string().optional()
+    }).strict();
+    transactionEventSchema = import_zod.z.object({
+      type: import_zod.z.enum([
+        "completed",
+        "failed",
+        "refunded",
+        "renewed",
+        "canceled",
+        "expired"
+      ]),
+      tx_id: import_zod.z.string().min(1),
+      amount: import_zod.z.number().optional(),
+      currency: import_zod.z.string().length(3).optional(),
+      product_id: import_zod.z.string().optional(),
+      subscription_id: import_zod.z.string().optional(),
+      paywall_id: import_zod.z.string().optional(),
+      variant_id: import_zod.z.string().optional(),
+      reason: import_zod.z.string().optional()
+    }).strict();
+    onboardingEventSchema = import_zod.z.object({
+      type: import_zod.z.enum(["step", "complete", "drop"]),
+      step_index: import_zod.z.number().int().nonnegative().optional(),
+      step_name: import_zod.z.string().optional(),
+      variant_key: import_zod.z.string().optional(),
+      time_on_prev_s: import_zod.z.number().nonnegative().optional()
+    }).strict();
+    notificationEventSchema = import_zod.z.object({
+      type: import_zod.z.enum(["delivered", "displayed", "clicked", "dismissed"]),
+      notification_id: import_zod.z.string().optional(),
+      campaign_id: import_zod.z.string().optional(),
+      variant_key: import_zod.z.string().nullable().optional(),
+      message_id: import_zod.z.string().optional(),
+      device_id: import_zod.z.string().optional(),
+      push_platform: import_zod.z.enum(["ios", "android"]).optional(),
+      timezone: import_zod.z.string().optional(),
+      failure_reason: import_zod.z.string().optional(),
+      app_user_id: import_zod.z.string().optional()
+    }).strict();
+    customEventSchema = import_zod.z.object({
+      name: import_zod.z.string().min(1).regex(
+        /^(\$[a-zA-Z0-9_]+|[a-z][a-z0-9_]*)$/,
+        "custom event name must be snake_case or $reserved"
+      ),
+      props: import_zod.z.record(import_zod.z.string(), import_zod.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);
@@ -6010,7 +6240,7 @@ function isValidEventName(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)`);
+    console.error("[Paywallo:DROP] event dropped \u2014 no distinctId available yet", { eventName });
     return;
   }
   if (!isValidEventName(eventName)) {
@@ -6019,10 +6249,14 @@ async function trackEvent(apiClient, state, eventName, options) {
   }
   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,
-    { ...identityManager.getProperties(), ...options?.properties, ...sessionId && { sessionId } },
+    { ...identityProps, ...options?.properties, ...sessionProp },
     options?.timestamp,
     options?.priority ? { priority: options.priority } : void 0
   );
@@ -6052,6 +6286,7 @@ var init_PaywalloAnalytics = __esm({
     init_identity();
     init_session();
     init_ClientError();
+    init_eventFamilies();
   }
 });
 
@@ -6316,49 +6551,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 {
         }
@@ -6402,8 +6637,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;
@@ -6459,9 +6694,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 {
@@ -6471,9 +6706,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();
         }
@@ -6888,163 +7123,6 @@ var init_ApiClientQueue = __esm({
   }
 });
 
-// src/core/events/schemas.ts
-var import_zod, lifecycleEventSchema, identifyEventSchema, paywallEventSchema, transactionEventSchema, onboardingEventSchema, notificationEventSchema, customEventSchema, EVENT_SCHEMAS;
-var init_schemas = __esm({
-  "src/core/events/schemas.ts"() {
-    "use strict";
-    import_zod = require("zod");
-    lifecycleEventSchema = import_zod.z.object({
-      type: import_zod.z.enum([
-        "install",
-        "cold_start",
-        "foreground",
-        "background",
-        "session_start",
-        "session_end"
-      ]),
-      session_id: import_zod.z.string().optional(),
-      duration_s: import_zod.z.number().nonnegative().optional(),
-      first_ever: import_zod.z.boolean().optional(),
-      // Contexto leve transportado em lifecycle (útil pra cold_start/install)
-      app_version: import_zod.z.string().optional(),
-      device_type: import_zod.z.enum(["ios", "android"]).optional(),
-      os_version: import_zod.z.string().optional(),
-      // Timestamps opcionais — o EventBatcher injeta `timestamp` no envelope
-      started_at: import_zod.z.string().optional(),
-      ended_at: import_zod.z.string().optional()
-    }).strict();
-    identifyEventSchema = import_zod.z.object({
-      distinct_id: import_zod.z.string().min(1),
-      email: import_zod.z.email().optional(),
-      traits: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional(),
-      attribution: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional(),
-      device: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional()
-    }).strict();
-    paywallEventSchema = import_zod.z.object({
-      type: import_zod.z.enum(["viewed", "closed", "purchased"]),
-      paywall_id: import_zod.z.string().min(1),
-      placement: import_zod.z.string().optional(),
-      variant_id: import_zod.z.string().optional(),
-      variant_key: import_zod.z.string().optional(),
-      campaign_id: import_zod.z.string().optional(),
-      // `closed`-specific
-      closed_at: import_zod.z.string().optional(),
-      duration_s: import_zod.z.number().nonnegative().optional(),
-      close_reason: import_zod.z.enum(["dismiss", "cta", "purchase", "error", "timeout"]).optional(),
-      scroll_depth: import_zod.z.number().min(0).max(1).optional(),
-      // `purchased`-specific (mínimo — transaction canônica leva detalhes)
-      product_id: import_zod.z.string().optional()
-    }).strict();
-    transactionEventSchema = import_zod.z.object({
-      type: import_zod.z.enum([
-        "completed",
-        "failed",
-        "refunded",
-        "renewed",
-        "canceled",
-        "expired"
-      ]),
-      tx_id: import_zod.z.string().min(1),
-      amount: import_zod.z.number().optional(),
-      currency: import_zod.z.string().length(3).optional(),
-      product_id: import_zod.z.string().optional(),
-      subscription_id: import_zod.z.string().optional(),
-      paywall_id: import_zod.z.string().optional(),
-      variant_id: import_zod.z.string().optional(),
-      reason: import_zod.z.string().optional()
-    }).strict();
-    onboardingEventSchema = import_zod.z.object({
-      type: import_zod.z.enum(["step", "complete", "drop"]),
-      step_index: import_zod.z.number().int().nonnegative().optional(),
-      step_name: import_zod.z.string().optional(),
-      variant_key: import_zod.z.string().optional(),
-      time_on_prev_s: import_zod.z.number().nonnegative().optional()
-    }).strict();
-    notificationEventSchema = import_zod.z.object({
-      type: import_zod.z.enum(["delivered", "displayed", "clicked", "dismissed"]),
-      notification_id: import_zod.z.string().optional(),
-      campaign_id: import_zod.z.string().optional(),
-      variant_key: import_zod.z.string().nullable().optional(),
-      message_id: import_zod.z.string().optional(),
-      device_id: import_zod.z.string().optional(),
-      push_platform: import_zod.z.enum(["ios", "android"]).optional(),
-      timezone: import_zod.z.string().optional(),
-      failure_reason: import_zod.z.string().optional(),
-      app_user_id: import_zod.z.string().optional()
-    }).strict();
-    customEventSchema = import_zod.z.object({
-      name: import_zod.z.string().min(1).regex(
-        /^(\$[a-zA-Z0-9_]+|[a-z][a-z0-9_]*)$/,
-        "custom event name must be snake_case or $reserved"
-      ),
-      props: import_zod.z.record(import_zod.z.string(), import_zod.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/eventEnvelopeV2.ts
 function buildV2Envelope(events, providerContext) {
   const context = { ...providerContext };
@@ -7072,6 +7150,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) {
@@ -7125,12 +7206,18 @@ var init_eventEnvelopeV2 = __esm({
       session_id: import_zod2.z.string().optional(),
       device_id: import_zod2.z.string().optional(),
       app_version: import_zod2.z.string().optional(),
+      app_build: import_zod2.z.string().optional(),
+      bundle_id: import_zod2.z.string().optional(),
       sdk_version: import_zod2.z.string().optional(),
       platform: import_zod2.z.string().optional(),
       os_version: import_zod2.z.string().optional(),
       device_model: import_zod2.z.string().optional(),
       timezone: import_zod2.z.string().optional(),
       locale: import_zod2.z.string().optional(),
+      carrier: import_zod2.z.string().optional(),
+      screen_width: import_zod2.z.number().optional(),
+      screen_height: import_zod2.z.number().optional(),
+      screen_density: import_zod2.z.number().optional(),
       attribution: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.unknown()).optional(),
       ids: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.unknown()).optional()
     });
@@ -7143,12 +7230,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"]
     };
@@ -7275,8 +7371,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) });
           }
         }
       }
@@ -7289,8 +7385,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") {
@@ -7305,6 +7401,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);
@@ -7887,7 +7984,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({
@@ -7971,6 +8069,36 @@ var init_PaywalloState = __esm({
   }
 });
 
+// src/utils/detectEnvironment.ts
+async function detectEnvironment() {
+  if (cached !== null) return cached;
+  if (typeof globalThis.__DEV__ !== "undefined" && globalThis.__DEV__) {
+    cached = "sandbox";
+    return cached;
+  }
+  if (!nativeModule) {
+    cached = "production";
+    return cached;
+  }
+  try {
+    const result = await nativeModule.detect();
+    cached = result === "sandbox" ? "sandbox" : "production";
+    return cached;
+  } catch {
+    cached = "production";
+    return cached;
+  }
+}
+var import_react_native24, nativeModule, cached;
+var init_detectEnvironment = __esm({
+  "src/utils/detectEnvironment.ts"() {
+    "use strict";
+    import_react_native24 = require("react-native");
+    nativeModule = import_react_native24.NativeModules.PaywalloEnv ?? null;
+    cached = null;
+  }
+});
+
 // src/core/PaywalloInitializer.ts
 async function initWithRetry(state, config) {
   while (state.initAttempts <= MAX_INIT_RETRIES) {
@@ -8050,7 +8178,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 }),
@@ -8138,15 +8272,31 @@ async function doInit(state, config) {
       timezone = opts.timeZone || void 0;
     } catch {
     }
+    let screenWidth;
+    let screenHeight;
+    let screenDensity;
+    try {
+      const screen = import_react_native25.Dimensions.get("screen");
+      screenWidth = Math.round(screen.width) || void 0;
+      screenHeight = Math.round(screen.height) || void 0;
+      screenDensity = import_react_native25.PixelRatio.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 }
     };
@@ -8196,9 +8346,11 @@ async function doInit(state, config) {
   setupAutoPreload(state, apiClient, config, distinctId);
   startBatchPreload(apiClient, config.debug);
 }
+var import_react_native25;
 var init_PaywalloInitializer = __esm({
   "src/core/PaywalloInitializer.ts"() {
     "use strict";
+    import_react_native25 = require("react-native");
     init_identity();
     init_AdvertisingIdManager();
     init_DeepLinkAttributionCapture();
@@ -8218,6 +8370,7 @@ var init_PaywalloInitializer = __esm({
     init_PaywalloState();
     init_queue();
     init_NativeStorage();
+    init_detectEnvironment();
   }
 });
 
@@ -8622,7 +8775,7 @@ __export(OfferingService_exports, {
   offeringService: () => offeringService
 });
 function resolveProductId(raw) {
-  const isIos = import_react_native24.Platform.OS === "ios";
+  const isIos = import_react_native26.Platform.OS === "ios";
   const productId = isIos ? raw.apple_product_id : raw.google_product_id;
   return productId ?? "";
 }
@@ -8641,7 +8794,7 @@ function mapProduct2(raw) {
   };
 }
 function pickPlatformProduct(products) {
-  const isIos = import_react_native24.Platform.OS === "ios";
+  const isIos = import_react_native26.Platform.OS === "ios";
   const match = products.find((p) => isIos ? p.apple_product_id : p.google_product_id);
   return match ?? products[0] ?? null;
 }
@@ -8657,11 +8810,11 @@ function mapOffering(raw) {
     product: mapProduct2(rawProduct)
   };
 }
-var import_react_native24, OFFERINGS_CACHE_KEY, DEFAULT_TTL3, OfferingService, offeringService;
+var import_react_native26, OFFERINGS_CACHE_KEY, DEFAULT_TTL3, OfferingService, offeringService;
 var init_OfferingService = __esm({
   "src/domains/offering/OfferingService.ts"() {
     "use strict";
-    import_react_native24 = require("react-native");
+    import_react_native26 = require("react-native");
     init_SecureStorage();
     OFFERINGS_CACHE_KEY = "@paywallo:offerings_cache";
     DEFAULT_TTL3 = 5 * 60 * 1e3;
@@ -8675,8 +8828,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);
@@ -9292,9 +9445,10 @@ function useSubscription() {
 
 // src/PaywalloProvider.tsx
 var import_react25 = require("react");
-var import_react_native25 = require("react-native");
+var import_react_native27 = require("react-native");
 init_PaywalloClient();
 init_SecureStorage();
+init_NativeStorage();
 init_campaign();
 init_paywall();
 init_paywall();
@@ -9326,12 +9480,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 = (0, import_react20.useRef)(false);
   (0, import_react20.useEffect)(() => {
+    if (debug) console.log("[Paywallo EVENTS] useEffect fired", { isInitialized, didRunRefCurrent: didRunRef.current });
     if (!isInitialized || didRunRef.current) return;
     const timer = setTimeout(() => {
       if (didRunRef.current) return;
@@ -9341,17 +9496,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) {
@@ -9666,9 +9827,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
     );
@@ -9738,8 +9899,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 {
@@ -9756,8 +9917,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 {
@@ -9773,6 +9934,196 @@ function useSubscriptionSync() {
   return { subscription, hasActiveSubscription, getSubscription, invalidateCache };
 }
 
+// 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_localization();
 var import_jsx_runtime3 = require("react/jsx-runtime");
@@ -9802,8 +10153,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 = (0, import_react25.useCallback)((placement) => {
@@ -9811,8 +10172,8 @@ function PaywalloProvider({ children, config }) {
     });
   }, []);
   const { showingPreloadedWebView, presentPreloadedWebView, resolvePreloadedPaywall, handlePreloadedWebViewReady: baseHandlePreloadedWebViewReady, handlePreloadedClose: baseHandlePreloadedClose, setShowingPreloadedWebView, presentedAtRef } = usePaywallPresenter(preloadedWebView, setPreloadedWebView);
-  const SCREEN_HEIGHT = (0, import_react25.useMemo)(() => import_react_native25.Dimensions.get("window").height, []);
-  const slideAnim = (0, import_react25.useRef)(new import_react_native25.Animated.Value(SCREEN_HEIGHT)).current;
+  const SCREEN_HEIGHT = (0, import_react25.useMemo)(() => import_react_native27.Dimensions.get("window").height, []);
+  const slideAnim = (0, import_react25.useRef)(new import_react_native27.Animated.Value(SCREEN_HEIGHT)).current;
   const handlePreloadedWebViewReady = (0, import_react25.useCallback)(() => {
     if (PaywalloClient.getConfig()?.debug) {
       console.log(`[Paywallo WEBVIEW] loaded \u2014 placement: ${preloadedWebView?.placement}`);
@@ -9821,7 +10182,7 @@ function PaywalloProvider({ children, config }) {
   }, [preloadedWebView?.placement, baseHandlePreloadedWebViewReady]);
   const handlePreloadedClose = (0, import_react25.useCallback)(() => {
     const placement = preloadedWebView?.placement;
-    import_react_native25.Animated.timing(slideAnim, { toValue: SCREEN_HEIGHT, duration: 200, easing: import_react_native25.Easing.in(import_react_native25.Easing.cubic), useNativeDriver: true }).start(() => {
+    import_react_native27.Animated.timing(slideAnim, { toValue: SCREEN_HEIGHT, duration: 200, easing: import_react_native27.Easing.in(import_react_native27.Easing.cubic), useNativeDriver: true }).start(() => {
       baseHandlePreloadedClose();
       if (placement) triggerRepreload(placement);
     });
@@ -9850,6 +10211,7 @@ function PaywalloProvider({ children, config }) {
     PaywalloClient.init(configRef.current).then(async () => {
       if (!mounted) return;
       setDistinctId(PaywalloClient.getDistinctId());
+      startSuperwallAutoBridge(configRef.current.debug);
       setIsInitialized(true);
       if (!autoPreloadTriggeredRef.current) {
         autoPreloadTriggeredRef.current = true;
@@ -10070,7 +10432,7 @@ function PaywalloProvider({ children, config }) {
   (0, import_react25.useLayoutEffect)(() => {
     if (showingPreloadedWebView) {
       slideAnim.setValue(SCREEN_HEIGHT);
-      import_react_native25.Animated.timing(slideAnim, { toValue: 0, duration: 200, easing: import_react_native25.Easing.out(import_react_native25.Easing.cubic), useNativeDriver: true }).start();
+      import_react_native27.Animated.timing(slideAnim, { toValue: 0, duration: 200, easing: import_react_native27.Easing.out(import_react_native27.Easing.cubic), useNativeDriver: true }).start();
     }
   }, [showingPreloadedWebView, slideAnim, SCREEN_HEIGHT]);
   const preloadStyle = [
@@ -10080,7 +10442,7 @@ function PaywalloProvider({ children, config }) {
   ];
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(PaywalloContext.Provider, { value: contextValue, children: [
     children,
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(PaywallErrorBoundary, { children: !!preloadedWebView?.craftData && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native25.Animated.View, { style: preloadStyle, pointerEvents: showingPreloadedWebView ? "auto" : "none", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(PaywallErrorBoundary, { children: !!preloadedWebView?.craftData && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react_native27.Animated.View, { style: preloadStyle, pointerEvents: showingPreloadedWebView ? "auto" : "none", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
       PaywallWebView,
       {
         paywallId: preloadedWebView.paywallId,
@@ -10111,7 +10473,7 @@ function PaywalloProvider({ children, config }) {
     ) })
   ] });
 }
-var styles3 = import_react_native25.StyleSheet.create({
+var styles3 = import_react_native27.StyleSheet.create({
   preloadOverlay: { position: "absolute", top: 0, left: 0, right: 0, bottom: 0, backgroundColor: "#ffffff" },
   hidden: { zIndex: -1, opacity: 0, width: 1, height: 1, overflow: "hidden" },
   visible: { zIndex: 9999, opacity: 1 }