@entitlehub/react-native 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.1.2 — 2026-07-18
+
+### Added
+- `configureEntitleHub({ iap })` — inject the OpenIAP-compatible store module (pinned expo-iap
+  version, or react-native-iap) instead of the hard-coded `expo-iap`. Decouples this SDK from a
+  single store-library version so you can work around a native issue without changing the SDK.
+
+### Docs
+- Note that native store-library crashes (e.g. `EXC_BAD_ACCESS` in expo-iap/OpenIAP off the JS
+  thread) are a store-library-version concern; how to pin a version, inject a module, or fall back
+  to the fully-decoupled `@entitlehub/sdk` + your own billing library.
+
+## 0.1.1 — 2026-07-18
+
+### Fixed
+- **`purchaseProduct` crashed** — 0.1.0 was written against expo-iap's old flat `requestPurchase`
+  API and read the purchase from the return value. `expo-iap@4.x` is **event-based** with a
+  discriminated request. Now: `requestPurchase({ request: { apple: { sku }, google: { skus } },
+  type })` with the result bridged from `purchaseUpdatedListener` / `purchaseErrorListener`.
+- Android subscriptions now pass the required `offerToken` (fetched from the product).
+- `getProducts` uses expo-iap's `fetchProducts` (the old `getProducts` no longer exists).
+
 ## 0.1.0 — 2026-07-18
 
 Initial release.

package/README.md

