expo-iap 2.7.4 → 2.7.5-rc.1

package/ios/ExpoIapModule.swift

@@ -18,6 +18,7 @@ func logDebug(_ message: String) {
 struct IapEvent {
     static let PurchaseUpdated = "purchase-updated"
     static let PurchaseError = "purchase-error"
+    static let PromotedProductIOS = "promoted-product-ios"
 }
 
 @available(iOS 15.0, *)
@@ -225,6 +226,9 @@ public class ExpoIapModule: Module {
     private var updateListenerTask: Task<Void, Error>?
     private var subscriptionPollingTask: Task<Void, Error>?
     private var pollingSkus: Set<String> = []
+    private var paymentObserver: PaymentObserver?
+    private var promotedPayment: SKPayment?
+    private var promotedProduct: SKProduct?
 
     public func definition() -> ModuleDefinition {
         Name("ExpoIap")
@@ -247,6 +251,13 @@ public class ExpoIapModule: Module {
 
         Function("initConnection") { () -> Bool in
             self.productStore = ProductStore()
+            
+            // Set up PaymentObserver for promoted products
+            if self.paymentObserver == nil {
+                self.paymentObserver = PaymentObserver(module: self)
+                SKPaymentQueue.default().add(self.paymentObserver!)
+            }
+            
             return AppStore.canMakePayments
         }
 
@@ -303,6 +314,42 @@ public class ExpoIapModule: Module {
                 )
             }
         }
+        
+        AsyncFunction("getPromotedProduct") { () -> [String: Any?]? in
+            guard let product = self.promotedProduct else {
+                return nil
+            }
+            
+            // Convert SKProduct to dictionary
+            return [
+                "productIdentifier": product.productIdentifier,
+                "localizedTitle": product.localizedTitle,
+                "localizedDescription": product.localizedDescription,
+                "price": product.price.doubleValue,
+                "priceLocale": [
+                    "currencyCode": product.priceLocale.currencyCode ?? "",
+                    "currencySymbol": product.priceLocale.currencySymbol ?? "",
+                    "countryCode": product.priceLocale.regionCode ?? ""
+                ]
+            ]
+        }
+        
+        AsyncFunction("buyPromotedProduct") { () -> Void in
+            guard let payment = self.promotedPayment else {
+                throw Exception(
+                    name: "ExpoIapModule",
+                    description: "No promoted product available",
+                    code: IapErrorCode.itemUnavailable
+                )
+            }
+            
+            // Add the deferred payment to the queue
+            SKPaymentQueue.default().add(payment)
+            
+            // Clear the promoted product data
+            self.promotedPayment = nil
+            self.promotedProduct = nil
+        }
 
         AsyncFunction("getItems") { (skus: [String]) -> [[String: Any?]?] in
             guard let productStore = self.productStore else {
@@ -335,6 +382,13 @@ public class ExpoIapModule: Module {
             self.transactions.removeAll()
             self.productStore = nil
             self.removeTransactionObserver()
+            
+            // Remove PaymentObserver
+            if let observer = self.paymentObserver {
+                SKPaymentQueue.default().remove(observer)
+                self.paymentObserver = nil
+            }
+            
             return true
         }
 
@@ -921,4 +975,47 @@ public class ExpoIapModule: Module {
             throw Exception(name: "ExpoIapModule", description: "App Store receipt not found", code: IapErrorCode.receiptFailed)
         }
     }
+    
+    // Called by PaymentObserver when a promoted product is received
+    func handlePromotedProduct(payment: SKPayment, product: SKProduct) {
+        self.promotedPayment = payment
+        self.promotedProduct = product
+        
+        if hasListeners {
+            let productData: [String: Any] = [
+                "productIdentifier": product.productIdentifier,
+                "localizedTitle": product.localizedTitle,
+                "localizedDescription": product.localizedDescription,
+                "price": product.price.doubleValue,
+                "priceLocale": [
+                    "currencyCode": product.priceLocale.currencyCode ?? "",
+                    "currencySymbol": product.priceLocale.currencySymbol ?? "",
+                    "countryCode": product.priceLocale.regionCode ?? ""
+                ]
+            ]
+            sendEvent(IapEvent.PromotedProductIOS, productData)
+        }
+    }
+}
+
+// PaymentObserver for handling promoted products
+@available(iOS 15.0, *)
+class PaymentObserver: NSObject, SKPaymentTransactionObserver {
+    weak var module: ExpoIapModule?
+    
+    init(module: ExpoIapModule) {
+        self.module = module
+    }
+    
+    // Required by SKPaymentTransactionObserver protocol but not used
+    func paymentQueue(_ queue: SKPaymentQueue, updatedTransactions transactions: [SKPaymentTransaction]) {
+        // We don't handle transactions here as StoreKit 2 handles them in ExpoIapModule
+    }
+    
+    // Handle promoted products from App Store
+    func paymentQueue(_ queue: SKPaymentQueue, shouldAddStorePayment payment: SKPayment, for product: SKProduct) -> Bool {
+        module?.handlePromotedProduct(payment: payment, product: product)
+        // Return false to defer the payment
+        return false
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-iap",
-  "version": "2.7.4",
+  "version": "2.7.5-rc.1",
   "description": "In App Purchase module in Expo",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/plugin/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/withIAP.ts"],"version":"5.8.3"}
+{"root":["./src/withiap.ts"],"version":"5.8.3"}

package/src/ExpoIap.types.ts

@@ -365,8 +365,7 @@ export interface AndroidRequestPurchaseProps {
 /**
  * Android-specific subscription request parameters
  */
-export interface AndroidRequestSubscriptionProps
-  extends AndroidRequestPurchaseProps {
+export interface AndroidRequestSubscriptionProps extends AndroidRequestPurchaseProps {
   readonly purchaseTokenAndroid?: string;
   readonly replacementModeAndroid?: number;
   readonly subscriptionOffers: {
@@ -409,36 +408,28 @@ export type RequestSubscriptionProps = PlatformRequestSubscriptionProps;
  * Includes both unified and old platform-specific formats
  * @deprecated Use RequestPurchaseProps with platform-specific structure instead
  */
-export type LegacyRequestPurchasePropsAll =
-  | UnifiedRequestPurchaseProps
-  | LegacyRequestPurchaseProps;
+export type LegacyRequestPurchasePropsAll = UnifiedRequestPurchaseProps | LegacyRequestPurchaseProps;
 
 /**
  * Legacy request subscription parameters (deprecated)
  * Includes both unified and old platform-specific formats
  * @deprecated Use RequestSubscriptionProps with platform-specific structure instead
  */
-export type LegacyRequestSubscriptionPropsAll =
-  | UnifiedRequestSubscriptionProps
-  | LegacyRequestSubscriptionProps;
+export type LegacyRequestSubscriptionPropsAll = UnifiedRequestSubscriptionProps | LegacyRequestSubscriptionProps;
 
 /**
  * All supported request purchase parameters
  * Used internally for backward compatibility
  * @internal
  */
-export type RequestPurchasePropsWithLegacy =
-  | RequestPurchaseProps
-  | LegacyRequestPurchasePropsAll;
+export type RequestPurchasePropsWithLegacy = RequestPurchaseProps | LegacyRequestPurchasePropsAll;
 
 /**
  * All supported request subscription parameters
  * Used internally for backward compatibility
  * @internal
  */
-export type RequestSubscriptionPropsWithLegacy =
-  | RequestSubscriptionProps
-  | LegacyRequestSubscriptionPropsAll;
+export type RequestSubscriptionPropsWithLegacy = RequestSubscriptionProps | LegacyRequestSubscriptionPropsAll;
 
 // ============================================================================
 // Type Guards and Utility Functions
@@ -446,19 +437,19 @@ export type RequestSubscriptionPropsWithLegacy =
 
 // Type guards to check which API style is being used
 export function isPlatformRequestProps(
-  props: RequestPurchasePropsWithLegacy | RequestSubscriptionPropsWithLegacy,
+  props: RequestPurchasePropsWithLegacy | RequestSubscriptionPropsWithLegacy
 ): props is PlatformRequestPurchaseProps | PlatformRequestSubscriptionProps {
   return 'ios' in props || 'android' in props;
 }
 
 export function isUnifiedRequestProps(
-  props: RequestPurchasePropsWithLegacy | RequestSubscriptionPropsWithLegacy,
+  props: RequestPurchasePropsWithLegacy | RequestSubscriptionPropsWithLegacy
 ): props is UnifiedRequestPurchaseProps | UnifiedRequestSubscriptionProps {
   return 'sku' in props || 'skus' in props;
 }
 
 export function isLegacyRequestProps(
-  props: RequestPurchasePropsWithLegacy | RequestSubscriptionPropsWithLegacy,
+  props: RequestPurchasePropsWithLegacy | RequestSubscriptionPropsWithLegacy
 ): props is LegacyRequestPurchaseProps | LegacyRequestSubscriptionProps {
   return 'productId' in props || 'productIds' in props;
 }

package/src/index.ts

@@ -21,8 +21,12 @@ import {
   isPlatformRequestProps,
   isUnifiedRequestProps,
 } from './ExpoIap.types';
-import {ProductPurchaseAndroid} from './types/ExpoIapAndroid.types';
-import {PaymentDiscount} from './types/ExpoIapIos.types';
+import {
+  ProductPurchaseAndroid,
+} from './types/ExpoIapAndroid.types';
+import {
+  PaymentDiscount,
+} from './types/ExpoIapIos.types';
 
 // Export all types
 export * from './ExpoIap.types';
@@ -38,6 +42,7 @@ export enum IapEvent {
   PurchaseError = 'purchase-error',
   /** @deprecated Use PurchaseUpdated instead. This will be removed in a future version. */
   TransactionIapUpdated = 'iap-transaction-updated',
+  PromotedProductIOS = 'promoted-product-ios',
 }
 
 export function setValueAsync(value: string) {
@@ -72,13 +77,43 @@ export const purchaseErrorListener = (
   return emitter.addListener(IapEvent.PurchaseError, listener);
 };
 
+/**
+ * iOS-only listener for App Store promoted product events.
+ * This fires when a user taps on a promoted product in the App Store.
+ * 
+ * @param listener - Callback function that receives the promoted product details
+ * @returns EventSubscription that can be used to unsubscribe
+ * 
+ * @example
+ * ```typescript
+ * const subscription = promotedProductListenerIOS((product) => {
+ *   console.log('Promoted product:', product);
+ *   // Handle the promoted product
+ * });
+ * 
+ * // Later, clean up
+ * subscription.remove();
+ * ```
+ * 
+ * @platform iOS
+ */
+export const promotedProductListenerIOS = (
+  listener: (product: Product) => void,
+) => {
+  if (Platform.OS !== 'ios') {
+    console.warn('promotedProductListenerIOS: This listener is only available on iOS');
+    return { remove: () => {} };
+  }
+  return emitter.addListener(IapEvent.PromotedProductIOS, listener);
+};
+
 export function initConnection() {
   return ExpoIapModule.initConnection();
 }
 
 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 `requestProducts({ 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'));
@@ -112,7 +147,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 `requestProducts({ 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'));
@@ -236,7 +271,7 @@ export const getPurchaseHistory = ({
   onlyIncludeActiveItems?: boolean;
 } = {}): Promise<ProductPurchase[]> => {
   console.warn(
-    '`getPurchaseHistory` is deprecated. Use `getPurchaseHistories` instead. This function will be removed in version 3.0.0.',
+    "`getPurchaseHistory` is deprecated. Use `getPurchaseHistories` instead. This function will be removed in version 3.0.0.",
   );
   return getPurchaseHistories({
     alsoPublishToEventListener,
@@ -286,8 +321,9 @@ export const getAvailablePurchases = ({
         ),
       android: async () => {
         const products = await ExpoIapModule.getAvailableItemsByType('inapp');
-        const subscriptions =
-          await ExpoIapModule.getAvailableItemsByType('subs');
+        const subscriptions = await ExpoIapModule.getAvailableItemsByType(
+          'subs',
+        );
         return products.concat(subscriptions);
       },
     }) || (() => Promise.resolve([]))
@@ -306,6 +342,7 @@ const offerToRecordIos = (
   };
 };
 
+
 // Define discriminated union with explicit type parameter
 // Using legacy types internally for backward compatibility
 type PurchaseRequest =
@@ -335,8 +372,7 @@ const normalizeRequestProps = (
     if (platform === 'ios') {
       return {
         sku: request.sku || (request.skus?.[0] ?? ''),
-        andDangerouslyFinishTransactionAutomaticallyIOS:
-          request.andDangerouslyFinishTransactionAutomaticallyIOS,
+        andDangerouslyFinishTransactionAutomaticallyIOS: request.andDangerouslyFinishTransactionAutomaticallyIOS,
         appAccountToken: request.appAccountToken,
         quantity: request.quantity,
         withOffer: request.withOffer,
@@ -348,7 +384,7 @@ const normalizeRequestProps = (
         obfuscatedProfileIdAndroid: request.obfuscatedProfileIdAndroid,
         isOfferPersonalized: request.isOfferPersonalized,
       };
-
+      
       // Add subscription-specific fields if present
       if ('subscriptionOffers' in request && request.subscriptionOffers) {
         androidRequest.subscriptionOffers = request.subscriptionOffers;
@@ -359,7 +395,7 @@ const normalizeRequestProps = (
       if ('replacementModeAndroid' in request) {
         androidRequest.replacementModeAndroid = request.replacementModeAndroid;
       }
-
+      
       return androidRequest;
     }
   }
@@ -370,11 +406,11 @@ const normalizeRequestProps = (
 
 /**
  * Request a purchase for products or subscriptions.
- *
+ * 
  * @param requestObj - Purchase request configuration
  * @param requestObj.request - Platform-specific purchase parameters
  * @param requestObj.type - Type of purchase: 'inapp' for products (default) or 'subs' for subscriptions
- *
+ * 
  * @example
  * ```typescript
  * // Product purchase
@@ -385,12 +421,12 @@ const normalizeRequestProps = (
  *   },
  *   type: 'inapp'
  * });
- *
+ * 
  * // Subscription purchase
  * await requestPurchase({
  *   request: {
  *     ios: { sku: subscriptionId },
- *     android: {
+ *     android: { 
  *       skus: [subscriptionId],
  *       subscriptionOffers: [{ sku: subscriptionId, offerToken: 'token' }]
  *     }
@@ -412,7 +448,7 @@ export const requestPurchase = (
 
   if (Platform.OS === 'ios') {
     const normalizedRequest = normalizeRequestProps(request, 'ios');
-
+    
     if (!normalizedRequest?.sku) {
       throw new Error(
         'Invalid request for iOS. The `sku` property is required and must be a string.',
@@ -445,7 +481,7 @@ export const requestPurchase = (
 
   if (Platform.OS === 'android') {
     const normalizedRequest = normalizeRequestProps(request, 'android');
-
+    
     if (!normalizedRequest?.skus?.length) {
       throw new Error(
         'Invalid request for Android. The `skus` property is required and must be a non-empty array.',
@@ -509,7 +545,7 @@ export const requestPurchase = (
 
 /**
  * @deprecated Use `requestPurchase({ request, type: 'subs' })` instead. This method will be removed in version 3.0.0.
- *
+ * 
  * @example
  * ```typescript
  * // Old way (deprecated)
@@ -518,12 +554,12 @@ export const requestPurchase = (
  *   // or for Android
  *   skus: [subscriptionId],
  * });
- *
+ * 
  * // New way (recommended)
  * await requestPurchase({
  *   request: {
  *     ios: { sku: subscriptionId },
- *     android: {
+ *     android: { 
  *       skus: [subscriptionId],
  *       subscriptionOffers: [{ sku: subscriptionId, offerToken: 'token' }]
  *     }
@@ -588,16 +624,16 @@ export const finishTransaction = ({
 
 /**
  * Retrieves the current storefront information from iOS App Store
- *
+ * 
  * @returns Promise resolving to the storefront country code
  * @throws Error if called on non-iOS platform
- *
+ * 
  * @example
  * ```typescript
  * const storefront = await getStorefrontIOS();
  * console.log(storefront); // 'US'
  * ```
- *
+ * 
  * @platform iOS
  */
 export const getStorefrontIOS = (): Promise<string> => {

package/src/modules/android.ts

@@ -102,9 +102,11 @@ export const acknowledgePurchaseAndroid = ({
  * Open the Google Play Store to redeem offer codes (Android only).
  * Note: Google Play does not provide a direct API to redeem codes within the app.
  * This function opens the Play Store where users can manually enter their codes.
- *
+ * 
  * @returns {Promise<void>}
  */
 export const openRedeemOfferCodeAndroid = async (): Promise<void> => {
-  return Linking.openURL(`https://play.google.com/redeem?code=`);
+  return Linking.openURL(
+    `https://play.google.com/redeem?code=`
+  );
 };