@entitlehub/react-native 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.1.6 — 2026-07-21
+
+### Added
+- Reports `react-native/<version>` to EntitleHub on each call, so the dashboard can tell you when
+  your SDK is behind a release with fixes in it — rather than you finding out by hitting the bug.
+  Version only; no device or user data.
+
+## 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

@@ -42,6 +42,7 @@ function iap() {
   }
   return _iap;
 }
+var RN_SDK_VERSION = "0.1.6";
 var client;
 function eh() {
   if (!client) throw new Error("Call configureEntitleHub({ apiKey, appUserId }) before using EntitleHub.");
@@ -49,7 +50,12 @@ function eh() {
 }
 async function configureEntitleHub(opts) {
   if (opts.iap) _iap = opts.iap;
-  client = new import_sdk.EntitleHub({ apiKey: opts.apiKey, appUserId: opts.appUserId, baseUrl: opts.baseUrl });
+  client = new import_sdk.EntitleHub({
+    apiKey: opts.apiKey,
+    appUserId: opts.appUserId,
+    baseUrl: opts.baseUrl,
+    client: `react-native/${RN_SDK_VERSION}`
+  });
   try {
     await iap().initConnection();
   } catch {
@@ -70,10 +76,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 +101,7 @@ async function purchaseProduct(productId, opts = {}) {
   }
   return new Promise((resolve, reject) => {
     let settled = false;
+    let timer;
     const cleanup = () => {
       try {
         updSub?.remove();
@@ -97,8 +111,15 @@ async function purchaseProduct(productId, opts = {}) {
         errSub?.remove();
       } catch {
       }
+      if (timer) clearTimeout(timer);
+    };
+    const fail = (e) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      reject(e);
     };
-    const updSub = I.purchaseUpdatedListener(async (purchase) => {
+    const settleWithPurchase = async (purchase) => {
       if (settled) return;
       settled = true;
       cleanup();
@@ -112,23 +133,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

@@ -17,6 +17,7 @@ function iap() {
   }
   return _iap;
 }
+var RN_SDK_VERSION = "0.1.6";
 var client;
 function eh() {
   if (!client) throw new Error("Call configureEntitleHub({ apiKey, appUserId }) before using EntitleHub.");
@@ -24,7 +25,12 @@ function eh() {
 }
 async function configureEntitleHub(opts) {
   if (opts.iap) _iap = opts.iap;
-  client = new EntitleHub({ apiKey: opts.apiKey, appUserId: opts.appUserId, baseUrl: opts.baseUrl });
+  client = new EntitleHub({
+    apiKey: opts.apiKey,
+    appUserId: opts.appUserId,
+    baseUrl: opts.baseUrl,
+    client: `react-native/${RN_SDK_VERSION}`
+  });
   try {
     await iap().initConnection();
   } catch {
@@ -45,10 +51,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 +76,7 @@ async function purchaseProduct(productId, opts = {}) {
   }
   return new Promise((resolve, reject) => {
     let settled = false;
+    let timer;
     const cleanup = () => {
       try {
         updSub?.remove();
@@ -72,8 +86,15 @@ async function purchaseProduct(productId, opts = {}) {
         errSub?.remove();
       } catch {
       }
+      if (timer) clearTimeout(timer);
+    };
+    const fail = (e) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      reject(e);
     };
-    const updSub = I.purchaseUpdatedListener(async (purchase) => {
+    const settleWithPurchase = async (purchase) => {
       if (settled) return;
       settled = true;
       cleanup();
@@ -87,23 +108,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.6",
   "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",