@entitlehub/react-native 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.1.5 — 2026-07-21
+
+### Fixed
+- **`purchaseProduct()` could hang forever after a successful purchase.** It waited only on
+  `purchaseUpdatedListener`; on the react-native-iap 15+ / Nitro bridge that callback never fires,
+  so the promise never settled — the paywall stayed open and features stayed locked even though the
+  user had been charged and EntitleHub had already granted the entitlement server-side.
+  `requestPurchase`'s resolved value was being discarded entirely; it is now honoured, so bridges
+  that resolve instead of emitting an event work.
+
+### Added
+- Reconciliation safety net: if no result arrives within `timeoutMs` (default 120s),
+  `purchaseProduct()` re-reads `getAvailablePurchases()` and, failing that, re-checks entitlements
+  from the server — resolving successfully if the entitlement appeared while the client was waiting.
+  Only rejects (`"purchase-timeout"`) when nothing was actually granted.
+- `purchaseProduct(id, { timeoutMs })` to tune that window.
+
 ## 0.1.2 — 2026-07-18
 
 ### Added

package/dist/index.cjs

@@ -70,10 +70,17 @@ async function getOfferings() {
 async function getProducts(productIds, type = "all") {
   return iap().fetchProducts({ skus: productIds, type });
 }
+var DEFAULT_PURCHASE_TIMEOUT_MS = 12e4;
 async function purchaseProduct(productId, opts = {}) {
   const I = iap();
   const isSub = Boolean(opts.isSubscription);
   const isConsumable = Boolean(opts.isConsumable) && !isSub;
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_PURCHASE_TIMEOUT_MS;
+  let entitlementsBefore = [];
+  try {
+    entitlementsBefore = (await eh().getCustomerInfo()).activeEntitlementIds;
+  } catch {
+  }
   const request = { apple: { sku: productId }, google: { skus: [productId] } };
   if (isSub) {
     try {
@@ -88,6 +95,7 @@ async function purchaseProduct(productId, opts = {}) {
   }
   return new Promise((resolve, reject) => {
     let settled = false;
+    let timer;
     const cleanup = () => {
       try {
         updSub?.remove();
@@ -97,8 +105,15 @@ async function purchaseProduct(productId, opts = {}) {
         errSub?.remove();
       } catch {
       }
+      if (timer) clearTimeout(timer);
     };
-    const updSub = I.purchaseUpdatedListener(async (purchase) => {
+    const fail = (e) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      reject(e);
+    };
+    const settleWithPurchase = async (purchase) => {
       if (settled) return;
       settled = true;
       cleanup();
@@ -112,23 +127,47 @@ async function purchaseProduct(productId, opts = {}) {
       } catch (e) {
         reject(e);
       }
+    };
+    const isPurchase = (p) => Boolean(p) && Boolean(p.purchaseToken || p.jwsRepresentation || p.jwsRepresentationIos || p.purchaseTokenAndroid || p.transactionId || p.transactionReceipt || p.id);
+    const reconcile = async () => {
+      if (settled) return;
+      try {
+        const owned = await I.getAvailablePurchases() || [];
+        const match = owned.find((p) => (p?.productId ?? p?.id ?? p?.sku) === productId);
+        if (match) return settleWithPurchase(match);
+      } catch {
+      }
+      try {
+        const info = await eh().getCustomerInfo({ fetchPolicy: "network-only" });
+        const grew = info.activeEntitlementIds.some((id) => !entitlementsBefore.includes(id));
+        if (grew) {
+          if (settled) return;
+          settled = true;
+          cleanup();
+          resolve(info);
+          return;
+        }
+      } catch {
+      }
+      fail(new Error("purchase-timeout"));
+    };
+    const updSub = I.purchaseUpdatedListener((purchase) => {
+      void settleWithPurchase(purchase);
     });
     const errSub = I.purchaseErrorListener((error) => {
-      if (settled) return;
-      settled = true;
-      cleanup();
       const code = error?.code;
       const cancelled = code === "E_USER_CANCELLED" || code === "user-cancelled" || /cancel/i.test(String(error?.message));
-      reject(new Error(cancelled ? "purchase-cancelled" : error?.message || "purchase-failed"));
+      fail(new Error(cancelled ? "purchase-cancelled" : error?.message || "purchase-failed"));
     });
     Promise.resolve(
       I.requestPurchase({ request, type: isSub ? "subs" : "in-app" })
-    ).catch((e) => {
-      if (settled) return;
-      settled = true;
-      cleanup();
-      reject(e);
-    });
+    ).then((res) => {
+      const p = Array.isArray(res) ? res.find(isPurchase) : res;
+      if (isPurchase(p)) void settleWithPurchase(p);
+    }).catch((e) => fail(e));
+    timer = setTimeout(() => {
+      void reconcile();
+    }, timeoutMs);
   });
 }
 async function restorePurchases() {

package/dist/index.d.cts

@@ -35,13 +35,22 @@ declare function getProducts(productIds: string[], type?: "in-app" | "subs" | "a
  * Buy a product in one call: open the native purchase sheet, validate the receipt with EntitleHub,
  * and return the updated entitlements. Purchase + entitlement sync, the RevenueCat way.
  *
- * expo-iap's purchase flow is event-based — the result arrives on `purchaseUpdatedListener`, not the
- * `requestPurchase` return value — so we bridge that back into a promise here.
- * Rejects with "purchase-cancelled" if the user backs out.
+ * Store bridges disagree about how the result comes back, so we accept it from any source and never
+ * hang waiting for one of them:
+ *  1. `purchaseUpdatedListener` — expo-iap's event-based flow.
+ *  2. `requestPurchase`'s resolved value — react-native-iap 15+ / Nitro resolves with the purchase
+ *     and may never emit the event.
+ *  3. Reconciliation after `timeoutMs` — re-read `getAvailablePurchases()`, and failing that check
+ *     whether the entitlement appeared server-side anyway (EntitleHub's store-notification webhook
+ *     grants it independently of the client).
+ *
+ * Rejects with "purchase-cancelled" if the user backs out, "purchase-timeout" if nothing arrived
+ * and nothing was granted.
  */
 declare function purchaseProduct(productId: string, opts?: {
     isSubscription?: boolean;
     isConsumable?: boolean;
+    timeoutMs?: number;
 }): Promise<CustomerInfo>;
 /** Restore the user's purchases: re-validate each with EntitleHub, then return entitlements. */
 declare function restorePurchases(): Promise<CustomerInfo>;

package/dist/index.d.ts

@@ -35,13 +35,22 @@ declare function getProducts(productIds: string[], type?: "in-app" | "subs" | "a
  * Buy a product in one call: open the native purchase sheet, validate the receipt with EntitleHub,
  * and return the updated entitlements. Purchase + entitlement sync, the RevenueCat way.
  *
- * expo-iap's purchase flow is event-based — the result arrives on `purchaseUpdatedListener`, not the
- * `requestPurchase` return value — so we bridge that back into a promise here.
- * Rejects with "purchase-cancelled" if the user backs out.
+ * Store bridges disagree about how the result comes back, so we accept it from any source and never
+ * hang waiting for one of them:
+ *  1. `purchaseUpdatedListener` — expo-iap's event-based flow.
+ *  2. `requestPurchase`'s resolved value — react-native-iap 15+ / Nitro resolves with the purchase
+ *     and may never emit the event.
+ *  3. Reconciliation after `timeoutMs` — re-read `getAvailablePurchases()`, and failing that check
+ *     whether the entitlement appeared server-side anyway (EntitleHub's store-notification webhook
+ *     grants it independently of the client).
+ *
+ * Rejects with "purchase-cancelled" if the user backs out, "purchase-timeout" if nothing arrived
+ * and nothing was granted.
  */
 declare function purchaseProduct(productId: string, opts?: {
     isSubscription?: boolean;
     isConsumable?: boolean;
+    timeoutMs?: number;
 }): Promise<CustomerInfo>;
 /** Restore the user's purchases: re-validate each with EntitleHub, then return entitlements. */
 declare function restorePurchases(): Promise<CustomerInfo>;

package/dist/index.js

@@ -45,10 +45,17 @@ async function getOfferings() {
 async function getProducts(productIds, type = "all") {
   return iap().fetchProducts({ skus: productIds, type });
 }
+var DEFAULT_PURCHASE_TIMEOUT_MS = 12e4;
 async function purchaseProduct(productId, opts = {}) {
   const I = iap();
   const isSub = Boolean(opts.isSubscription);
   const isConsumable = Boolean(opts.isConsumable) && !isSub;
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_PURCHASE_TIMEOUT_MS;
+  let entitlementsBefore = [];
+  try {
+    entitlementsBefore = (await eh().getCustomerInfo()).activeEntitlementIds;
+  } catch {
+  }
   const request = { apple: { sku: productId }, google: { skus: [productId] } };
   if (isSub) {
     try {
@@ -63,6 +70,7 @@ async function purchaseProduct(productId, opts = {}) {
   }
   return new Promise((resolve, reject) => {
     let settled = false;
+    let timer;
     const cleanup = () => {
       try {
         updSub?.remove();
@@ -72,8 +80,15 @@ async function purchaseProduct(productId, opts = {}) {
         errSub?.remove();
       } catch {
       }
+      if (timer) clearTimeout(timer);
     };
-    const updSub = I.purchaseUpdatedListener(async (purchase) => {
+    const fail = (e) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      reject(e);
+    };
+    const settleWithPurchase = async (purchase) => {
       if (settled) return;
       settled = true;
       cleanup();
@@ -87,23 +102,47 @@ async function purchaseProduct(productId, opts = {}) {
       } catch (e) {
         reject(e);
       }
+    };
+    const isPurchase = (p) => Boolean(p) && Boolean(p.purchaseToken || p.jwsRepresentation || p.jwsRepresentationIos || p.purchaseTokenAndroid || p.transactionId || p.transactionReceipt || p.id);
+    const reconcile = async () => {
+      if (settled) return;
+      try {
+        const owned = await I.getAvailablePurchases() || [];
+        const match = owned.find((p) => (p?.productId ?? p?.id ?? p?.sku) === productId);
+        if (match) return settleWithPurchase(match);
+      } catch {
+      }
+      try {
+        const info = await eh().getCustomerInfo({ fetchPolicy: "network-only" });
+        const grew = info.activeEntitlementIds.some((id) => !entitlementsBefore.includes(id));
+        if (grew) {
+          if (settled) return;
+          settled = true;
+          cleanup();
+          resolve(info);
+          return;
+        }
+      } catch {
+      }
+      fail(new Error("purchase-timeout"));
+    };
+    const updSub = I.purchaseUpdatedListener((purchase) => {
+      void settleWithPurchase(purchase);
     });
     const errSub = I.purchaseErrorListener((error) => {
-      if (settled) return;
-      settled = true;
-      cleanup();
       const code = error?.code;
       const cancelled = code === "E_USER_CANCELLED" || code === "user-cancelled" || /cancel/i.test(String(error?.message));
-      reject(new Error(cancelled ? "purchase-cancelled" : error?.message || "purchase-failed"));
+      fail(new Error(cancelled ? "purchase-cancelled" : error?.message || "purchase-failed"));
     });
     Promise.resolve(
       I.requestPurchase({ request, type: isSub ? "subs" : "in-app" })
-    ).catch((e) => {
-      if (settled) return;
-      settled = true;
-      cleanup();
-      reject(e);
-    });
+    ).then((res) => {
+      const p = Array.isArray(res) ? res.find(isPurchase) : res;
+      if (isPurchase(p)) void settleWithPurchase(p);
+    }).catch((e) => fail(e));
+    timer = setTimeout(() => {
+      void reconcile();
+    }, timeoutMs);
   });
 }
 async function restorePurchases() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@entitlehub/react-native",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "EntitleHub for React Native & Expo — one call to purchase and unlock entitlements. Wraps expo-iap for the native store sheet and validates receipts via EntitleHub.",
   "keywords": [
     "entitlehub",