@entitlehub/react-native 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 0.1.9 (2026-09-20)
+
+### Fixed
+- **`restorePurchases()` swallowed every per-purchase failure.** Each purchase was reported with
+  `.catch(() => {})`, so a `409 receipt_revoked` (the signal that a purchase was REFUNDED) died
+  inside the SDK and no amount of catching in the app could see it. A restore is the main place a
+  refund surfaces, so this was the path that mattered most. Failures now reach an optional
+  `onReportError`, and `console.warn` otherwise.
+
+### Read this before upgrading
+- **If you were catching around `restorePurchases()` to detect a refund, that never worked and
+  still will not.** The loop deliberately continues past a bad receipt so one stale purchase can't
+  cost someone the rest of theirs, which means `restorePurchases()` **resolves** rather than
+  rejecting. Pass `onReportError` - it is the only way to see these:
+
+  ```ts
+  import { restorePurchases, isReceiptRevoked } from "@entitlehub/react-native";
+
+  const info = await restorePurchases({
+    onReportError: (err) => { if (isReceiptRevoked(err)) showRefundNotice(); },
+  });
+  ```
+
+  Passing the options object to **0.1.7/0.1.8 is harmless** (JS drops the extra argument), so it is
+  safe to add before you upgrade.
+- `isReceiptRevoked` is re-exported here, so you don't need to import `@entitlehub/sdk` for it.
+  It is a **0.3.1** symbol, so the peer range moves to `>=0.3.1`. On an older core SDK the
+  re-export resolves to `undefined` rather than failing loudly, which is the whole reason the
+  range had to move: `>=0.2.0` would have permitted a version that cannot satisfy it.
+
 ## 0.1.8 (2026-09-19)
 
 ### Fixed

package/dist/index.cjs

@@ -37,12 +37,14 @@ __export(index_exports, {
   getOfferings: () => getOfferings,
   getProducts: () => getProducts,
   isEntitled: () => isEntitled,
+  isReceiptRevoked: () => import_sdk2.isReceiptRevoked,
   logIn: () => logIn,
   purchaseProduct: () => purchaseProduct,
   restorePurchases: () => restorePurchases
 });
 module.exports = __toCommonJS(index_exports);
 var import_sdk = require("@entitlehub/sdk");
+var import_sdk2 = require("@entitlehub/sdk");
 var _iap;
 async function loadIap() {
   if (_iap) return _iap;
@@ -232,12 +234,16 @@ async function purchaseProduct(productId, opts = {}) {
     armTimer(sheetTimeoutMs);
   });
 }
