@virex-tech/paywallo-sdk 2.5.2 → 2.5.3

package/dist/index.js

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