expo-iap 2.8.5 → 2.8.7

package/src/index.ts

@@ -124,7 +124,7 @@ export function initConnection(): Promise<boolean> {
 
 export const getProducts = async (skus: string[]): Promise<Product[]> => {
   console.warn(
-    "`getProducts` is deprecated. Use `requestProducts({ skus, type: 'inapp' })` instead. This function will be removed in version 3.0.0.",
+    "`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'));
@@ -132,7 +132,7 @@ export const getProducts = async (skus: string[]): Promise<Product[]> => {
 
   return Platform.select({
     ios: async () => {
-      const rawItems = await ExpoIapModule.getItems(skus);
+      const rawItems = await ExpoIapModule.fetchProducts(skus);
       return rawItems.filter((item: unknown) => {
         if (!isProductIOS(item)) return false;
         return (
@@ -145,7 +145,7 @@ export const getProducts = async (skus: string[]): Promise<Product[]> => {
       }) as Product[];
     },
     android: async () => {
-      const products = await ExpoIapModule.getItemsByType('inapp', skus);
+      const products = await ExpoIapModule.fetchProducts('inapp', skus);
       return products.filter((product: unknown) =>
         isProductAndroid<Product>(product),
       );
@@ -158,7 +158,7 @@ export const getSubscriptions = async (
   skus: string[],
 ): Promise<SubscriptionProduct[]> => {
   console.warn(
-    "`getSubscriptions` is deprecated. Use `requestProducts({ skus, type: 'subs' })` instead. This function will be removed in version 3.0.0.",
+    "`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'));
@@ -166,7 +166,7 @@ export const getSubscriptions = async (
 
   return Platform.select({
     ios: async () => {
-      const rawItems = await ExpoIapModule.getItems(skus);
+      const rawItems = await ExpoIapModule.fetchProducts(skus);
       return rawItems.filter((item: unknown) => {
         if (!isProductIOS(item)) return false;
         return (
@@ -179,7 +179,7 @@ export const getSubscriptions = async (
       }) as SubscriptionProduct[];
     },
     android: async () => {
-      const rawItems = await ExpoIapModule.getItemsByType('subs', skus);
+      const rawItems = await ExpoIapModule.fetchProducts('subs', skus);
       return rawItems.filter((item: unknown) => {
         if (!isProductAndroid(item)) return false;
         return (
@@ -200,28 +200,28 @@ export async function endConnection(): Promise<boolean> {
 }
 
 /**
- * Request products with unified API (v2.7.0+)
+ * Fetch products with unified API (v2.7.0+)
  *
- * @param params - Product request configuration
+ * @param params - Product fetch configuration
  * @param params.skus - Array of product SKUs to fetch
  * @param params.type - Type of products: 'inapp' for regular products (default) or 'subs' for subscriptions
  *
  * @example
  * ```typescript
  * // Regular products
- * const products = await requestProducts({
+ * const products = await fetchProducts({
  *   skus: ['product1', 'product2'],
  *   type: 'inapp'
  * });
  *
  * // Subscriptions
- * const subscriptions = await requestProducts({
+ * const subscriptions = await fetchProducts({
  *   skus: ['sub1', 'sub2'],
  *   type: 'subs'
  * });
  * ```
  */
-export const requestProducts = async ({
+export const fetchProducts = async ({
   skus,
   type = 'inapp',
 }: {
@@ -233,7 +233,7 @@ export const requestProducts = async ({
   }
 
   if (Platform.OS === 'ios') {
-    const rawItems = await ExpoIapModule.getItems(skus);
+    const rawItems = await ExpoIapModule.fetchProducts(skus);
     const filteredItems = rawItems.filter((item: unknown) => {
       if (!isProductIOS(item)) return false;
       return (
@@ -251,7 +251,7 @@ export const requestProducts = async ({
   }
 
   if (Platform.OS === 'android') {
-    const items = await ExpoIapModule.getItemsByType(type, skus);
+    const items = await ExpoIapModule.fetchProducts(type, skus);
     const filteredItems = items.filter((item: unknown) => {
       if (!isProductAndroid(item)) return false;
       return (
@@ -271,38 +271,92 @@ export const requestProducts = async ({
   throw new Error('Unsupported platform');
 };
 
+/**
+ * @deprecated Use `fetchProducts` instead. This method will be removed in version 3.0.0.
+ *
+ * The 'request' prefix should only be used for event-based operations that trigger
+ * purchase flows. Since this function simply fetches product information, it has been
+ * renamed to `fetchProducts` to follow OpenIAP terminology guidelines.
+ *
+ * @example
+ * ```typescript
+ * // Old way (deprecated)
+ * const products = await requestProducts({
+ *   skus: ['com.example.product1'],
+ *   type: 'inapp'
+ * });
+ *
+ * // New way (recommended)
+ * const products = await fetchProducts({
+ *   skus: ['com.example.product1'],
+ *   type: 'inapp'
+ * });
+ * ```
+ */
+export const requestProducts = async ({
+  skus,
+  type = 'inapp',
+}: {
+  skus: string[];
+  type?: 'inapp' | 'subs';
+}): Promise<Product[] | SubscriptionProduct[]> => {
+  console.warn(
+    "`requestProducts` is deprecated. Use `fetchProducts` instead. The 'request' prefix should only be used for event-based operations. This method will be removed in version 3.0.0.",
+  );
+  return fetchProducts({skus, type});
+};
+
 /**
  * @deprecated Use `getPurchaseHistories` instead. This function will be removed in version 3.0.0.
  */
 export const getPurchaseHistory = ({
   alsoPublishToEventListener = false,
   onlyIncludeActiveItems = false,
+  alsoPublishToEventListenerIOS,
+  onlyIncludeActiveItemsIOS,
 }: {
+  /** @deprecated Use alsoPublishToEventListenerIOS instead */
   alsoPublishToEventListener?: boolean;
+  /** @deprecated Use onlyIncludeActiveItemsIOS instead */
   onlyIncludeActiveItems?: boolean;
+  alsoPublishToEventListenerIOS?: boolean;
+  onlyIncludeActiveItemsIOS?: boolean;
 } = {}): Promise<Purchase[]> => {
   console.warn(
     '`getPurchaseHistory` is deprecated. Use `getPurchaseHistories` instead. This function will be removed in version 3.0.0.',
   );
   return getPurchaseHistories({
-    alsoPublishToEventListener,
-    onlyIncludeActiveItems,
+    alsoPublishToEventListenerIOS:
+      alsoPublishToEventListenerIOS ?? alsoPublishToEventListener,
+    onlyIncludeActiveItemsIOS:
+      onlyIncludeActiveItemsIOS ?? onlyIncludeActiveItems,
   });
 };
 
+/**
+ * @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(
-          alsoPublishToEventListener,
-          onlyIncludeActiveItems,
+          alsoPublishToEventListenerIOS ?? alsoPublishToEventListener,
+          onlyIncludeActiveItemsIOS ?? onlyIncludeActiveItems,
         );
       },
       android: async () => {
@@ -319,16 +373,22 @@ export const getPurchaseHistories = ({
 export const getAvailablePurchases = ({
   alsoPublishToEventListener = false,
   onlyIncludeActiveItems = true,
+  alsoPublishToEventListenerIOS,
+  onlyIncludeActiveItemsIOS,
 }: {
+  /** @deprecated Use alsoPublishToEventListenerIOS instead */
   alsoPublishToEventListener?: boolean;
+  /** @deprecated Use onlyIncludeActiveItemsIOS instead */
   onlyIncludeActiveItems?: boolean;
+  alsoPublishToEventListenerIOS?: boolean;
+  onlyIncludeActiveItemsIOS?: boolean;
 } = {}): Promise<Purchase[]> =>
   (
     Platform.select({
       ios: () =>
         ExpoIapModule.getAvailableItems(
-          alsoPublishToEventListener,
-          onlyIncludeActiveItems,
+          alsoPublishToEventListenerIOS ?? alsoPublishToEventListener,
+          onlyIncludeActiveItemsIOS ?? onlyIncludeActiveItems,
         ),
       android: async () => {
         const products = await ExpoIapModule.getAvailableItemsByType('inapp');
@@ -430,7 +490,7 @@ export const requestPurchase = (
 
     return (async () => {
       const offer = offerToRecordIOS(withOffer);
-      const purchase = await ExpoIapModule.buyProduct(
+      const purchase = await ExpoIapModule.requestPurchase(
         sku,
         andDangerouslyFinishTransactionAutomatically,
         appAccountToken,
@@ -460,7 +520,7 @@ export const requestPurchase = (
       } = normalizedRequest;
 
       return (async () => {
-        return ExpoIapModule.buyItemByType({
+        return ExpoIapModule.requestPurchase({
           type: 'inapp',
           skuArr: skus,
           purchaseToken: undefined,
@@ -486,7 +546,7 @@ export const requestPurchase = (
       } = normalizedRequest;
 
       return (async () => {
-        return ExpoIapModule.buyItemByType({
+        return ExpoIapModule.requestPurchase({
           type: 'subs',
           skuArr: skus,
           purchaseToken: purchaseTokenAndroid || purchaseToken,
@@ -586,10 +646,10 @@ export const finishTransaction = ({
         }
 
         if (isConsumable) {
-          return ExpoIapModule.consumeProduct(token);
+          return ExpoIapModule.consumeProductAndroid(token);
         }
 
-        return ExpoIapModule.acknowledgePurchase(token);
+        return ExpoIapModule.acknowledgePurchaseAndroid(token);
       },
     }) || (() => Promise.reject(new Error('Unsupported Platform')))
   )();

package/src/modules/android.ts

@@ -113,7 +113,7 @@ export const acknowledgePurchaseAndroid = ({
 }: {
   token: string;
 }): Promise<PurchaseResult | boolean | void> => {
-  return ExpoIapModule.acknowledgePurchase(token);
+  return ExpoIapModule.acknowledgePurchaseAndroid(token);
 };
 
 /**

package/src/modules/ios.ts

@@ -5,7 +5,7 @@ import {purchaseUpdatedListener} from '..';
 import ExpoIapModule from '../ExpoIapModule';
 
 // Types
-import {Purchase, PurchaseError} from '../ExpoIap.types';
+import {Product, Purchase, PurchaseError} from '../ExpoIap.types';
 import type {
   ProductStatusIOS,
   AppTransactionIOS,
@@ -91,7 +91,7 @@ export function isProductIOS<T extends {platform?: string}>(
  * @platform iOS
  */
 export const syncIOS = (): Promise<null> => {
-  return ExpoIapModule.sync();
+  return ExpoIapModule.syncIOS();
 };
 
 /**
@@ -106,7 +106,7 @@ export const syncIOS = (): Promise<null> => {
 export const isEligibleForIntroOfferIOS = (
   groupId: string,
 ): Promise<boolean> => {
-  return ExpoIapModule.isEligibleForIntroOffer(groupId);
+  return ExpoIapModule.isEligibleForIntroOfferIOS(groupId);
 };
 
 /**
@@ -121,7 +121,7 @@ export const isEligibleForIntroOfferIOS = (
 export const subscriptionStatusIOS = (
   sku: string,
 ): Promise<ProductStatusIOS[]> => {
-  return ExpoIapModule.subscriptionStatus(sku);
+  return ExpoIapModule.subscriptionStatusIOS(sku);
 };
 
 /**
@@ -134,7 +134,7 @@ export const subscriptionStatusIOS = (
  * @platform iOS
  */
 export const currentEntitlementIOS = (sku: string): Promise<Purchase> => {
-  return ExpoIapModule.currentEntitlement(sku);
+  return ExpoIapModule.currentEntitlementIOS(sku);
 };
 
 /**
@@ -147,7 +147,7 @@ export const currentEntitlementIOS = (sku: string): Promise<Purchase> => {
  * @platform iOS
  */
 export const latestTransactionIOS = (sku: string): Promise<Purchase> => {
-  return ExpoIapModule.latestTransaction(sku);
+  return ExpoIapModule.latestTransactionIOS(sku);
 };
 
 /**
@@ -163,7 +163,7 @@ type RefundRequestStatus = 'success' | 'userCancelled';
 export const beginRefundRequestIOS = (
   sku: string,
 ): Promise<RefundRequestStatus> => {
-  return ExpoIapModule.beginRefundRequest(sku);
+  return ExpoIapModule.beginRefundRequestIOS(sku);
 };
 
 /**
@@ -177,7 +177,7 @@ export const beginRefundRequestIOS = (
  * @platform iOS
  */
 export const showManageSubscriptionsIOS = (): Promise<null> => {
-  return ExpoIapModule.showManageSubscriptions();
+  return ExpoIapModule.showManageSubscriptionsIOS();
 };
 
 /**
@@ -191,7 +191,7 @@ export const showManageSubscriptionsIOS = (): Promise<null> => {
  * @returns {Promise<string>} Base64 encoded receipt data
  */
 export const getReceiptIOS = (): Promise<string> => {
-  return ExpoIapModule.getReceiptData();
+  return ExpoIapModule.getReceiptDataIOS();
 };
 
 /**
@@ -205,7 +205,7 @@ export const getReceiptIOS = (): Promise<string> => {
  * @platform iOS
  */
 export const isTransactionVerifiedIOS = (sku: string): Promise<boolean> => {
-  return ExpoIapModule.isTransactionVerified(sku);
+  return ExpoIapModule.isTransactionVerifiedIOS(sku);
 };
 
 /**
@@ -219,7 +219,7 @@ export const isTransactionVerifiedIOS = (sku: string): Promise<boolean> => {
  * @platform iOS
  */
 export const getTransactionJwsIOS = (sku: string): Promise<string> => {
-  return ExpoIapModule.getTransactionJws(sku);
+  return ExpoIapModule.getTransactionJwsIOS(sku);
 };
 
 /**
@@ -261,7 +261,7 @@ export const validateReceiptIOS = async (
  * @platform iOS
  */
 export const presentCodeRedemptionSheetIOS = (): Promise<boolean> => {
-  return ExpoIapModule.presentCodeRedemptionSheet();
+  return ExpoIapModule.presentCodeRedemptionSheetIOS();
 };
 
 /**
@@ -279,20 +279,21 @@ export const presentCodeRedemptionSheetIOS = (): Promise<boolean> => {
  * @since iOS 16.0
  */
 export const getAppTransactionIOS = (): Promise<AppTransactionIOS | null> => {
-  return ExpoIapModule.getAppTransaction();
+  return ExpoIapModule.getAppTransactionIOS();
 };
 
 /**
- * Get the promoted product details (iOS only).
+ * Get information about a promoted product if one is available (iOS only).
+ * Promoted products are products that the App Store promotes on your behalf.
  * This is called after a promoted product event is received from the App Store.
  *
- * @returns Promise resolving to the promoted product details or null if none available
+ * @returns Promise resolving to the promoted product information or null if none available
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
  */
-export const getPromotedProductIOS = (): Promise<any | null> => {
-  return ExpoIapModule.getPromotedProduct();
+export const getPromotedProductIOS = (): Promise<Product | null> => {
+  return ExpoIapModule.getPromotedProductIOS();
 };
 
 /**
@@ -304,8 +305,35 @@ export const getPromotedProductIOS = (): Promise<any | null> => {
  *
  * @platform iOS
  */
+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 ExpoIapModule.buyPromotedProduct();
+  return requestPurchaseOnPromotedProductIOS();
+};
+
+/**
+ * Get pending transactions that haven't been finished yet (iOS only).
+ *
+ * @returns Promise resolving to array of pending transactions
+ * @platform iOS
+ */
+export const getPendingTransactionsIOS = (): Promise<any[]> => {
+  return ExpoIapModule.getPendingTransactionsIOS();
+};
+
+/**
+ * Clear a specific transaction (iOS only).
+ *
+ * @returns Promise resolving when transaction is cleared
+ * @platform iOS
+ */
+export const clearTransactionIOS = (): Promise<void> => {
+  return ExpoIapModule.clearTransactionIOS();
 };
 
 /**

package/src/useIAP.ts

@@ -14,7 +14,7 @@ import {
   getPurchaseHistories,
   finishTransaction as finishTransactionInternal,
   requestPurchase as requestPurchaseInternal,
-  requestProducts,
+  fetchProducts,
   validateReceipt as validateReceiptInternal,
   getActiveSubscriptions,
   hasActiveSubscriptions,
@@ -23,7 +23,7 @@ import {
 import {
   syncIOS,
   getPromotedProductIOS,
-  buyPromotedProductIOS,
+  requestPurchaseOnPromotedProductIOS,
 } from './modules/ios';
 
 // Types
@@ -60,18 +60,26 @@ type UseIap = {
   }) => Promise<PurchaseResult | boolean>;
   getAvailablePurchases: (skus: string[]) => Promise<void>;
   getPurchaseHistories: (skus: string[]) => Promise<void>;
+  fetchProducts: (params: {
+    skus: string[];
+    type?: 'inapp' | 'subs';
+  }) => Promise<void>;
+  /**
+   * @deprecated Use fetchProducts({ skus, type: 'inapp' | 'subs' }) instead. This method will be removed in version 3.0.0.
+   * The 'request' prefix should only be used for event-based operations.
+   */
   requestProducts: (params: {
     skus: string[];
     type?: 'inapp' | 'subs';
   }) => Promise<void>;
   /**
-   * @deprecated Use requestProducts({ skus, type: 'inapp' }) instead. This method will be removed in version 3.0.0.
-   * Note: This method internally uses requestProducts, so no deprecation warning is shown.
+   * @deprecated Use fetchProducts({ skus, type: 'inapp' }) instead. This method will be removed in version 3.0.0.
+   * Note: This method internally uses fetchProducts, so no deprecation warning is shown.
    */
   getProducts: (skus: string[]) => Promise<void>;
   /**
-   * @deprecated Use requestProducts({ skus, type: 'subs' }) instead. This method will be removed in version 3.0.0.
-   * Note: This method internally uses requestProducts, so no deprecation warning is shown.
+   * @deprecated Use fetchProducts({ skus, type: 'subs' }) instead. This method will be removed in version 3.0.0.
+   * Note: This method internally uses fetchProducts, so no deprecation warning is shown.
    */
   getSubscriptions: (skus: string[]) => Promise<void>;
   requestPurchase: (params: {
@@ -87,8 +95,10 @@ type UseIap = {
       isSub?: boolean;
     },
   ) => Promise<any>;
-  restorePurchases: () => Promise<void>; // 구매 복원 함수 추가
-  getPromotedProductIOS: () => Promise<any | null>;
+  restorePurchases: () => Promise<void>;
+  getPromotedProductIOS: () => Promise<Product | null>;
+  requestPurchaseOnPromotedProductIOS: () => Promise<void>;
+  /** @deprecated Use requestPurchaseOnPromotedProductIOS instead */
   buyPromotedProductIOS: () => Promise<void>;
   getActiveSubscriptions: (
     subscriptionIds?: string[],
@@ -175,7 +185,7 @@ export function useIAP(options?: UseIAPOptions): UseIap {
   const getProductsInternal = useCallback(
     async (skus: string[]): Promise<void> => {
       try {
-        const result = await requestProducts({skus, type: 'inapp'});
+        const result = await fetchProducts({skus, type: 'inapp'});
         setProducts((prevProducts) =>
           mergeWithDuplicateCheck(
             prevProducts,
@@ -193,7 +203,7 @@ export function useIAP(options?: UseIAPOptions): UseIap {
   const getSubscriptionsInternal = useCallback(
     async (skus: string[]): Promise<void> => {
       try {
-        const result = await requestProducts({skus, type: 'subs'});
+        const result = await fetchProducts({skus, type: 'subs'});
         setSubscriptions((prevSubscriptions) =>
           mergeWithDuplicateCheck(
             prevSubscriptions,
@@ -208,13 +218,13 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     [mergeWithDuplicateCheck],
   );
 
-  const requestProductsInternal = useCallback(
+  const fetchProductsInternal = useCallback(
     async (params: {
       skus: string[];
       type?: 'inapp' | 'subs';
     }): Promise<void> => {
       try {
-        const result = await requestProducts(params);
+        const result = await fetchProducts(params);
         if (params.type === 'subs') {
           setSubscriptions((prevSubscriptions) =>
             mergeWithDuplicateCheck(
@@ -239,6 +249,19 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     [mergeWithDuplicateCheck],
   );
 
+  const requestProductsInternal = useCallback(
+    async (params: {
+      skus: string[];
+      type?: 'inapp' | 'subs';
+    }): Promise<void> => {
+      console.warn(
+        "`requestProducts` is deprecated in useIAP hook. Use the new `fetchProducts` method instead. The 'request' prefix should only be used for event-based operations.",
+      );
+      return fetchProductsInternal(params);
+    },
+    [fetchProductsInternal],
+  );
+
   const getAvailablePurchasesInternal = useCallback(async (): Promise<void> => {
     try {
       const result = await getAvailablePurchases();
@@ -276,6 +299,10 @@ 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());
   }, []);
@@ -448,6 +475,7 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     clearCurrentPurchaseError,
     getAvailablePurchases: getAvailablePurchasesInternal,
     getPurchaseHistories: getPurchaseHistoriesInternal,
+    fetchProducts: fetchProductsInternal,
     requestProducts: requestProductsInternal,
     requestPurchase: requestPurchaseWithReset,
     validateReceipt,
@@ -455,7 +483,8 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     getProducts: getProductsInternal,
     getSubscriptions: getSubscriptionsInternal,
     getPromotedProductIOS,
-    buyPromotedProductIOS,
+    requestPurchaseOnPromotedProductIOS,
+    buyPromotedProductIOS: requestPurchaseOnPromotedProductIOS, // deprecated alias
     getActiveSubscriptions: getActiveSubscriptionsInternal,
     hasActiveSubscriptions: hasActiveSubscriptionsInternal,
   };