@idealyst/payments 1.2.108 → 1.2.109

package/README.md

@@ -1,100 +1,98 @@
 # @idealyst/payments
 
-Cross-platform payment provider abstractions for React and React Native. Wraps Stripe's Platform Pay API for Apple Pay and Google Pay on mobile.
+Cross-platform In-App Purchase (IAP) wrapper for React Native. Supports StoreKit 2 (iOS) and Google Play Billing (Android) via `react-native-iap`.
 
 ## Installation
 
 ```bash
 yarn add @idealyst/payments
-```
-
-### Native (required for mobile payments)
 
-```bash
-yarn add @stripe/stripe-react-native
+# React Native — required for IAP:
+yarn add react-native-iap
+cd ios && pod install
 ```
 
-Follow the [Stripe React Native setup guide](https://github.com/stripe/stripe-react-native#installation) for iOS/Android configuration.
+Follow the [react-native-iap setup guide](https://github.com/dooboolab-community/react-native-iap#installation) for iOS/Android configuration.
 
 ### Web
 
-No additional dependencies. Web provides a stub that reports all payment methods as unavailable — use [Stripe Elements](https://stripe.com/docs/stripe-js/react) (`@stripe/react-stripe-js`) for web payments.
+No additional dependencies. Web provides a stub — `initializeIAP()` succeeds but product fetches return empty arrays and purchase actions throw descriptive errors.
 
 ## Quick Start
 
 ```tsx
-import { usePayments } from '@idealyst/payments';
+import { useIAP } from '@idealyst/payments';
 
-function CheckoutScreen() {
+function SubscriptionScreen() {
   const {
     isReady,
-    isApplePayAvailable,
-    isGooglePayAvailable,
+    subscriptions,
     isProcessing,
     error,
-    confirmPayment,
-  } = usePayments({
-    config: {
-      publishableKey: 'pk_test_xxx',
-      merchantIdentifier: 'merchant.com.myapp',
-      merchantName: 'My App',
-      merchantCountryCode: 'US',
-    },
+    purchaseSubscription,
+    finishTransaction,
+  } = useIAP({
+    subscriptionSkus: ['pro_monthly', 'pro_yearly'],
   });
 
-  const handlePay = async () => {
-    const result = await confirmPayment({
-      clientSecret: 'pi_xxx_secret_xxx', // from your server
-      amount: { amount: 1099, currencyCode: 'usd' },
-      lineItems: [
-        { label: 'Widget', amount: 999 },
-        { label: 'Tax', amount: 100 },
-      ],
-    });
-    console.log('Paid:', result.paymentIntentId);
+  const handleSubscribe = async (sku: string) => {
+    try {
+      const purchase = await purchaseSubscription(sku);
+
+      // Validate receipt on your server first, then finish
+      await validateReceiptOnServer(purchase.transactionReceipt);
+      await finishTransaction(purchase);
+    } catch (err) {
+      console.error('Purchase failed:', err);
+    }
   };
 
-  if (!isReady) return null;
+  if (!isReady) return <Text>Loading...</Text>;
 
   return (
-    <Button
-      onPress={handlePay}
-      disabled={isProcessing || (!isApplePayAvailable && !isGooglePayAvailable)}
-      label={isApplePayAvailable ? 'Pay with Apple Pay' : 'Pay with Google Pay'}
-    />
+    <View>
+      {subscriptions.map((sub) => (
+        <Button
+          key={sub.sku}
+          onPress={() => handleSubscribe(sub.sku)}
+          disabled={isProcessing}
+        >
+          {sub.title} — {sub.priceFormatted}
+        </Button>
+      ))}
+    </View>
   );
 }
 ```
 
 ## Flat Function API
 
-For more control, use the flat functions directly:
-
 ```typescript
 import {
-  initializePayments,
-  checkPaymentAvailability,
-  confirmPayment,
-  createPaymentMethod,
+  initializeIAP,
+  getProducts,
+  getSubscriptions,
+  purchaseProduct,
+  purchaseSubscription,
+  finishTransaction,
+  restorePurchases,
+  endConnection,
 } from '@idealyst/payments';
 
-await initializePayments({
-  publishableKey: 'pk_test_xxx',
-  merchantName: 'My App',
-  merchantCountryCode: 'US',
-});
-
-const methods = await checkPaymentAvailability();
-const result = await confirmPayment({ clientSecret: '...', amount: { amount: 1099, currencyCode: 'usd' } });
+await initializeIAP();
+const products = await getProducts(['gem_pack_100', 'gem_pack_500']);
+const purchase = await purchaseProduct('gem_pack_100');
+await finishTransaction(purchase, true); // consumable
+await endConnection(); // cleanup
 ```
 
 ## Platform Support
 
 | Feature | iOS | Android | Web |
 |---------|-----|---------|-----|
-| Apple Pay | Yes | — | — |
-| Google Pay | — | Yes | — |
-| Card (via sheet) | Yes | Yes | — |
-| usePayments hook | Yes | Yes | Stub |
-
-Web returns all methods as unavailable. Use `@stripe/react-stripe-js` for web payments.
+| Products (one-time) | Yes | Yes | Stub |
+| Subscriptions | Yes | Yes | Stub |
+| Restore Purchases | Yes | Yes | Stub |
+| useIAP hook | Yes | Yes | Stub |
+| purchaseProduct | Yes | Yes | Throws |
+| purchaseSubscription | Yes | Yes | Throws |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@idealyst/payments",
-  "version": "1.2.108",
-  "description": "Cross-platform payment provider abstractions for React and React Native (Apple Pay, Google Pay, Stripe)",
+  "version": "1.2.109",
+  "description": "Cross-platform In-App Purchase wrapper for React Native (StoreKit 2, Google Play Billing)",
   "documentation": "https://github.com/IdealystIO/idealyst-framework/tree/main/packages/payments#readme",
   "readme": "README.md",
   "main": "src/index.ts",
@@ -38,15 +38,15 @@
     "publish:npm": "npm publish"
   },
   "peerDependencies": {
-    "@stripe/stripe-react-native": ">=0.38.0",
     "react": ">=16.8.0",
-    "react-native": ">=0.60.0"
+    "react-native": ">=0.60.0",
+    "react-native-iap": ">=14.0.0"
   },
   "peerDependenciesMeta": {
-    "@stripe/stripe-react-native": {
+    "react-native": {
       "optional": true
     },
-    "react-native": {
+    "react-native-iap": {
       "optional": true
     }
   },
@@ -61,11 +61,11 @@
   "keywords": [
     "react",
     "react-native",
-    "payments",
-    "apple-pay",
-    "google-pay",
-    "stripe",
-    "platform-pay",
+    "in-app-purchase",
+    "iap",
+    "storekit",
+    "google-play-billing",
+    "subscriptions",
     "cross-platform"
   ]
 }

package/src/constants.ts

@@ -1,7 +1,6 @@
-import type { PaymentProviderStatus } from './types';
+import type { IAPProviderStatus } from './types';
 
-export const INITIAL_PROVIDER_STATUS: PaymentProviderStatus = {
+export const INITIAL_PROVIDER_STATUS: IAPProviderStatus = {
   state: 'uninitialized',
-  availablePaymentMethods: [],
-  isPaymentAvailable: false,
+  isStoreAvailable: false,
 };

package/src/errors.ts

@@ -1,46 +1,78 @@
-import type { PaymentError, PaymentErrorCode } from './types';
+import type { IAPError, IAPErrorCode } from './types';
 
-export function createPaymentError(
-  code: PaymentErrorCode,
+export function createIAPError(
+  code: IAPErrorCode,
   message: string,
   originalError?: unknown,
-): PaymentError {
+): IAPError {
   return { code, message, originalError };
 }
 
 /**
- * Normalize a Stripe error (or any thrown value) into a PaymentError.
+ * Normalize a react-native-iap error (or any thrown value) into an IAPError.
+ *
+ * react-native-iap errors have a `code` property with values like
+ * "E_USER_CANCELLED", "E_ALREADY_OWNED", etc.
  */
-export function normalizeError(error: unknown): PaymentError {
+export function normalizeError(error: unknown): IAPError {
   if (error && typeof error === 'object' && 'code' in error) {
-    const stripeError = error as { code?: string; message?: string };
+    const iapError = error as { code?: string; message?: string };
 
-    switch (stripeError.code) {
-      case 'Canceled':
-      case 'cancelled':
-        return createPaymentError(
+    switch (iapError.code) {
+      case 'E_USER_CANCELLED':
+        return createIAPError(
           'user_cancelled',
-          'Payment was cancelled by user',
+          'Purchase was cancelled by user',
           error,
         );
-      case 'Failed':
-        return createPaymentError(
-          'payment_failed',
-          stripeError.message || 'Payment failed',
+      case 'E_ALREADY_OWNED':
+        return createIAPError(
+          'already_owned',
+          'This item has already been purchased',
+          error,
+        );
+      case 'E_NOT_PREPARED':
+        return createIAPError(
+          'not_initialized',
+          'IAP connection not initialized. Call initializeIAP() first.',
+          error,
+        );
+      case 'E_DEFERRED':
+        return createIAPError(
+          'purchase_pending',
+          'Purchase is pending approval (e.g., Ask to Buy)',
+          error,
+        );
+      case 'E_ITEM_UNAVAILABLE':
+        return createIAPError(
+          'item_unavailable',
+          'The requested product is not available in the store',
+          error,
+        );
+      case 'E_NETWORK_ERROR':
+        return createIAPError(
+          'network_error',
+          iapError.message || 'A network error occurred',
+          error,
+        );
+      case 'E_SERVICE_ERROR':
+        return createIAPError(
+          'store_error',
+          iapError.message || 'The store service encountered an error',
           error,
         );
       default:
-        return createPaymentError(
-          'provider_error',
-          stripeError.message || 'An error occurred with the payment provider',
+        return createIAPError(
+          'unknown',
+          iapError.message || 'An unknown IAP error occurred',
           error,
         );
     }
   }
 
   if (error instanceof Error) {
-    return createPaymentError('unknown', error.message, error);
+    return createIAPError('unknown', error.message, error);
   }
 
-  return createPaymentError('unknown', String(error), error);
+  return createIAPError('unknown', String(error), error);
 }

package/src/index.native.ts

@@ -1,27 +1,39 @@
 export * from './types';
 export { INITIAL_PROVIDER_STATUS } from './constants';
-export { createPaymentError, normalizeError } from './errors';
+export { createIAPError, normalizeError } from './errors';
 export {
-  initializePayments,
-  checkPaymentAvailability,
-  confirmPayment,
-  createPaymentMethod,
-  getPaymentStatus,
+  initializeIAP,
+  getProducts,
+  getSubscriptions,
+  purchaseProduct,
+  purchaseSubscription,
+  finishTransaction,
+  restorePurchases,
+  getIAPStatus,
+  endConnection,
 } from './payments.native';
 
-import { createUsePaymentsHook } from './usePayments';
+import { createUseIAPHook } from './usePayments';
 import {
-  initializePayments,
-  checkPaymentAvailability,
-  confirmPayment,
-  createPaymentMethod,
-  getPaymentStatus,
+  initializeIAP,
+  getProducts,
+  getSubscriptions,
+  purchaseProduct,
+  purchaseSubscription,
+  finishTransaction,
+  restorePurchases,
+  getIAPStatus,
+  endConnection,
 } from './payments.native';
 
-export const usePayments = createUsePaymentsHook({
-  initializePayments,
-  checkPaymentAvailability,
-  confirmPayment,
-  createPaymentMethod,
-  getPaymentStatus,
+export const useIAP = createUseIAPHook({
+  initializeIAP,
+  getProducts,
+  getSubscriptions,
+  purchaseProduct,
+  purchaseSubscription,
+  finishTransaction,
+  restorePurchases,
+  getIAPStatus,
+  endConnection,
 });

package/src/index.ts

@@ -2,28 +2,40 @@
 // Platform-specific entry points (index.native.ts, index.web.ts) are resolved by bundlers.
 export * from './types';
 export { INITIAL_PROVIDER_STATUS } from './constants';
-export { createPaymentError, normalizeError } from './errors';
+export { createIAPError, normalizeError } from './errors';
 export {
-  initializePayments,
-  checkPaymentAvailability,
-  confirmPayment,
-  createPaymentMethod,
-  getPaymentStatus,
+  initializeIAP,
+  getProducts,
+  getSubscriptions,
+  purchaseProduct,
+  purchaseSubscription,
+  finishTransaction,
+  restorePurchases,
+  getIAPStatus,
+  endConnection,
 } from './payments.web';
 
-import { createUsePaymentsHook } from './usePayments';
+import { createUseIAPHook } from './usePayments';
 import {
-  initializePayments,
-  checkPaymentAvailability,
-  confirmPayment,
-  createPaymentMethod,
-  getPaymentStatus,
+  initializeIAP,
+  getProducts,
+  getSubscriptions,
+  purchaseProduct,
+  purchaseSubscription,
+  finishTransaction,
+  restorePurchases,
+  getIAPStatus,
+  endConnection,
 } from './payments.web';
 
-export const usePayments = createUsePaymentsHook({
-  initializePayments,
-  checkPaymentAvailability,
-  confirmPayment,
-  createPaymentMethod,
-  getPaymentStatus,
+export const useIAP = createUseIAPHook({
+  initializeIAP,
+  getProducts,
+  getSubscriptions,
+  purchaseProduct,
+  purchaseSubscription,
+  finishTransaction,
+  restorePurchases,
+  getIAPStatus,
+  endConnection,
 });

package/src/index.web.ts

@@ -1,27 +1,39 @@
 export * from './types';
 export { INITIAL_PROVIDER_STATUS } from './constants';
-export { createPaymentError, normalizeError } from './errors';
+export { createIAPError, normalizeError } from './errors';
 export {
-  initializePayments,
-  checkPaymentAvailability,
-  confirmPayment,
-  createPaymentMethod,
-  getPaymentStatus,
+  initializeIAP,
+  getProducts,
+  getSubscriptions,
+  purchaseProduct,
+  purchaseSubscription,
+  finishTransaction,
+  restorePurchases,
+  getIAPStatus,
+  endConnection,
 } from './payments.web';
 
-import { createUsePaymentsHook } from './usePayments';
+import { createUseIAPHook } from './usePayments';
 import {
-  initializePayments,
-  checkPaymentAvailability,
-  confirmPayment,
-  createPaymentMethod,
-  getPaymentStatus,
+  initializeIAP,
+  getProducts,
+  getSubscriptions,
+  purchaseProduct,
+  purchaseSubscription,
+  finishTransaction,
+  restorePurchases,
+  getIAPStatus,
+  endConnection,
 } from './payments.web';
 
-export const usePayments = createUsePaymentsHook({
-  initializePayments,
-  checkPaymentAvailability,
-  confirmPayment,
-  createPaymentMethod,
-  getPaymentStatus,
+export const useIAP = createUseIAPHook({
+  initializeIAP,
+  getProducts,
+  getSubscriptions,
+  purchaseProduct,
+  purchaseSubscription,
+  finishTransaction,
+  restorePurchases,
+  getIAPStatus,
+  endConnection,
 });