fix(useIAP): forward PurchaseOptions in getAvailablePurchases and res… (#3173)

…torePurchases

The hook's getAvailablePurchases and restorePurchases methods were
hardcoding PurchaseOptions (alsoPublishToEventListenerIOS,
onlyIncludeActiveItemsIOS), making it impossible for hook consumers to
customize these values.

This change adds an optional PurchaseOptions parameter to both methods,
defaulting to the previous behavior for backward compatibility.

Related to hyochan/expo-iap#329

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

## Release Notes

* **New Features**
* Added optional configuration options to purchase retrieval methods for
greater control over which purchases are included in results.
* New platform-specific settings available: iOS can filter active items
and control event listener publishing; Android can include or exclude
suspended purchases.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: hyochan

src/__tests__/index.test.ts

@@ -812,10 +812,10 @@ describe('Public API (src/index.ts)', () => {
         .mockResolvedValueOnce([nitro('s1')]);
       const res = await IAP.getAvailablePurchases();
       expect(mockIap.getAvailablePurchases).toHaveBeenNthCalledWith(1, {
-        android: {type: 'inapp'},
+        android: {type: 'inapp', includeSuspended: false},
       });
       expect(mockIap.getAvailablePurchases).toHaveBeenNthCalledWith(2, {
-        android: {type: 'subs'},
+        android: {type: 'subs', includeSuspended: false},
       });
       expect(res.map((p: any) => p.productId).sort()).toEqual(['p1', 's1']);
     });

src/hooks/useIAP.ts

@@ -40,6 +40,7 @@ import type {
   VerifyPurchaseResult,
   VerifyPurchaseWithProviderProps,
   VerifyPurchaseWithProviderResult,
+  PurchaseOptions,
 } from '../types';
 import type {
   ActiveSubscription,
@@ -63,7 +64,7 @@ type UseIap = {
   promotedProductIOS?: Product;
   activeSubscriptions: ActiveSubscription[];
   finishTransaction: (args: MutationFinishTransactionArgs) => Promise<void>;
-  getAvailablePurchases: (skus?: string[]) => Promise<void>;
+  getAvailablePurchases: (options?: PurchaseOptions) => Promise<void>;
   fetchProducts: (params: {
     skus: string[];
     type?: ProductQueryType | null;
@@ -83,7 +84,7 @@ type UseIap = {
   verifyPurchaseWithProvider: (
     options: VerifyPurchaseWithProviderProps,
   ) => Promise<VerifyPurchaseWithProviderResult>;
-  restorePurchases: () => Promise<void>;
+  restorePurchases: (options?: PurchaseOptions) => Promise<void>;
   getPromotedProductIOS: () => Promise<Product | null>;
   requestPurchaseOnPromotedProductIOS: () => Promise<boolean>;
   getActiveSubscriptions: (
@@ -271,11 +272,13 @@ export function useIAP(options?: UseIapOptions): UseIap {
   );
 
   const getAvailablePurchasesInternal = useCallback(
-    async (_skus?: string[]): Promise<void> => {
+    async (options?: PurchaseOptions): Promise<void> => {
       try {
         const result = await getAvailablePurchases({
-          alsoPublishToEventListenerIOS: false,
-          onlyIncludeActiveItemsIOS: true,
+          alsoPublishToEventListenerIOS:
+            options?.alsoPublishToEventListenerIOS ?? false,
+          onlyIncludeActiveItemsIOS: options?.onlyIncludeActiveItemsIOS ?? true,
+          includeSuspendedAndroid: options?.includeSuspendedAndroid ?? false,
         });
         setAvailablePurchases(result);
       } catch (error) {
@@ -333,18 +336,21 @@ export function useIAP(options?: UseIapOptions): UseIap {
     [],
   );
 
-  const restorePurchases = useCallback(async (): Promise<void> => {
-    try {
-      if (Platform.OS === 'ios') {
-        await syncIOS();
-      }
+  const restorePurchases = useCallback(
+    async (options?: PurchaseOptions): Promise<void> => {
+      try {
+        if (Platform.OS === 'ios') {
+          await syncIOS();
+        }
 
-      await getAvailablePurchasesInternal();
-    } catch (error) {
-      RnIapConsole.warn('Failed to restore purchases:', error);
-      invokeOnError(error);
-    }
-  }, [getAvailablePurchasesInternal, invokeOnError]);
+        await getAvailablePurchasesInternal(options);
+      } catch (error) {
+        RnIapConsole.warn('Failed to restore purchases:', error);
+        invokeOnError(error);
+      }
+    },
+    [getAvailablePurchasesInternal, invokeOnError],
+  );
 
   const validateReceipt = useCallback(
     async (options: VerifyPurchaseProps): Promise<VerifyPurchaseResult> =>

src/index.ts

@@ -737,11 +737,14 @@ export const getAvailablePurchases: QueryField<
       return validPurchases.map(convertNitroPurchaseToPurchase);
     } else if (Platform.OS === 'android') {
       // For Android, we need to call twice for inapp and subs
+      const includeSuspended = Boolean(
+        options?.includeSuspendedAndroid ?? false,
+      );
       const inappNitroPurchases = await IAP.instance.getAvailablePurchases({
-        android: {type: 'inapp'},
+        android: {type: 'inapp', includeSuspended},
       });
       const subsNitroPurchases = await IAP.instance.getAvailablePurchases({
-        android: {type: 'subs'},
+        android: {type: 'subs', includeSuspended},
       });
 
       // Validate and convert both sets of purchases