expo-iap 2.7.4 → 2.7.5-rc.1

package/src/modules/ios.ts

@@ -11,10 +11,7 @@ import {
   Purchase,
   SubscriptionPurchase,
 } from '../ExpoIap.types';
-import type {
-  ProductStatusIos,
-  AppTransactionIOS,
-} from '../types/ExpoIapIos.types';
+import type {ProductStatusIos, AppTransactionIOS} from '../types/ExpoIapIos.types';
 
 export type TransactionEvent = {
   transaction?: ProductPurchase;
@@ -38,6 +35,7 @@ export type TransactionEvent = {
 export const transactionUpdatedIos = (
   listener: (event: TransactionEvent) => void,
 ) => {
+
   const isProductPurchase = (item: unknown): item is ProductPurchase => {
     return (
       item != null &&
@@ -88,10 +86,10 @@ export function isProductIos<T extends {platform?: string}>(
 /**
  * Sync state with Appstore (iOS only)
  * https://developer.apple.com/documentation/storekit/appstore/3791906-sync
- *
+ * 
  * @returns Promise resolving to null on success
  * @throws Error if called on non-iOS platform
- *
+ * 
  * @platform iOS
  */
 export const syncIOS = (): Promise<null> => {
@@ -100,56 +98,50 @@ export const syncIOS = (): Promise<null> => {
 
 /**
  * Check if user is eligible for introductory offer
- *
+ * 
  * @param groupID The subscription group ID
  * @returns Promise resolving to true if eligible
  * @throws Error if called on non-iOS platform
- *
+ * 
  * @platform iOS
  */
-export const isEligibleForIntroOfferIOS = (
-  groupID: string,
-): Promise<boolean> => {
+export const isEligibleForIntroOfferIOS = (groupID: string): Promise<boolean> => {
   return ExpoIapModule.isEligibleForIntroOffer(groupID);
 };
 
 /**
  * Get subscription status for a specific SKU
- *
+ * 
  * @param sku The product SKU
  * @returns Promise resolving to array of subscription status
  * @throws Error if called on non-iOS platform
- *
+ * 
  * @platform iOS
  */
-export const subscriptionStatusIOS = (
-  sku: string,
-): Promise<ProductStatusIos[]> => {
+export const subscriptionStatusIOS = (sku: string): Promise<ProductStatusIos[]> => {
   return ExpoIapModule.subscriptionStatus(sku);
 };
 
 /**
  * Get current entitlement for a specific SKU
- *
+ * 
  * @param sku The product SKU
  * @returns Promise resolving to current entitlement
  * @throws Error if called on non-iOS platform
- *
+ * 
  * @platform iOS
  */
-export const currentEntitlementIOS = (
-  sku: string,
-): Promise<ProductPurchase> => {
+export const currentEntitlementIOS = (sku: string): Promise<ProductPurchase> => {
   return ExpoIapModule.currentEntitlement(sku);
 };
 
 /**
  * Get latest transaction for a specific SKU
- *
+ * 
  * @param sku The product SKU
  * @returns Promise resolving to latest transaction
  * @throws Error if called on non-iOS platform
- *
+ * 
  * @platform iOS
  */
 export const latestTransactionIOS = (sku: string): Promise<ProductPurchase> => {
@@ -158,17 +150,15 @@ export const latestTransactionIOS = (sku: string): Promise<ProductPurchase> => {
 
 /**
  * Begin refund request for a specific SKU
- *
+ * 
  * @param sku The product SKU
  * @returns Promise resolving to refund request status
  * @throws Error if called on non-iOS platform
- *
+ * 
  * @platform iOS
  */
 type RefundRequestStatus = 'success' | 'userCancelled';
-export const beginRefundRequestIOS = (
-  sku: string,
-): Promise<RefundRequestStatus> => {
+export const beginRefundRequestIOS = (sku: string): Promise<RefundRequestStatus> => {
   return ExpoIapModule.beginRefundRequest(sku);
 };
 
@@ -176,10 +166,10 @@ export const beginRefundRequestIOS = (
  * Shows the system UI for managing subscriptions.
  * When the user changes subscription renewal status, the system will emit events to
  * purchaseUpdatedListener and transactionUpdatedIos listeners.
- *
+ * 
  * @returns Promise resolving to null on success
  * @throws Error if called on non-iOS platform
- *
+ * 
  * @platform iOS
  */
 export const showManageSubscriptionsIOS = (): Promise<null> => {
@@ -207,7 +197,7 @@ export const getReceiptIOS = (): Promise<string> => {
  * @param sku The product's SKU (on iOS)
  * @returns Promise resolving to true if the transaction is verified
  * @throws Error if called on non-iOS platform
- *
+ * 
  * @platform iOS
  */
 export const isTransactionVerifiedIOS = (sku: string): Promise<boolean> => {
@@ -221,7 +211,7 @@ export const isTransactionVerifiedIOS = (sku: string): Promise<boolean> => {
  * @param sku The product's SKU (on iOS)
  * @returns Promise resolving to JWS representation of the transaction
  * @throws Error if called on non-iOS platform
- *
+ * 
  * @platform iOS
  */
 export const getTransactionJwsIOS = (sku: string): Promise<string> => {
@@ -258,12 +248,12 @@ export const validateReceiptIOS = async (
 /**
  * Present the code redemption sheet for offer codes (iOS only).
  * This allows users to redeem promotional codes for in-app purchases and subscriptions.
- *
+ * 
  * Note: This only works on real devices, not simulators.
- *
+ * 
  * @returns Promise resolving to true if the sheet was presented successfully
  * @throws Error if called on non-iOS platform or tvOS
- *
+ * 
  * @platform iOS
  */
 export const presentCodeRedemptionSheetIOS = (): Promise<boolean> => {
@@ -273,14 +263,14 @@ export const presentCodeRedemptionSheetIOS = (): Promise<boolean> => {
 /**
  * Get app transaction information (iOS 16.0+).
  * AppTransaction represents the initial purchase that unlocked the app.
- *
+ * 
  * NOTE: This function requires:
  * - iOS 16.0 or later at runtime
  * - Xcode 15.0+ with iOS 16.0 SDK for compilation
- *
+ * 
  * @returns Promise resolving to the app transaction information or null if not available
  * @throws Error if called on non-iOS platform, iOS version < 16.0, or compiled with older SDK
- *
+ * 
  * @platform iOS
  * @since iOS 16.0
  */
@@ -288,6 +278,32 @@ export const getAppTransactionIOS = (): Promise<AppTransactionIOS | null> => {
   return ExpoIapModule.getAppTransaction();
 };
 
+/**
+ * Get the promoted product details (iOS only).
+ * 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
+ * @throws Error if called on non-iOS platform
+ * 
+ * @platform iOS
+ */
+export const getPromotedProductIOS = (): Promise<any | null> => {
+  return ExpoIapModule.getPromotedProduct();
+};
+
+/**
+ * Complete the purchase of a promoted product (iOS only).
+ * This should be called after showing your purchase UI for a promoted product.
+ * 
+ * @returns Promise resolving when the purchase is initiated
+ * @throws Error if called on non-iOS platform or no promoted product is available
+ * 
+ * @platform iOS
+ */
+export const buyPromotedProductIOS = (): Promise<void> => {
+  return ExpoIapModule.buyPromotedProduct();
+};
+
 // ============= DEPRECATED FUNCTIONS =============
 // These will be removed in version 3.0.0
 
@@ -295,9 +311,7 @@ export const getAppTransactionIOS = (): Promise<AppTransactionIOS | null> => {
  * @deprecated Use `syncIOS` instead. This function will be removed in version 3.0.0.
  */
 export const sync = (): Promise<null> => {
-  console.warn(
-    '`sync` is deprecated. Use `syncIOS` instead. This function will be removed in version 3.0.0.',
-  );
+  console.warn('`sync` is deprecated. Use `syncIOS` instead. This function will be removed in version 3.0.0.');
   return syncIOS();
 };
 
@@ -305,21 +319,15 @@ export const sync = (): Promise<null> => {
  * @deprecated Use `isEligibleForIntroOfferIOS` instead. This function will be removed in version 3.0.0.
  */
 export const isEligibleForIntroOffer = (groupID: string): Promise<boolean> => {
-  console.warn(
-    '`isEligibleForIntroOffer` is deprecated. Use `isEligibleForIntroOfferIOS` instead. This function will be removed in version 3.0.0.',
-  );
+  console.warn('`isEligibleForIntroOffer` is deprecated. Use `isEligibleForIntroOfferIOS` instead. This function will be removed in version 3.0.0.');
   return isEligibleForIntroOfferIOS(groupID);
 };
 
 /**
  * @deprecated Use `subscriptionStatusIOS` instead. This function will be removed in version 3.0.0.
  */
-export const subscriptionStatus = (
-  sku: string,
-): Promise<ProductStatusIos[]> => {
-  console.warn(
-    '`subscriptionStatus` is deprecated. Use `subscriptionStatusIOS` instead. This function will be removed in version 3.0.0.',
-  );
+export const subscriptionStatus = (sku: string): Promise<ProductStatusIos[]> => {
+  console.warn('`subscriptionStatus` is deprecated. Use `subscriptionStatusIOS` instead. This function will be removed in version 3.0.0.');
   return subscriptionStatusIOS(sku);
 };
 
@@ -327,9 +335,7 @@ export const subscriptionStatus = (
  * @deprecated Use `currentEntitlementIOS` instead. This function will be removed in version 3.0.0.
  */
 export const currentEntitlement = (sku: string): Promise<ProductPurchase> => {
-  console.warn(
-    '`currentEntitlement` is deprecated. Use `currentEntitlementIOS` instead. This function will be removed in version 3.0.0.',
-  );
+  console.warn('`currentEntitlement` is deprecated. Use `currentEntitlementIOS` instead. This function will be removed in version 3.0.0.');
   return currentEntitlementIOS(sku);
 };
 
@@ -337,21 +343,15 @@ export const currentEntitlement = (sku: string): Promise<ProductPurchase> => {
  * @deprecated Use `latestTransactionIOS` instead. This function will be removed in version 3.0.0.
  */
 export const latestTransaction = (sku: string): Promise<ProductPurchase> => {
-  console.warn(
-    '`latestTransaction` is deprecated. Use `latestTransactionIOS` instead. This function will be removed in version 3.0.0.',
-  );
+  console.warn('`latestTransaction` is deprecated. Use `latestTransactionIOS` instead. This function will be removed in version 3.0.0.');
   return latestTransactionIOS(sku);
 };
 
 /**
  * @deprecated Use `beginRefundRequestIOS` instead. This function will be removed in version 3.0.0.
  */
-export const beginRefundRequest = (
-  sku: string,
-): Promise<RefundRequestStatus> => {
-  console.warn(
-    '`beginRefundRequest` is deprecated. Use `beginRefundRequestIOS` instead. This function will be removed in version 3.0.0.',
-  );
+export const beginRefundRequest = (sku: string): Promise<RefundRequestStatus> => {
+  console.warn('`beginRefundRequest` is deprecated. Use `beginRefundRequestIOS` instead. This function will be removed in version 3.0.0.');
   return beginRefundRequestIOS(sku);
 };
 
@@ -359,9 +359,7 @@ export const beginRefundRequest = (
  * @deprecated Use `showManageSubscriptionsIOS` instead. This function will be removed in version 3.0.0.
  */
 export const showManageSubscriptions = (): Promise<null> => {
-  console.warn(
-    '`showManageSubscriptions` is deprecated. Use `showManageSubscriptionsIOS` instead. This function will be removed in version 3.0.0.',
-  );
+  console.warn('`showManageSubscriptions` is deprecated. Use `showManageSubscriptionsIOS` instead. This function will be removed in version 3.0.0.');
   return showManageSubscriptionsIOS();
 };
 
@@ -369,9 +367,7 @@ export const showManageSubscriptions = (): Promise<null> => {
  * @deprecated Use `getReceiptIOS` instead. This function will be removed in version 3.0.0.
  */
 export const getReceiptIos = (): Promise<string> => {
-  console.warn(
-    '`getReceiptIos` is deprecated. Use `getReceiptIOS` instead. This function will be removed in version 3.0.0.',
-  );
+  console.warn('`getReceiptIos` is deprecated. Use `getReceiptIOS` instead. This function will be removed in version 3.0.0.');
   return getReceiptIOS();
 };
 
@@ -379,9 +375,7 @@ export const getReceiptIos = (): Promise<string> => {
  * @deprecated Use `isTransactionVerifiedIOS` instead. This function will be removed in version 3.0.0.
  */
 export const isTransactionVerified = (sku: string): Promise<boolean> => {
-  console.warn(
-    '`isTransactionVerified` is deprecated. Use `isTransactionVerifiedIOS` instead. This function will be removed in version 3.0.0.',
-  );
+  console.warn('`isTransactionVerified` is deprecated. Use `isTransactionVerifiedIOS` instead. This function will be removed in version 3.0.0.');
   return isTransactionVerifiedIOS(sku);
 };
 
@@ -389,9 +383,7 @@ export const isTransactionVerified = (sku: string): Promise<boolean> => {
  * @deprecated Use `getTransactionJwsIOS` instead. This function will be removed in version 3.0.0.
  */
 export const getTransactionJws = (sku: string): Promise<string> => {
-  console.warn(
-    '`getTransactionJws` is deprecated. Use `getTransactionJwsIOS` instead. This function will be removed in version 3.0.0.',
-  );
+  console.warn('`getTransactionJws` is deprecated. Use `getTransactionJwsIOS` instead. This function will be removed in version 3.0.0.');
   return getTransactionJwsIOS(sku);
 };
 
@@ -406,9 +398,7 @@ export const validateReceiptIos = async (
   jwsRepresentation: string;
   latestTransaction?: ProductPurchase;
 }> => {
-  console.warn(
-    '`validateReceiptIos` is deprecated. Use `validateReceiptIOS` instead. This function will be removed in version 3.0.0.',
-  );
+  console.warn('`validateReceiptIos` is deprecated. Use `validateReceiptIOS` instead. This function will be removed in version 3.0.0.');
   return validateReceiptIOS(sku);
 };
 
@@ -416,9 +406,7 @@ export const validateReceiptIos = async (
  * @deprecated Use `presentCodeRedemptionSheetIOS` instead. This function will be removed in version 3.0.0.
  */
 export const presentCodeRedemptionSheet = (): Promise<boolean> => {
-  console.warn(
-    '`presentCodeRedemptionSheet` is deprecated. Use `presentCodeRedemptionSheetIOS` instead. This function will be removed in version 3.0.0.',
-  );
+  console.warn('`presentCodeRedemptionSheet` is deprecated. Use `presentCodeRedemptionSheetIOS` instead. This function will be removed in version 3.0.0.');
   return presentCodeRedemptionSheetIOS();
 };
 
@@ -426,8 +414,6 @@ export const presentCodeRedemptionSheet = (): Promise<boolean> => {
  * @deprecated Use `getAppTransactionIOS` instead. This function will be removed in version 3.0.0.
  */
 export const getAppTransaction = (): Promise<AppTransactionIOS | null> => {
-  console.warn(
-    '`getAppTransaction` is deprecated. Use `getAppTransactionIOS` instead. This function will be removed in version 3.0.0.',
-  );
+  console.warn('`getAppTransaction` is deprecated. Use `getAppTransactionIOS` instead. This function will be removed in version 3.0.0.');
   return getAppTransactionIOS();
 };

package/src/useIap.ts

@@ -9,6 +9,7 @@ import {
   initConnection,
   purchaseErrorListener,
   purchaseUpdatedListener,
+  promotedProductListenerIOS,
   getProducts,
   getAvailablePurchases,
   getPurchaseHistories,
@@ -17,7 +18,12 @@ import {
   requestPurchase as requestPurchaseInternal,
   requestProducts,
 } from './';
-import {syncIOS, validateReceiptIOS} from './modules/ios';
+import {
+  syncIOS,
+  validateReceiptIOS,
+  getPromotedProductIOS,
+  buyPromotedProductIOS,
+} from './modules/ios';
 import {validateReceiptAndroid} from './modules/android';
 
 // Types
@@ -36,12 +42,12 @@ import {
 type UseIap = {
   connected: boolean;
   products: Product[];
-  promotedProductsIOS: ProductPurchase[];
   subscriptions: SubscriptionProduct[];
   purchaseHistories: ProductPurchase[];
   availablePurchases: ProductPurchase[];
   currentPurchase?: ProductPurchase;
   currentPurchaseError?: PurchaseError;
+  promotedProductIOS?: Product;
   clearCurrentPurchase: () => void;
   clearCurrentPurchaseError: () => void;
   finishTransaction: ({
@@ -73,6 +79,8 @@ type UseIap = {
     },
   ) => Promise<any>;
   restorePurchases: () => Promise<void>; // 구매 복원 함수 추가
+  getPromotedProductIOS: () => Promise<any | null>;
+  buyPromotedProductIOS: () => Promise<void>;
 };
 
 export interface UseIAPOptions {
@@ -82,14 +90,12 @@ export interface UseIAPOptions {
   onPurchaseError?: (error: PurchaseError) => void;
   onSyncError?: (error: Error) => void;
   shouldAutoSyncPurchases?: boolean; // New option to control auto-syncing
+  onPromotedProductIOS?: (product: Product) => void;
 }
 
 export function useIAP(options?: UseIAPOptions): UseIap {
   const [connected, setConnected] = useState<boolean>(false);
   const [products, setProducts] = useState<Product[]>([]);
-  const [promotedProductsIOS, setPromotedProductsIOS] = useState<
-    ProductPurchase[]
-  >([]);
   const [subscriptions, setSubscriptions] = useState<SubscriptionProduct[]>([]);
   const [purchaseHistories, setPurchaseHistories] = useState<ProductPurchase[]>(
     [],
@@ -98,6 +104,7 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     ProductPurchase[]
   >([]);
   const [currentPurchase, setCurrentPurchase] = useState<ProductPurchase>();
+  const [promotedProductIOS, setPromotedProductIOS] = useState<Product>();
   const [currentPurchaseError, setCurrentPurchaseError] =
     useState<PurchaseError>();
 
@@ -374,27 +381,18 @@ export function useIAP(options?: UseIAPOptions): UseIap {
       );
 
       if (Platform.OS === 'ios') {
-        // iOS promoted products are handled through regular purchase updates
-        subscriptionsRef.current.promotedProductsIos = purchaseUpdatedListener(
-          async (purchase: Purchase | SubscriptionPurchase) => {
-            // Add to promoted products if it's a promoted transaction (avoid duplicates)
-            setPromotedProductsIOS((prevProducts) =>
-              mergeWithDuplicateCheck(
-                prevProducts,
-                [purchase as ProductPurchase],
-                (product) => product.transactionId || product.id,
-              ),
-            );
-
-            // Refresh subscription status if it's a subscription purchase
-            if ('expirationDateIos' in purchase) {
-              await refreshSubscriptionStatus(purchase.id);
+        // iOS promoted products listener
+        subscriptionsRef.current.promotedProductsIos =
+          promotedProductListenerIOS((product: Product) => {
+            setPromotedProductIOS(product);
+
+            if (optionsRef.current?.onPromotedProductIOS) {
+              optionsRef.current.onPromotedProductIOS(product);
             }
-          },
-        );
+          });
       }
     }
-  }, [refreshSubscriptionStatus, mergeWithDuplicateCheck]);
+  }, [refreshSubscriptionStatus]);
 
   useEffect(() => {
     initIapWithSubscriptions();
@@ -412,13 +410,13 @@ export function useIAP(options?: UseIAPOptions): UseIap {
   return {
     connected,
     products,
-    promotedProductsIOS,
     subscriptions,
     purchaseHistories,
     finishTransaction,
     availablePurchases,
     currentPurchase,
     currentPurchaseError,
+    promotedProductIOS,
     clearCurrentPurchase,
     clearCurrentPurchaseError,
     getAvailablePurchases: getAvailablePurchasesInternal,
@@ -429,5 +427,9 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     requestPurchase: requestPurchaseWithReset,
     validateReceipt,
     restorePurchases,
+    getPromotedProductIOS:
+      Platform.OS === 'ios' ? getPromotedProductIOS : async () => null,
+    buyPromotedProductIOS:
+      Platform.OS === 'ios' ? buyPromotedProductIOS : async () => {},
   };
 }

package/build/utils/smartPurchase.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=smartPurchase.d.ts.map

package/build/utils/smartPurchase.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"smartPurchase.d.ts","sourceRoot":"","sources":["../../src/utils/smartPurchase.ts"],"names":[],"mappings":""}

package/build/utils/smartPurchase.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=smartPurchase.js.map

package/build/utils/smartPurchase.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"smartPurchase.js","sourceRoot":"","sources":["../../src/utils/smartPurchase.ts"],"names":[],"mappings":"","sourcesContent":[""]}