-async function restorePurchases() {
+async function restorePurchases(options = {}) {
   const I = iap();
   const purchases = await I.getAvailablePurchases() || [];
   for (const p of purchases) {
-    await reportToEntitleHub(p, p.productId ?? p.id ?? p.sku, true).catch(() => {
-    });
+    try {
+      await reportToEntitleHub(p, p.productId ?? p.id ?? p.sku, true);
+    } catch (err) {
+      if (options.onReportError) options.onReportError(err, p);
+      else console.warn("[entitlehub] restore: could not report", p?.productId ?? p?.id ?? p?.sku, err);
+    }
   }
   return eh().getCustomerInfo({ fetchPolicy: "network-only" });
 }
@@ -267,6 +273,7 @@ async function reportToEntitleHub(purchase, productId, isSubscription) {
   getOfferings,
   getProducts,
   isEntitled,
+  isReceiptRevoked,
   logIn,
   purchaseProduct,
   restorePurchases

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { CustomerInfo, Offerings } from '@entitlehub/sdk';
-export { CustomerInfo, Offerings } from '@entitlehub/sdk';
+export { CustomerInfo, Offerings, isReceiptRevoked } from '@entitlehub/sdk';
 
 interface ConfigureOptions {
     /** Your EntitleHub publishable key (pk_live_… / pk_test_…). Client-safe. */
@@ -76,9 +76,22 @@ declare function purchaseProduct(productId: string, opts?: {
     /** How long to poll for confirmation before reporting pending (default 30s). */
     reconcileMs?: number;
 }): Promise<CustomerInfo>;
-/** Restore the user's purchases: re-validate each with EntitleHub, then return entitlements. */
-declare function restorePurchases(): Promise<CustomerInfo>;
+
+interface RestoreOptions {
+    /**
+     * Called for each purchase that could not be reported. The restore continues either way, so one
+     * stale receipt can't cost the user the rest of their purchases.
+     *
+     * Worth handling: a restore is where a REFUND surfaces. Apple stamps a refunded transaction with
+     * revocationDate permanently and StoreKit keeps handing it back, so reporting it answers
+     * 409 `receipt_revoked` (EntitleHub revokes the grant server-side at the same time). That 409 is
+     * the only signal telling you the entitlement went away because the money was returned, rather
+     * than for some unexplained reason.
+     */
+    onReportError?: (error: unknown, purchase: unknown) => void;
+}
+declare function restorePurchases(options?: RestoreOptions): Promise<CustomerInfo>;
 /** Subscribe to entitlement changes (e.g. after a purchase). Returns an unsubscribe function. */
 declare function addCustomerInfoUpdateListener(fn: (info: CustomerInfo) => void): () => void;
 
-export { type ConfigureOptions, PurchaseError, type PurchaseErrorCode, addCustomerInfoUpdateListener, configureEntitleHub, getCustomerInfo, getOfferings, getProducts, isEntitled, logIn, purchaseProduct, restorePurchases };
+export { type ConfigureOptions, PurchaseError, type PurchaseErrorCode, type RestoreOptions, addCustomerInfoUpdateListener, configureEntitleHub, getCustomerInfo, getOfferings, getProducts, isEntitled, logIn, purchaseProduct, restorePurchases };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { CustomerInfo, Offerings } from '@entitlehub/sdk';
-export { CustomerInfo, Offerings } from '@entitlehub/sdk';
+export { CustomerInfo, Offerings, isReceiptRevoked } from '@entitlehub/sdk';
 
 interface ConfigureOptions {
     /** Your EntitleHub publishable key (pk_live_… / pk_test_…). Client-safe. */
@@ -76,9 +76,22 @@ declare function purchaseProduct(productId: string, opts?: {
     /** How long to poll for confirmation before reporting pending (default 30s). */
     reconcileMs?: number;
 }): Promise<CustomerInfo>;
-/** Restore the user's purchases: re-validate each with EntitleHub, then return entitlements. */
-declare function restorePurchases(): Promise<CustomerInfo>;
+
+interface RestoreOptions {
+    /**
+     * Called for each purchase that could not be reported. The restore continues either way, so one
+     * stale receipt can't cost the user the rest of their purchases.
+     *
+     * Worth handling: a restore is where a REFUND surfaces. Apple stamps a refunded transaction with
+     * revocationDate permanently and StoreKit keeps handing it back, so reporting it answers
+     * 409 `receipt_revoked` (EntitleHub revokes the grant server-side at the same time). That 409 is
+     * the only signal telling you the entitlement went away because the money was returned, rather
+     * than for some unexplained reason.
+     */
+    onReportError?: (error: unknown, purchase: unknown) => void;
+}
+declare function restorePurchases(options?: RestoreOptions): Promise<CustomerInfo>;
 /** Subscribe to entitlement changes (e.g. after a purchase). Returns an unsubscribe function. */
 declare function addCustomerInfoUpdateListener(fn: (info: CustomerInfo) => void): () => void;
 
-export { type ConfigureOptions, PurchaseError, type PurchaseErrorCode, addCustomerInfoUpdateListener, configureEntitleHub, getCustomerInfo, getOfferings, getProducts, isEntitled, logIn, purchaseProduct, restorePurchases };
+export { type ConfigureOptions, PurchaseError, type PurchaseErrorCode, type RestoreOptions, addCustomerInfoUpdateListener, configureEntitleHub, getCustomerInfo, getOfferings, getProducts, isEntitled, logIn, purchaseProduct, restorePurchases };

package/dist/index.js

@@ -1,5 +1,6 @@
 // src/index.ts
 import { EntitleHub } from "@entitlehub/sdk";
+import { isReceiptRevoked } from "@entitlehub/sdk";
 var _iap;
 async function loadIap() {
   if (_iap) return _iap;
@@ -189,12 +190,16 @@ async function purchaseProduct(productId, opts = {}) {
     armTimer(sheetTimeoutMs);
   });
 }
-async function restorePurchases() {
+async function restorePurchases(options = {}) {
   const I = iap();
   const purchases = await I.getAvailablePurchases() || [];
   for (const p of purchases) {
-    await reportToEntitleHub(p, p.productId ?? p.id ?? p.sku, true).catch(() => {
-    });
+    try {
+      await reportToEntitleHub(p, p.productId ?? p.id ?? p.sku, true);
+    } catch (err) {
+      if (options.onReportError) options.onReportError(err, p);
+      else console.warn("[entitlehub] restore: could not report", p?.productId ?? p?.id ?? p?.sku, err);
+    }
   }
   return eh().getCustomerInfo({ fetchPolicy: "network-only" });
 }
@@ -223,6 +228,7 @@ export {
   getOfferings,
   getProducts,
   isEntitled,
+  isReceiptRevoked,
   logIn,
   purchaseProduct,
   restorePurchases

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@entitlehub/react-native",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "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",
@@ -47,13 +47,14 @@
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",
     "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test \"test/*.test.mjs\"",
     "prepublishOnly": "npm run build"
   },
   "engines": {
     "node": ">=18"
   },
   "peerDependencies": {
-    "@entitlehub/sdk": ">=0.2.0",
+    "@entitlehub/sdk": ">=0.3.1",
     "expo-iap": "*",
     "react": ">=17"
   },