expo-iap 2.9.0 → 2.9.1

package/src/ExpoIap.types.ts

@@ -70,15 +70,7 @@ export type Purchase =
   | (PurchaseAndroid & AndroidPlatform)
   | (PurchaseIOS & IosPlatform);
 
-// Legacy type aliases - deprecated, use Purchase instead
-/**
- * @deprecated Use `Purchase` instead. This type alias will be removed in v2.9.0.
- */
-export type ProductPurchase = Purchase;
-/**
- * @deprecated Use `Purchase` instead. This type alias will be removed in v2.9.0.
- */
-export type SubscriptionPurchase = Purchase;
+// Removed legacy type aliases `ProductPurchase` and `SubscriptionPurchase` in v2.9.0
 
 export type PurchaseResult = {
   responseCode?: number;
@@ -120,6 +112,16 @@ export enum ErrorCode {
   E_ALREADY_PREPARED = 'E_ALREADY_PREPARED',
   E_PENDING = 'E_PENDING',
   E_CONNECTION_CLOSED = 'E_CONNECTION_CLOSED',
+  // Additional detailed errors (Android-focused, kept cross-platform)
+  E_INIT_CONNECTION = 'E_INIT_CONNECTION',
+  E_SERVICE_DISCONNECTED = 'E_SERVICE_DISCONNECTED',
+  E_QUERY_PRODUCT = 'E_QUERY_PRODUCT',
+  E_SKU_NOT_FOUND = 'E_SKU_NOT_FOUND',
+  E_SKU_OFFER_MISMATCH = 'E_SKU_OFFER_MISMATCH',
+  E_ITEM_NOT_OWNED = 'E_ITEM_NOT_OWNED',
+  E_BILLING_UNAVAILABLE = 'E_BILLING_UNAVAILABLE',
+  E_FEATURE_NOT_SUPPORTED = 'E_FEATURE_NOT_SUPPORTED',
+  E_EMPTY_SKU_LIST = 'E_EMPTY_SKU_LIST',
 }
 
 /**
@@ -180,26 +182,59 @@ export const ErrorCodeMapping = {
     [ErrorCode.E_ALREADY_PREPARED]: 'E_ALREADY_PREPARED',
     [ErrorCode.E_PENDING]: 'E_PENDING',
     [ErrorCode.E_CONNECTION_CLOSED]: 'E_CONNECTION_CLOSED',
+    [ErrorCode.E_INIT_CONNECTION]: 'E_INIT_CONNECTION',
+    [ErrorCode.E_SERVICE_DISCONNECTED]: 'E_SERVICE_DISCONNECTED',
+    [ErrorCode.E_QUERY_PRODUCT]: 'E_QUERY_PRODUCT',
+    [ErrorCode.E_SKU_NOT_FOUND]: 'E_SKU_NOT_FOUND',
+    [ErrorCode.E_SKU_OFFER_MISMATCH]: 'E_SKU_OFFER_MISMATCH',
+    [ErrorCode.E_ITEM_NOT_OWNED]: 'E_ITEM_NOT_OWNED',
+    [ErrorCode.E_BILLING_UNAVAILABLE]: 'E_BILLING_UNAVAILABLE',
+    [ErrorCode.E_FEATURE_NOT_SUPPORTED]: 'E_FEATURE_NOT_SUPPORTED',
+    [ErrorCode.E_EMPTY_SKU_LIST]: 'E_EMPTY_SKU_LIST',
   },
 } as const;
 
+export type PurchaseErrorProps = {
+  message: string;
+  responseCode?: number;
+  debugMessage?: string;
+  code?: ErrorCode;
+  productId?: string;
+  platform?: 'ios' | 'android';
+};
+
 export class PurchaseError implements Error {
-  constructor(
-    public name: string,
-    public message: string,
-    public responseCode?: number,
-    public debugMessage?: string,
-    public code?: ErrorCode,
-    public productId?: string,
-    public platform?: 'ios' | 'android',
-  ) {
+  public name: string;
+  public message: string;
+  public responseCode?: number;
+  public debugMessage?: string;
+  public code?: ErrorCode;
+  public productId?: string;
+  public platform?: 'ios' | 'android';
+
+  // Backwards-compatible constructor: accepts either props object or legacy positional args
+  constructor(messageOrProps: string | PurchaseErrorProps, ...rest: any[]) {
     this.name = '[expo-iap]: PurchaseError';
-    this.message = message;
-    this.responseCode = responseCode;
-    this.debugMessage = debugMessage;
-    this.code = code;
-    this.productId = productId;
-    this.platform = platform;
+
+    if (typeof messageOrProps === 'string') {
+      // Legacy signature: (name, message, responseCode?, debugMessage?, code?, productId?, platform?)
+      // The first legacy argument was a name which we always override, so treat it as message here
+      const message = messageOrProps;
+      this.message = message;
+      this.responseCode = rest[0];
+      this.debugMessage = rest[1];
+      this.code = rest[2];
+      this.productId = rest[3];
+      this.platform = rest[4];
+    } else {
+      const props = messageOrProps;
+      this.message = props.message;
+      this.responseCode = props.responseCode;
+      this.debugMessage = props.debugMessage;
+      this.code = props.code;
+      this.productId = props.productId;
+      this.platform = props.platform;
+    }
   }
 
   /**
@@ -216,15 +251,14 @@ export class PurchaseError implements Error {
       ? ErrorCodeUtils.fromPlatformCode(errorData.code, platform)
       : ErrorCode.E_UNKNOWN;
 
-    return new PurchaseError(
-      '[expo-iap]: PurchaseError',
-      errorData.message || 'Unknown error occurred',
-      errorData.responseCode,
-      errorData.debugMessage,
-      errorCode,
-      errorData.productId,
+    return new PurchaseError({
+      message: errorData.message || 'Unknown error occurred',
+      responseCode: errorData.responseCode,
+      debugMessage: errorData.debugMessage,
+      code: errorCode,
+      productId: errorData.productId,
       platform,
-    );
+    });
   }
 
   /**
@@ -260,8 +294,16 @@ export const ErrorCodeUtils = {
     platformCode: string | number,
     platform: 'ios' | 'android',
   ): ErrorCode => {
-    const mapping = ErrorCodeMapping[platform];
+    // Prefer dynamic native mapping for iOS to avoid drift
+    if (platform === 'ios') {
+      for (const [key, value] of Object.entries(NATIVE_ERROR_CODES || {})) {
+        if (value === platformCode) {
+          return key as ErrorCode;
+        }
+      }
+    }
 
+    const mapping = ErrorCodeMapping[platform];
     for (const [errorCode, mappedCode] of Object.entries(mapping)) {
       if (mappedCode === platformCode) {
         return errorCode as ErrorCode;
@@ -281,10 +323,15 @@ export const ErrorCodeUtils = {
     errorCode: ErrorCode,
     platform: 'ios' | 'android',
   ): string | number => {
-    return (
-      ErrorCodeMapping[platform][errorCode] ??
-      (platform === 'ios' ? 0 : 'E_UNKNOWN')
-    );
+    if (platform === 'ios') {
+      const native = NATIVE_ERROR_CODES?.[errorCode];
+      if (native !== undefined) return native;
+    }
+    const mapping = ErrorCodeMapping[platform] as Record<
+      ErrorCode,
+      string | number
+    >;
+    return mapping[errorCode] ?? (platform === 'ios' ? 0 : 'E_UNKNOWN');
   },
 
   /**

package/src/index.ts

@@ -143,7 +143,12 @@ export const getProducts = async (skus: string[]): Promise<Product[]> => {
     "`getProducts` is deprecated. Use `fetchProducts({ skus, type: 'inapp' })` instead. This function will be removed in version 3.0.0.",
   );
   if (!skus?.length) {
-    return Promise.reject(new Error('"skus" is required'));
+    return Promise.reject(
+      new PurchaseError({
+        message: 'No SKUs provided',
+        code: ErrorCode.E_EMPTY_SKU_LIST,
+      }),
+    );
   }
 
   return Platform.select({
@@ -177,7 +182,12 @@ export const getSubscriptions = async (
     "`getSubscriptions` is deprecated. Use `fetchProducts({ skus, type: 'subs' })` instead. This function will be removed in version 3.0.0.",
   );
   if (!skus?.length) {
-    return Promise.reject(new Error('"skus" is required'));
+    return Promise.reject(
+      new PurchaseError({
+        message: 'No SKUs provided',
+        code: ErrorCode.E_EMPTY_SKU_LIST,
+      }),
+    );
   }
 
   return Platform.select({
@@ -245,7 +255,10 @@ export const fetchProducts = async ({
   type?: 'inapp' | 'subs';
 }): Promise<Product[] | SubscriptionProduct[]> => {
   if (!skus?.length) {
-    throw new Error('No SKUs provided');
+    throw new PurchaseError({
+      message: 'No SKUs provided',
+      code: ErrorCode.E_EMPTY_SKU_LIST,
+    });
   }
 
   if (Platform.OS === 'ios') {
@@ -344,7 +357,8 @@ export const getPurchaseHistory = ({
   console.warn(
     '`getPurchaseHistory` is deprecated. Use `getPurchaseHistories` instead. This function will be removed in version 3.0.0.',
   );
-  return getPurchaseHistories({
+  // Use available purchases as a best-effort replacement
+  return getAvailablePurchases({
     alsoPublishToEventListenerIOS:
       alsoPublishToEventListenerIOS ?? alsoPublishToEventListener,
     onlyIncludeActiveItemsIOS:
@@ -352,42 +366,7 @@ export const getPurchaseHistory = ({
   });
 };
 
-/**
- * @deprecated Use getAvailablePurchases instead. This function is just calling getAvailablePurchases internally on iOS
- * and returns an empty array on Android (Google Play Billing v8 removed purchase history API).
- * Will be removed in v2.9.0
- */
-export const getPurchaseHistories = ({
-  alsoPublishToEventListener = false,
-  onlyIncludeActiveItems = false,
-  alsoPublishToEventListenerIOS,
-  onlyIncludeActiveItemsIOS,
-}: {
-  /** @deprecated Use alsoPublishToEventListenerIOS instead */
-  alsoPublishToEventListener?: boolean;
-  /** @deprecated Use onlyIncludeActiveItemsIOS instead */
-  onlyIncludeActiveItems?: boolean;
-  alsoPublishToEventListenerIOS?: boolean;
-  onlyIncludeActiveItemsIOS?: boolean;
-} = {}): Promise<Purchase[]> =>
-  (
-    Platform.select({
-      ios: async () => {
-        return ExpoIapModule.getAvailableItems(
-          alsoPublishToEventListenerIOS ?? alsoPublishToEventListener,
-          onlyIncludeActiveItemsIOS ?? onlyIncludeActiveItems,
-        );
-      },
-      android: async () => {
-        // getPurchaseHistoryByType was removed in Google Play Billing Library v8
-        // Android doesn't provide purchase history anymore, only active purchases
-        console.warn(
-          'getPurchaseHistories is not supported on Android with Google Play Billing Library v8. Use getAvailablePurchases instead to get active purchases.',
-        );
-        return [];
-      },
-    }) || (() => Promise.resolve([]))
-  )();
+// NOTE: `getPurchaseHistories` removed in v2.9.0. Use `getAvailablePurchases` instead.
 
 export const getAvailablePurchases = ({
   alsoPublishToEventListener = false,
@@ -652,15 +631,12 @@ export const finishTransaction = ({
 
         if (!token) {
           return Promise.reject(
-            new PurchaseError(
-              '[expo-iap]: PurchaseError',
-              'Purchase token is required to finish transaction',
-              undefined,
-              undefined,
-              'E_DEVELOPER_ERROR' as ErrorCode,
-              androidPurchase.productId,
-              'android',
-            ),
+            new PurchaseError({
+              message: 'Purchase token is required to finish transaction',
+              code: 'E_DEVELOPER_ERROR' as ErrorCode,
+              productId: androidPurchase.productId,
+              platform: 'android',
+            }),
           );
         }
 

package/src/modules/ios.ts

@@ -9,7 +9,7 @@ import type {
   Product,
   Purchase,
   PurchaseError,
-  ProductStatusIOS,
+  SubscriptionStatusIOS,
   AppTransactionIOS,
 } from '../ExpoIap.types';
 import {Linking} from 'react-native';
@@ -122,7 +122,7 @@ export const isEligibleForIntroOfferIOS = (
  */
 export const subscriptionStatusIOS = (
   sku: string,
-): Promise<ProductStatusIOS[]> => {
+): Promise<SubscriptionStatusIOS[]> => {
   return ExpoIapModule.subscriptionStatusIOS(sku);
 };
 
@@ -310,12 +310,7 @@ export const requestPurchaseOnPromotedProductIOS = (): Promise<void> => {
   return ExpoIapModule.requestPurchaseOnPromotedProductIOS();
 };
 
-/**
- * @deprecated Use requestPurchaseOnPromotedProductIOS instead. Will be removed in v2.9.0
- */
-export const buyPromotedProductIOS = (): Promise<void> => {
-  return requestPurchaseOnPromotedProductIOS();
-};
+// NOTE: buyPromotedProductIOS removed in v2.9.0. Use requestPurchaseOnPromotedProductIOS.
 
 /**
  * Get pending transactions that haven't been finished yet (iOS only).
@@ -374,7 +369,7 @@ export const isEligibleForIntroOffer = (groupId: string): Promise<boolean> => {
  */
 export const subscriptionStatus = (
   sku: string,
-): Promise<ProductStatusIOS[]> => {
+): Promise<SubscriptionStatusIOS[]> => {
   console.warn(
     '`subscriptionStatus` is deprecated. Use `subscriptionStatusIOS` instead. This function will be removed in version 3.0.0.',
   );

package/src/types/ExpoIapAndroid.types.ts

@@ -33,18 +33,6 @@ export type ProductAndroid = ProductCommon & {
   oneTimePurchaseOfferDetailsAndroid?: ProductAndroidOneTimePurchaseOfferDetail;
   platform: 'android';
   subscriptionOfferDetailsAndroid?: ProductSubscriptionAndroidOfferDetail[];
-  /**
-   * @deprecated Use `nameAndroid` instead. This field will be removed in v2.9.0.
-   */
-  name?: string;
-  /**
-   * @deprecated Use `oneTimePurchaseOfferDetailsAndroid` instead. This field will be removed in v2.9.0.
-   */
-  oneTimePurchaseOfferDetails?: ProductAndroidOneTimePurchaseOfferDetail;
-  /**
-   * @deprecated Use `subscriptionOfferDetailsAndroid` instead. This field will be removed in v2.9.0.
-   */
-  subscriptionOfferDetails?: ProductSubscriptionAndroidOfferDetail[];
 };
 
 type ProductSubscriptionAndroidOfferDetails = {
@@ -57,10 +45,6 @@ type ProductSubscriptionAndroidOfferDetails = {
 
 export type ProductSubscriptionAndroid = ProductAndroid & {
   subscriptionOfferDetailsAndroid: ProductSubscriptionAndroidOfferDetails[];
-  /**
-   * @deprecated Use `subscriptionOfferDetailsAndroid` instead. This field will be removed in v2.9.0.
-   */
-  subscriptionOfferDetails?: ProductSubscriptionAndroidOfferDetails[];
 };
 
 // Legacy naming for backward compatibility
@@ -137,10 +121,7 @@ export enum PurchaseAndroidState {
 }
 
 // Legacy naming for backward compatibility
-/**
- * @deprecated Use `PurchaseAndroidState` instead. This enum will be removed in v2.9.0.
- */
-export const PurchaseStateAndroid = PurchaseAndroidState;
+// Removed legacy alias `PurchaseStateAndroid` in v2.9.0
 
 // Legacy naming for backward compatibility
 export type ProductPurchaseAndroid = PurchaseCommon & {
@@ -163,19 +144,4 @@ export type ProductPurchaseAndroid = PurchaseCommon & {
 // Preferred naming
 export type PurchaseAndroid = ProductPurchaseAndroid;
 
-// Legacy type aliases for backward compatibility
-/**
- * @deprecated Use `ProductAndroidOneTimePurchaseOfferDetail` instead. This type will be removed in v2.9.0.
- */
-export type OneTimePurchaseOfferDetails =
-  ProductAndroidOneTimePurchaseOfferDetail;
-
-/**
- * @deprecated Use `ProductSubscriptionAndroidOfferDetail` instead. This type will be removed in v2.9.0.
- */
-export type SubscriptionOfferDetail = ProductSubscriptionAndroidOfferDetail;
-
-/**
- * @deprecated Use `ProductSubscriptionAndroidOfferDetails` instead. This type will be removed in v2.9.0.
- */
-export type SubscriptionOfferAndroid = ProductSubscriptionAndroidOfferDetails;
+// Removed legacy Android alias types in v2.9.0

package/src/types/ExpoIapIOS.types.ts

@@ -32,22 +32,6 @@ export type ProductIOS = ProductCommon & {
   jsonRepresentationIOS: string;
   platform: 'ios';
   subscriptionInfoIOS?: SubscriptionInfo;
-  /**
-   * @deprecated Use `displayNameIOS` instead. This field will be removed in v2.9.0.
-   */
-  displayName?: string;
-  /**
-   * @deprecated Use `isFamilyShareableIOS` instead. This field will be removed in v2.9.0.
-   */
-  isFamilyShareable?: boolean;
-  /**
-   * @deprecated Use `jsonRepresentationIOS` instead. This field will be removed in v2.9.0.
-   */
-  jsonRepresentation?: string;
-  /**
-   * @deprecated Use `subscriptionInfoIOS` instead. This field will be removed in v2.9.0.
-   */
-  subscription?: SubscriptionInfo;
   introductoryPriceNumberOfPeriodsIOS?: string;
   introductoryPriceSubscriptionPeriodIOS?: SubscriptionIosPeriod;
 };
@@ -72,14 +56,6 @@ export type ProductSubscriptionIOS = ProductIOS & {
   platform: 'ios';
   subscriptionPeriodNumberIOS?: string;
   subscriptionPeriodUnitIOS?: SubscriptionIosPeriod;
-  /**
-   * @deprecated Use `discountsIOS` instead. This field will be removed in v2.9.0.
-   */
-  discounts?: Discount[];
-  /**
-   * @deprecated Use `introductoryPriceIOS` instead. This field will be removed in v2.9.0.
-   */
-  introductoryPrice?: string;
 };
 
 // Legacy naming for backward compatibility
@@ -119,7 +95,7 @@ export type RequestPurchaseIosProps = {
   withOffer?: PaymentDiscount;
 };
 
-type SubscriptionStatus =
+type SubscriptionState =
   | 'expired'
   | 'inBillingRetryPeriod'
   | 'inGracePeriod'
@@ -132,8 +108,8 @@ type RenewalInfo = {
   autoRenewPreference?: string;
 };
 
-export type ProductStatusIOS = {
-  state: SubscriptionStatus;
+export type SubscriptionStatusIOS = {
+  state: SubscriptionState;
   renewalInfo?: RenewalInfo;
 };
 

package/src/useIAP.ts

@@ -11,7 +11,6 @@ import {
   purchaseUpdatedListener,
   promotedProductListenerIOS,
   getAvailablePurchases,
-  getPurchaseHistories,
   finishTransaction as finishTransactionInternal,
   requestPurchase as requestPurchaseInternal,
   fetchProducts,
@@ -35,7 +34,13 @@ import {
   SubscriptionProduct,
   RequestPurchaseProps,
   RequestSubscriptionProps,
+  ErrorCode,
 } from './ExpoIap.types';
+import {
+  getUserFriendlyErrorMessage,
+  isUserCancelledError,
+  isRecoverableError,
+} from './utils/errorMapping';
 
 type UseIap = {
   connected: boolean;
@@ -43,7 +48,6 @@ type UseIap = {
   promotedProductsIOS: Purchase[];
   promotedProductIdIOS?: string;
   subscriptions: SubscriptionProduct[];
-  purchaseHistories: Purchase[];
   availablePurchases: Purchase[];
   currentPurchase?: Purchase;
   currentPurchaseError?: PurchaseError;
@@ -59,7 +63,6 @@ type UseIap = {
     isConsumable?: boolean;
   }) => Promise<PurchaseResult | boolean>;
   getAvailablePurchases: (skus: string[]) => Promise<void>;
-  getPurchaseHistories: (skus: string[]) => Promise<void>;
   fetchProducts: (params: {
     skus: string[];
     type?: 'inapp' | 'subs';
@@ -98,8 +101,6 @@ type UseIap = {
   restorePurchases: () => Promise<void>;
   getPromotedProductIOS: () => Promise<Product | null>;
   requestPurchaseOnPromotedProductIOS: () => Promise<void>;
-  /** @deprecated Use requestPurchaseOnPromotedProductIOS instead */
-  buyPromotedProductIOS: () => Promise<void>;
   getActiveSubscriptions: (subscriptionIds?: string[]) => Promise<void>;
   hasActiveSubscriptions: (subscriptionIds?: string[]) => Promise<boolean>;
 };
@@ -114,14 +115,14 @@ export interface UseIAPOptions {
 
 /**
  * React Hook for managing In-App Purchases.
- * See documentation at https://expo-iap.hyo.dev/docs/hooks/useIAP
+ * See documentation at https://hyochan.github.io/expo-iap/docs/hooks/useIAP
  */
 export function useIAP(options?: UseIAPOptions): UseIap {
   const [connected, setConnected] = useState<boolean>(false);
   const [products, setProducts] = useState<Product[]>([]);
   const [promotedProductsIOS] = useState<Purchase[]>([]);
   const [subscriptions, setSubscriptions] = useState<SubscriptionProduct[]>([]);
-  const [purchaseHistories, setPurchaseHistories] = useState<Purchase[]>([]);
+  // Removed in v2.9.0: purchaseHistories state and related API
   const [availablePurchases, setAvailablePurchases] = useState<Purchase[]>([]);
   const [currentPurchase, setCurrentPurchase] = useState<Purchase>();
   const [promotedProductIOS, setPromotedProductIOS] = useState<Product>();
@@ -133,6 +134,7 @@ export function useIAP(options?: UseIAPOptions): UseIap {
   >([]);
 
   const optionsRef = useRef<UseIAPOptions | undefined>(options);
+  const connectedRef = useRef<boolean>(false);
 
   // Helper function to merge arrays with duplicate checking
   const mergeWithDuplicateCheck = useCallback(
@@ -159,6 +161,10 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     optionsRef.current = options;
   }, [options]);
 
+  useEffect(() => {
+    connectedRef.current = connected;
+  }, [connected]);
+
   const subscriptionsRef = useRef<{
     purchaseUpdate?: EventSubscription;
     purchaseError?: EventSubscription;
@@ -298,13 +304,7 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     [],
   );
 
-  /**
-   * @deprecated Use getAvailablePurchases instead. This function is just calling getAvailablePurchases internally.
-   * Will be removed in v2.9.0
-   */
-  const getPurchaseHistoriesInternal = useCallback(async (): Promise<void> => {
-    setPurchaseHistories(await getPurchaseHistories());
-  }, []);
+  // NOTE: getPurchaseHistories removed in v2.9.0. Use getAvailablePurchases instead.
 
   const finishTransaction = useCallback(
     async ({
@@ -420,9 +420,32 @@ export function useIAP(options?: UseIAPOptions): UseIap {
       },
     );
 
-    // IMPORTANT: Do NOT register the purchase error listener until after initConnection succeeds.
-    // Some platforms may emit an initialization error event (E_INIT_CONNECTION) during startup.
-    // Delaying registration prevents noisy, misleading errors before the connection is ready.
+    // Register purchase error listener EARLY. Ignore init-related errors until connected.
+    subscriptionsRef.current.purchaseError = purchaseErrorListener(
+      (error: PurchaseError) => {
+        if (
+          !connectedRef.current &&
+          error.code === ErrorCode.E_INIT_CONNECTION
+        ) {
+          return; // Ignore initialization error before connected
+        }
+        const friendly = getUserFriendlyErrorMessage(error);
+        console.log('[useIAP] Purchase error callback triggered:', error);
+        if (isUserCancelledError(error)) {
+          console.log('[useIAP] User cancelled purchase');
+        } else if (isRecoverableError(error)) {
+          console.log('[useIAP] Recoverable purchase error:', friendly);
+        } else {
+          console.warn('[useIAP] Purchase error:', friendly);
+        }
+        setCurrentPurchase(undefined);
+        setCurrentPurchaseError(error);
+
+        if (optionsRef.current?.onPurchaseError) {
+          optionsRef.current.onPurchaseError(error);
+        }
+      },
+    );
 
     if (Platform.OS === 'ios') {
       // iOS promoted products listener
@@ -453,22 +476,9 @@ export function useIAP(options?: UseIAPOptions): UseIap {
       subscriptionsRef.current.promotedProductsIOS?.remove();
       subscriptionsRef.current.purchaseUpdate = undefined;
       subscriptionsRef.current.promotedProductsIOS = undefined;
-      // Do not register error listener when connection fails
+      // Keep purchaseError listener registered to capture subsequent retries
       return;
     }
-
-    // Now that the connection is established, register the purchase error listener.
-    subscriptionsRef.current.purchaseError = purchaseErrorListener(
-      (error: PurchaseError) => {
-        console.log('[useIAP] Purchase error callback triggered:', error);
-        setCurrentPurchase(undefined);
-        setCurrentPurchaseError(error);
-
-        if (optionsRef.current?.onPurchaseError) {
-          optionsRef.current.onPurchaseError(error);
-        }
-      },
-    );
   }, [refreshSubscriptionStatus]);
 
   useEffect(() => {
@@ -491,7 +501,6 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     promotedProductsIOS,
     promotedProductIdIOS,
     subscriptions,
-    purchaseHistories,
     finishTransaction,
     availablePurchases,
     currentPurchase,
@@ -501,7 +510,6 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     clearCurrentPurchase,
     clearCurrentPurchaseError,
     getAvailablePurchases: getAvailablePurchasesInternal,
-    getPurchaseHistories: getPurchaseHistoriesInternal,
     fetchProducts: fetchProductsInternal,
     requestProducts: requestProductsInternal,
     requestPurchase: requestPurchaseWithReset,
@@ -511,7 +519,6 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     getSubscriptions: getSubscriptionsInternal,
     getPromotedProductIOS,
     requestPurchaseOnPromotedProductIOS,
-    buyPromotedProductIOS: requestPurchaseOnPromotedProductIOS, // deprecated alias
     getActiveSubscriptions: getActiveSubscriptionsInternal,
     hasActiveSubscriptions: hasActiveSubscriptionsInternal,
   };

package/src/utils/errorMapping.ts

@@ -32,6 +32,8 @@ export function isNetworkError(error: any): boolean {
     ErrorCode.E_NETWORK_ERROR,
     ErrorCode.E_REMOTE_ERROR,
     ErrorCode.E_SERVICE_ERROR,
+    ErrorCode.E_SERVICE_DISCONNECTED,
+    ErrorCode.E_BILLING_UNAVAILABLE,
   ];
 
   const errorCode = typeof error === 'string' ? error : error?.code;
@@ -49,6 +51,10 @@ export function isRecoverableError(error: any): boolean {
     ErrorCode.E_REMOTE_ERROR,
     ErrorCode.E_SERVICE_ERROR,
     ErrorCode.E_INTERRUPTED,
+    ErrorCode.E_SERVICE_DISCONNECTED,
+    ErrorCode.E_BILLING_UNAVAILABLE,
+    ErrorCode.E_QUERY_PRODUCT,
+    ErrorCode.E_INIT_CONNECTION,
   ];
 
   const errorCode = typeof error === 'string' ? error : error?.code;
@@ -68,20 +74,38 @@ export function getUserFriendlyErrorMessage(error: any): string {
       return 'Purchase was cancelled by user';
     case ErrorCode.E_NETWORK_ERROR:
       return 'Network connection error. Please check your internet connection and try again.';
+    case ErrorCode.E_SERVICE_DISCONNECTED:
+      return 'Billing service disconnected. Please try again.';
+    case ErrorCode.E_BILLING_UNAVAILABLE:
+      return 'Billing is unavailable on this device or account.';
     case ErrorCode.E_ITEM_UNAVAILABLE:
       return 'This item is not available for purchase';
+    case ErrorCode.E_ITEM_NOT_OWNED:
+      return "You don't own this item";
     case ErrorCode.E_ALREADY_OWNED:
       return 'You already own this item';
+    case ErrorCode.E_SKU_NOT_FOUND:
+      return 'Requested product could not be found';
+    case ErrorCode.E_SKU_OFFER_MISMATCH:
+      return 'Selected offer does not match the SKU';
     case ErrorCode.E_DEFERRED_PAYMENT:
       return 'Payment is pending approval';
     case ErrorCode.E_NOT_PREPARED:
       return 'In-app purchase is not ready. Please try again later.';
     case ErrorCode.E_SERVICE_ERROR:
       return 'Store service error. Please try again later.';
+    case ErrorCode.E_FEATURE_NOT_SUPPORTED:
+      return 'This feature is not supported on this device.';
     case ErrorCode.E_TRANSACTION_VALIDATION_FAILED:
       return 'Transaction could not be verified';
     case ErrorCode.E_RECEIPT_FAILED:
       return 'Receipt processing failed';
+    case ErrorCode.E_EMPTY_SKU_LIST:
+      return 'No product IDs provided';
+    case ErrorCode.E_INIT_CONNECTION:
+      return 'Failed to initialize billing connection';
+    case ErrorCode.E_QUERY_PRODUCT:
+      return 'Failed to query products. Please try again later.';
     default:
       return error?.message || 'An unexpected error occurred';
   }