@entitlehub/react-native 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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

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();
@@ -142,7 +143,7 @@ function addCustomerInfoUpdateListener(fn) {
   return eh().addCustomerInfoUpdateListener(fn);
 }
 async function reportToEntitleHub(purchase, productId, isSubscription) {
-  const jws = purchase?.jwsRepresentation ?? purchase?.jwsRepresentationIos;
+  const jws = purchase?.jwsRepresentation ?? purchase?.jwsRepresentationIos ?? (String(purchase?.platform).toLowerCase() === "ios" ? purchase?.purchaseToken : void 0);
   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>;

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>;

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();
@@ -117,7 +118,7 @@ function addCustomerInfoUpdateListener(fn) {
   return eh().addCustomerInfoUpdateListener(fn);
 }
 async function reportToEntitleHub(purchase, productId, isSubscription) {
-  const jws = purchase?.jwsRepresentation ?? purchase?.jwsRepresentationIos;
+  const jws = purchase?.jwsRepresentation ?? purchase?.jwsRepresentationIos ?? (String(purchase?.platform).toLowerCase() === "ios" ? purchase?.purchaseToken : void 0);
   if (jws) return eh().reportPurchase({ signedTransaction: jws });
   const token = purchase?.purchaseTokenAndroid ?? purchase?.purchaseToken;
   if (token) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@entitlehub/react-native",
-  "version": "0.1.1",
-  "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.",
+  "version": "0.1.3",
+  "description": "EntitleHub for React Native & Expo \u2014 one call to purchase and unlock entitlements. Wraps expo-iap for the native store sheet and validates receipts via EntitleHub.",
   "keywords": [
     "entitlehub",
     "react-native",
@@ -14,10 +14,18 @@
     "entitlements"
   ],
   "homepage": "https://entitlehub.com/docs/purchases",
-  "repository": { "type": "git", "url": "git+https://github.com/DanCue44/entitlehub-sdk.git", "directory": "react-native" },
-  "bugs": { "url": "https://github.com/DanCue44/entitlehub-sdk/issues" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DanCue44/entitlehub-sdk.git",
+    "directory": "react-native"
+  },
+  "bugs": {
+    "url": "https://github.com/DanCue44/entitlehub-sdk/issues"
+  },
   "license": "MIT",
-  "publishConfig": { "access": "public" },
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -29,14 +37,21 @@
       "require": "./dist/index.cjs"
     }
   },
-  "files": ["dist", "README.md", "CHANGELOG.md", "LICENSE"],
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
   "sideEffects": false,
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"
   },
-  "engines": { "node": ">=18" },
+  "engines": {
+    "node": ">=18"
+  },
   "peerDependencies": {
     "@entitlehub/sdk": ">=0.2.0",
     "expo-iap": "*",
@@ -47,4 +62,4 @@
     "tsup": "^8.0.0",
     "typescript": "^5.9.3"
   }
-}
+}