@@ -57,6 +57,28 @@ customer info. Renewals/refunds stay current via
 
 Full guide: **[entitlehub.com/docs/purchases](https://entitlehub.com/docs/purchases)**.
 
+## Choosing / pinning the store library
+
+The on-device purchase runs through **expo-iap** (OpenIAP). That native layer is the store
+library's responsibility, not EntitleHub's — and a given version can have platform-specific native
+bugs. If you hit a **native IAP crash** (e.g. an `EXC_BAD_ACCESS` in the store module), it's the
+store library, not this SDK or your app code, and no JS change can catch a native exception thrown
+off the JS thread.
+
+Two levers, both without changing this SDK:
+
+- **Pin a working version:** `npm install expo-iap@<version>` — this package uses whatever `expo-iap`
+  is installed (peer dependency).
+- **Supply your own module:** pass any OpenIAP-compatible library to `configureEntitleHub`:
+  ```ts
+  await configureEntitleHub({ apiKey, appUserId, iap: require("expo-iap") }); // or react-native-iap
+  ```
+
+Fully decoupled fallback: skip this package and use **[`@entitlehub/sdk`](https://www.npmjs.com/package/@entitlehub/sdk)**
+directly — open the purchase with *any* billing library you've verified on your target OS, then call
+`eh.reportPurchase({ signedTransaction | purchaseToken })`. See
+[Purchases → manual](https://entitlehub.com/docs/purchases).
+
 > Requires a development build (Expo Go has no in-app-purchase native module). The entitlement layer
 > is [`@entitlehub/sdk`](https://www.npmjs.com/package/@entitlehub/sdk); this package adds the
 > purchase flow on top.

package/dist/index.cjs

@@ -48,6 +48,7 @@ function eh() {
   return client;
 }
 async function configureEntitleHub(opts) {
+  if (opts.iap) _iap = opts.iap;
   client = new import_sdk.EntitleHub({ apiKey: opts.apiKey, appUserId: opts.appUserId, baseUrl: opts.baseUrl });
   try {
     await iap().initConnection();
@@ -66,20 +67,68 @@ async function isEntitled(entitlementId) {
 async function getOfferings() {
   return eh().getOfferings();
 }
-async function getProducts(productIds) {
-  return iap().getProducts(productIds);
+async function getProducts(productIds, type = "all") {
+  return iap().fetchProducts({ skus: productIds, type });
 }
 async function purchaseProduct(productId, opts = {}) {
   const I = iap();
-  const result = await I.requestPurchase({ sku: productId, skus: [productId] });
-  const purchase = Array.isArray(result) ? result[0] : result;
-  if (!purchase) throw new Error("purchase-cancelled");
-  const info = await reportToEntitleHub(purchase, productId, opts.isSubscription);
-  try {
-    await I.finishTransaction({ purchase, isConsumable: false });
-  } catch {
+  const isSub = Boolean(opts.isSubscription);
+  const request = { apple: { sku: productId }, google: { skus: [productId] } };
+  if (isSub) {
+    try {
+      const products = await I.fetchProducts({ skus: [productId], type: "subs" });
+      const product = Array.isArray(products) ? products.find((p) => (p?.id ?? p?.productId) === productId) : void 0;
+      const offer = product?.subscriptionOfferDetailsAndroid?.[0] ?? product?.subscriptionOfferDetails?.[0];
+      if (offer?.offerToken) {
+        request.google = { skus: [productId], subscriptionOffers: [{ sku: productId, offerToken: offer.offerToken }] };
+      }
+    } catch {
+    }
   }
-  return info;
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    const cleanup = () => {
+      try {
+        updSub?.remove();
+      } catch {
+      }
+      try {
+        errSub?.remove();
+      } catch {
+      }
+    };
+    const updSub = I.purchaseUpdatedListener(async (purchase) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      try {
+        const info = await reportToEntitleHub(purchase, productId, isSub);
+        try {
+          await I.finishTransaction({ purchase, isConsumable: false });
+        } catch {
+        }
+        resolve(info);
+      } catch (e) {
+        reject(e);
+      }
+    });
+    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"));
+    });
+    Promise.resolve(
+      I.requestPurchase({ request, type: isSub ? "subs" : "in-app" })
+    ).catch((e) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      reject(e);
+    });
+  });
 }
 async function restorePurchases() {
   const I = iap();
@@ -94,7 +143,7 @@ function addCustomerInfoUpdateListener(fn) {
   return eh().addCustomerInfoUpdateListener(fn);
 }
 async function reportToEntitleHub(purchase, productId, isSubscription) {
-  const jws = purchase?.jwsRepresentationIos ?? purchase?.jwsRepresentation ?? purchase?.verificationResultIos;
+  const jws = purchase?.jwsRepresentation ?? purchase?.jwsRepresentationIos;
   if (jws) return eh().reportPurchase({ signedTransaction: jws });
   const token = purchase?.purchaseTokenAndroid ?? purchase?.purchaseToken;
   if (token) {

package/dist/index.d.cts

@@ -8,6 +8,16 @@ interface ConfigureOptions {
     appUserId: string;
     /** Override the API base (self-host). */
     baseUrl?: string;
+    /**
+     * The in-app-purchase module to use. Must implement the OpenIAP API (`initConnection`,
+     * `fetchProducts`, `requestPurchase`, `purchaseUpdatedListener`, `purchaseErrorListener`,
+     * `finishTransaction`, `getAvailablePurchases`). Defaults to `expo-iap`.
+     *
+     * Pass your own if you need a specific version or a different OpenIAP-compatible library, e.g.
+     * `iap: require("expo-iap")` with a pinned version, or `react-native-iap`. Useful to work around
+     * a native issue in a particular store-library version without changing this SDK.
+     */
+    iap?: unknown;
 }
 /** Configure EntitleHub and open the store connection. Call once at startup (after your own login). */
 declare function configureEntitleHub(opts: ConfigureOptions): Promise<void>;
@@ -19,12 +29,15 @@ declare function getCustomerInfo(): Promise<CustomerInfo>;
 declare function isEntitled(entitlementId: string): Promise<boolean>;
 /** Your EntitleHub catalog (entitlements + products) for building a paywall. */
 declare function getOfferings(): Promise<Offerings>;
-/** Live store products (prices, localized titles) for the given ids, from the native store. */
-declare function getProducts(productIds: string[]): Promise<any[]>;
+/** Live store products (prices, localized titles) from the native store (expo-iap `fetchProducts`). */
+declare function getProducts(productIds: string[], type?: "in-app" | "subs" | "all"): Promise<any[]>;
 /**
  * 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.
- * Throws "purchase-cancelled" if the user backs out.
+ *
+ * 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.
  */
 declare function purchaseProduct(productId: string, opts?: {
     isSubscription?: boolean;

package/dist/index.d.ts

@@ -8,6 +8,16 @@ interface ConfigureOptions {
     appUserId: string;
     /** Override the API base (self-host). */
     baseUrl?: string;
+    /**
+     * The in-app-purchase module to use. Must implement the OpenIAP API (`initConnection`,
+     * `fetchProducts`, `requestPurchase`, `purchaseUpdatedListener`, `purchaseErrorListener`,
+     * `finishTransaction`, `getAvailablePurchases`). Defaults to `expo-iap`.
+     *
+     * Pass your own if you need a specific version or a different OpenIAP-compatible library, e.g.
+     * `iap: require("expo-iap")` with a pinned version, or `react-native-iap`. Useful to work around
+     * a native issue in a particular store-library version without changing this SDK.
+     */
+    iap?: unknown;
 }
 /** Configure EntitleHub and open the store connection. Call once at startup (after your own login). */
 declare function configureEntitleHub(opts: ConfigureOptions): Promise<void>;
@@ -19,12 +29,15 @@ declare function getCustomerInfo(): Promise<CustomerInfo>;
 declare function isEntitled(entitlementId: string): Promise<boolean>;
 /** Your EntitleHub catalog (entitlements + products) for building a paywall. */
 declare function getOfferings(): Promise<Offerings>;
-/** Live store products (prices, localized titles) for the given ids, from the native store. */
-declare function getProducts(productIds: string[]): Promise<any[]>;
+/** Live store products (prices, localized titles) from the native store (expo-iap `fetchProducts`). */
+declare function getProducts(productIds: string[], type?: "in-app" | "subs" | "all"): Promise<any[]>;
 /**
  * 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.
- * Throws "purchase-cancelled" if the user backs out.
+ *
+ * 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.
  */
 declare function purchaseProduct(productId: string, opts?: {
     isSubscription?: boolean;

package/dist/index.js

@@ -23,6 +23,7 @@ function eh() {
   return client;
 }
 async function configureEntitleHub(opts) {
+  if (opts.iap) _iap = opts.iap;
   client = new EntitleHub({ apiKey: opts.apiKey, appUserId: opts.appUserId, baseUrl: opts.baseUrl });
   try {
     await iap().initConnection();
@@ -41,20 +42,68 @@ async function isEntitled(entitlementId) {
 async function getOfferings() {
   return eh().getOfferings();
 }
-async function getProducts(productIds) {
-  return iap().getProducts(productIds);
+async function getProducts(productIds, type = "all") {
+  return iap().fetchProducts({ skus: productIds, type });
 }
 async function purchaseProduct(productId, opts = {}) {
   const I = iap();
-  const result = await I.requestPurchase({ sku: productId, skus: [productId] });
-  const purchase = Array.isArray(result) ? result[0] : result;
-  if (!purchase) throw new Error("purchase-cancelled");
-  const info = await reportToEntitleHub(purchase, productId, opts.isSubscription);
-  try {
-    await I.finishTransaction({ purchase, isConsumable: false });
-  } catch {
+  const isSub = Boolean(opts.isSubscription);
+  const request = { apple: { sku: productId }, google: { skus: [productId] } };
+  if (isSub) {
+    try {
+      const products = await I.fetchProducts({ skus: [productId], type: "subs" });
+      const product = Array.isArray(products) ? products.find((p) => (p?.id ?? p?.productId) === productId) : void 0;
+      const offer = product?.subscriptionOfferDetailsAndroid?.[0] ?? product?.subscriptionOfferDetails?.[0];
+      if (offer?.offerToken) {
+        request.google = { skus: [productId], subscriptionOffers: [{ sku: productId, offerToken: offer.offerToken }] };
+      }
+    } catch {
+    }
   }
-  return info;
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    const cleanup = () => {
+      try {
+        updSub?.remove();
+      } catch {
+      }
+      try {
+        errSub?.remove();
+      } catch {
+      }
+    };
+    const updSub = I.purchaseUpdatedListener(async (purchase) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      try {
+        const info = await reportToEntitleHub(purchase, productId, isSub);
+        try {
+          await I.finishTransaction({ purchase, isConsumable: false });
+        } catch {
+        }
+        resolve(info);
+      } catch (e) {
+        reject(e);
+      }
+    });
+    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"));
+    });
+    Promise.resolve(
+      I.requestPurchase({ request, type: isSub ? "subs" : "in-app" })
+    ).catch((e) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      reject(e);
+    });
+  });
 }
 async function restorePurchases() {
   const I = iap();
@@ -69,7 +118,7 @@ function addCustomerInfoUpdateListener(fn) {
   return eh().addCustomerInfoUpdateListener(fn);
 }
 async function reportToEntitleHub(purchase, productId, isSubscription) {
-  const jws = purchase?.jwsRepresentationIos ?? purchase?.jwsRepresentation ?? purchase?.verificationResultIos;
+  const jws = purchase?.jwsRepresentation ?? purchase?.jwsRepresentationIos;
   if (jws) return eh().reportPurchase({ signedTransaction: jws });
   const token = purchase?.purchaseTokenAndroid ?? purchase?.purchaseToken;
   if (token) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@entitlehub/react-native",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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",