@entitlehub/react-native 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.1.0 — 2026-07-18
+
+Initial release.
+
+- `configureEntitleHub`, `purchaseProduct` (native sheet → validate → entitlements),
+  `restorePurchases`, `getCustomerInfo`, `isEntitled`, `getOfferings`, `getProducts`, `logIn`,
+  `addCustomerInfoUpdateListener`.
+- Wraps `expo-iap` (peer) for the store purchase and `@entitlehub/sdk` for the entitlement layer.
+  Publishable-key only; receipts validated server-side by EntitleHub.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EntitleHub
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# @entitlehub/react-native
+
+[![npm version](https://img.shields.io/npm/v/@entitlehub/react-native)](https://www.npmjs.com/package/@entitlehub/react-native)
+[![license MIT](https://img.shields.io/npm/l/@entitlehub/react-native)](./LICENSE)
+
+EntitleHub for **React Native & Expo** — one call to purchase and unlock entitlements. It opens the
+native store sheet (via [`expo-iap`](https://github.com/hyochan/expo-iap)), validates the receipt
+with EntitleHub server-side, and hands you the updated entitlements. The RevenueCat developer
+experience, on EntitleHub.
+
+```bash
+npx expo install expo-iap
+npm install @entitlehub/react-native @entitlehub/sdk
+```
+
+## Use
+
+```ts
+import {
+  configureEntitleHub, purchaseProduct, getCustomerInfo, restorePurchases, isEntitled,
+} from "@entitlehub/react-native";
+
+// once, after your own login:
+await configureEntitleHub({ apiKey: "pk_live_…", appUserId: user.id });
+
+// gate a feature:
+if (await isEntitled("pro")) unlockPro();
+
+// buy — opens the native sheet, validates, returns entitlements:
+const info = await purchaseProduct("app_pro_monthly", { isSubscription: true });
+if (info.isActive("pro")) unlockPro();
+
+// restore:
+const restored = await restorePurchases();
+```
+
+| Function | What it does |
+|---|---|
+| `configureEntitleHub({ apiKey, appUserId, baseUrl? })` | Configure + open the store connection. |
+| `purchaseProduct(productId, { isSubscription? })` | Native purchase → validate with EntitleHub → returns `CustomerInfo`. |
+| `restorePurchases()` | Re-validate the store's purchases, return `CustomerInfo`. |
+| `getCustomerInfo()` / `isEntitled(id)` | Read entitlements. |
+| `getOfferings()` / `getProducts(ids)` | Catalog metadata / live store prices. |
+| `logIn(appUserId)` | Switch the acting user. |
+| `addCustomerInfoUpdateListener(fn)` | React to entitlement changes. |
+
+Only your **publishable** key (`pk_`) ships in the app. EntitleHub validates the Apple/Google
+receipt server-side, so a forged one is rejected — no secret key on the device.
+
+## How it works
+
+`purchaseProduct` calls `expo-iap` to open the StoreKit / Play Billing sheet, then reports the
+resulting receipt to EntitleHub: the iOS StoreKit 2 JWS, or the Android purchase token. EntitleHub
+verifies it (Apple root CA / Google Play API), writes the entitlement grant, and returns the
+customer info. Renewals/refunds stay current via
+[server-to-server notifications](https://entitlehub.com/docs/store-credentials).
+
+Full guide: **[entitlehub.com/docs/purchases](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

@@ -0,0 +1,121 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  addCustomerInfoUpdateListener: () => addCustomerInfoUpdateListener,
+  configureEntitleHub: () => configureEntitleHub,
+  getCustomerInfo: () => getCustomerInfo,
+  getOfferings: () => getOfferings,
+  getProducts: () => getProducts,
+  isEntitled: () => isEntitled,
+  logIn: () => logIn,
+  purchaseProduct: () => purchaseProduct,
+  restorePurchases: () => restorePurchases
+});
+module.exports = __toCommonJS(index_exports);
+var import_sdk = require("@entitlehub/sdk");
+var _iap;
+function iap() {
+  if (_iap) return _iap;
+  try {
+    _iap = require("expo-iap");
+  } catch {
+    throw new Error("@entitlehub/react-native needs 'expo-iap'. Install it with:  npx expo install expo-iap");
+  }
+  return _iap;
+}
+var client;
+function eh() {
+  if (!client) throw new Error("Call configureEntitleHub({ apiKey, appUserId }) before using EntitleHub.");
+  return client;
+}
+async function configureEntitleHub(opts) {
+  client = new import_sdk.EntitleHub({ apiKey: opts.apiKey, appUserId: opts.appUserId, baseUrl: opts.baseUrl });
+  try {
+    await iap().initConnection();
+  } catch {
+  }
+}
+async function logIn(appUserId) {
+  return eh().logIn(appUserId);
+}
+async function getCustomerInfo() {
+  return eh().getCustomerInfo();
+}
+async function isEntitled(entitlementId) {
+  return eh().isEntitled(entitlementId);
+}
+async function getOfferings() {
+  return eh().getOfferings();
+}
+async function getProducts(productIds) {
+  return iap().getProducts(productIds);
+}
+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 {
+  }
+  return info;
+}
+async function restorePurchases() {
+  const I = iap();
+  const purchases = await I.getAvailablePurchases() || [];
+  for (const p of purchases) {
+    await reportToEntitleHub(p, p.productId ?? p.id ?? p.sku, true).catch(() => {
+    });
+  }
+  return eh().getCustomerInfo({ fetchPolicy: "network-only" });
+}
+function addCustomerInfoUpdateListener(fn) {
+  return eh().addCustomerInfoUpdateListener(fn);
+}
+async function reportToEntitleHub(purchase, productId, isSubscription) {
+  const jws = purchase?.jwsRepresentationIos ?? purchase?.jwsRepresentation ?? purchase?.verificationResultIos;
+  if (jws) return eh().reportPurchase({ signedTransaction: jws });
+  const token = purchase?.purchaseTokenAndroid ?? purchase?.purchaseToken;
+  if (token) {
+    return eh().reportPurchase({
+      store: "play",
+      storeProductId: productId,
+      purchaseToken: token,
+      isSubscription: Boolean(isSubscription)
+    });
+  }
+  throw new Error("Could not read a receipt from the purchase (no iOS JWS or Android purchase token).");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addCustomerInfoUpdateListener,
+  configureEntitleHub,
+  getCustomerInfo,
+  getOfferings,
+  getProducts,
+  isEntitled,
+  logIn,
+  purchaseProduct,
+  restorePurchases
+});

package/dist/index.d.cts

@@ -0,0 +1,37 @@
+import { CustomerInfo, Offerings } from '@entitlehub/sdk';
+export { CustomerInfo, Offerings } from '@entitlehub/sdk';
+
+interface ConfigureOptions {
+    /** Your EntitleHub publishable key (pk_live_… / pk_test_…). Client-safe. */
+    apiKey: string;
+    /** Your own stable user id. */
+    appUserId: string;
+    /** Override the API base (self-host). */
+    baseUrl?: string;
+}
+/** Configure EntitleHub and open the store connection. Call once at startup (after your own login). */
+declare function configureEntitleHub(opts: ConfigureOptions): Promise<void>;
+/** Switch the acting user after your own login. Returns their entitlements. */
+declare function logIn(appUserId: string): Promise<CustomerInfo>;
+/** The current user's entitlements (cached; RC-style CustomerInfo). */
+declare function getCustomerInfo(): Promise<CustomerInfo>;
+/** Convenience: is the user entitled right now? */
+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[]>;
+/**
+ * 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.
+ */
+declare function purchaseProduct(productId: string, opts?: {
+    isSubscription?: boolean;
+}): Promise<CustomerInfo>;
+/** Restore the user's purchases: re-validate each with EntitleHub, then return entitlements. */
+declare function restorePurchases(): 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, addCustomerInfoUpdateListener, configureEntitleHub, getCustomerInfo, getOfferings, getProducts, isEntitled, logIn, purchaseProduct, restorePurchases };

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { CustomerInfo, Offerings } from '@entitlehub/sdk';
+export { CustomerInfo, Offerings } from '@entitlehub/sdk';
+
+interface ConfigureOptions {
+    /** Your EntitleHub publishable key (pk_live_… / pk_test_…). Client-safe. */
+    apiKey: string;
+    /** Your own stable user id. */
+    appUserId: string;
+    /** Override the API base (self-host). */
+    baseUrl?: string;
+}
+/** Configure EntitleHub and open the store connection. Call once at startup (after your own login). */
+declare function configureEntitleHub(opts: ConfigureOptions): Promise<void>;
+/** Switch the acting user after your own login. Returns their entitlements. */
+declare function logIn(appUserId: string): Promise<CustomerInfo>;
+/** The current user's entitlements (cached; RC-style CustomerInfo). */
+declare function getCustomerInfo(): Promise<CustomerInfo>;
+/** Convenience: is the user entitled right now? */
+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[]>;
+/**
+ * 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.
+ */
+declare function purchaseProduct(productId: string, opts?: {
+    isSubscription?: boolean;
+}): Promise<CustomerInfo>;
+/** Restore the user's purchases: re-validate each with EntitleHub, then return entitlements. */
+declare function restorePurchases(): 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, addCustomerInfoUpdateListener, configureEntitleHub, getCustomerInfo, getOfferings, getProducts, isEntitled, logIn, purchaseProduct, restorePurchases };

package/dist/index.js

@@ -0,0 +1,95 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/index.ts
+import { EntitleHub } from "@entitlehub/sdk";
+var _iap;
+function iap() {
+  if (_iap) return _iap;
+  try {
+    _iap = __require("expo-iap");
+  } catch {
+    throw new Error("@entitlehub/react-native needs 'expo-iap'. Install it with:  npx expo install expo-iap");
+  }
+  return _iap;
+}
+var client;
+function eh() {
+  if (!client) throw new Error("Call configureEntitleHub({ apiKey, appUserId }) before using EntitleHub.");
+  return client;
+}
+async function configureEntitleHub(opts) {
+  client = new EntitleHub({ apiKey: opts.apiKey, appUserId: opts.appUserId, baseUrl: opts.baseUrl });
+  try {
+    await iap().initConnection();
+  } catch {
+  }
+}
+async function logIn(appUserId) {
+  return eh().logIn(appUserId);
+}
+async function getCustomerInfo() {
+  return eh().getCustomerInfo();
+}
+async function isEntitled(entitlementId) {
+  return eh().isEntitled(entitlementId);
+}
+async function getOfferings() {
+  return eh().getOfferings();
+}
+async function getProducts(productIds) {
+  return iap().getProducts(productIds);
+}
+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 {
+  }
+  return info;
+}
+async function restorePurchases() {
+  const I = iap();
+  const purchases = await I.getAvailablePurchases() || [];
+  for (const p of purchases) {
+    await reportToEntitleHub(p, p.productId ?? p.id ?? p.sku, true).catch(() => {
+    });
+  }
+  return eh().getCustomerInfo({ fetchPolicy: "network-only" });
+}
+function addCustomerInfoUpdateListener(fn) {
+  return eh().addCustomerInfoUpdateListener(fn);
+}
+async function reportToEntitleHub(purchase, productId, isSubscription) {
+  const jws = purchase?.jwsRepresentationIos ?? purchase?.jwsRepresentation ?? purchase?.verificationResultIos;
+  if (jws) return eh().reportPurchase({ signedTransaction: jws });
+  const token = purchase?.purchaseTokenAndroid ?? purchase?.purchaseToken;
+  if (token) {
+    return eh().reportPurchase({
+      store: "play",
+      storeProductId: productId,
+      purchaseToken: token,
+      isSubscription: Boolean(isSubscription)
+    });
+  }
+  throw new Error("Could not read a receipt from the purchase (no iOS JWS or Android purchase token).");
+}
+export {
+  addCustomerInfoUpdateListener,
+  configureEntitleHub,
+  getCustomerInfo,
+  getOfferings,
+  getProducts,
+  isEntitled,
+  logIn,
+  purchaseProduct,
+  restorePurchases
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@entitlehub/react-native",
+  "version": "0.1.0",
+  "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",
+    "react-native",
+    "expo",
+    "in-app-purchase",
+    "iap",
+    "subscriptions",
+    "storekit",
+    "play-billing",
+    "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" },
+  "license": "MIT",
+  "publishConfig": { "access": "public" },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "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" },
+  "peerDependencies": {
+    "@entitlehub/sdk": ">=0.2.0",
+    "expo-iap": "*",
+    "react": ">=17"
+  },
+  "devDependencies": {
+    "@entitlehub/sdk": "file:../sdk",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.3"
+  }
+}