expo-iap 2.8.6 → 2.8.8

package/ios/ExpoIapModule.swift

@@ -114,7 +114,6 @@ func serializeTransaction(_ transaction: Transaction, jwsRepresentationIOS: Stri
         if let currency = jsonData["currency"] as? String {
             purchaseMap["currencyCodeIOS"] = currency
             
-            // Try to get currency symbol from locale
             let locale = Locale(identifier: Locale.identifier(fromComponents: [NSLocale.Key.currencyCode.rawValue: currency]))
             purchaseMap["currencySymbolIOS"] = locale.currencySymbol
             
@@ -123,7 +122,6 @@ func serializeTransaction(_ transaction: Transaction, jwsRepresentationIOS: Stri
             purchaseMap["currencyIOS"] = currency
             // END: Deprecated - will be removed in v2.9.0
         }
-        // Extract country code from storefront if available
         if let storefront = jsonData["storefront"] as? String {
             purchaseMap["countryCodeIOS"] = storefront
         }
@@ -178,10 +176,8 @@ func serializeSubscription(_ s: Product.SubscriptionInfo?) -> [String: Any?]? {
 
 @available(iOS 15.0, *)
 func serializeProduct(_ p: Product) -> [String: Any?] {
-    // Convert Product.ProductType to our expected 'inapp' or 'subs' string
     let productType: String = p.subscription != nil ? "subs" : "inapp"
     
-    // For subscription products, add discounts and introductory price
     var discounts: [[String: Any?]]? = nil
     var introductoryPrice: String? = nil
     var introductoryPriceAsAmountIOS: String? = nil
@@ -192,7 +188,6 @@ func serializeProduct(_ p: Product) -> [String: Any?] {
     var subscriptionPeriodUnitIOS: String? = nil
     
     if let subscription = p.subscription {
-        // Extract discount information from promotional offers
         if !subscription.promotionalOffers.isEmpty {
             discounts = subscription.promotionalOffers.compactMap { offer in
                 return [
@@ -207,7 +202,6 @@ func serializeProduct(_ p: Product) -> [String: Any?] {
             }
         }
         
-        // Extract introductory price from introductory offer
         if let introOffer = subscription.introductoryOffer {
             introductoryPrice = introOffer.displayPrice
             introductoryPriceAsAmountIOS = "\(introOffer.price)"
@@ -216,7 +210,6 @@ func serializeProduct(_ p: Product) -> [String: Any?] {
             introductoryPriceSubscriptionPeriodIOS = getPeriodIOS(introOffer.period.unit)
         }
         
-        // Extract subscription period information
         subscriptionPeriodNumberIOS = "\(subscription.subscriptionPeriod.value)"
         subscriptionPeriodUnitIOS = getPeriodIOS(subscription.subscriptionPeriod.unit)
     }
@@ -224,7 +217,6 @@ func serializeProduct(_ p: Product) -> [String: Any?] {
     return [
         "debugDescription": serializeDebug(p.debugDescription),
         "description": p.description,
-        // New iOS-suffixed fields
         "displayNameIOS": p.displayName,
         "discountsIOS": discounts,
         "introductoryPriceIOS": introductoryPrice,
@@ -308,13 +300,11 @@ public class ExpoIapModule: Module {
     private var productStore: ProductStore?
     private var hasListeners = false
     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?
     
-    // Add a flag to track initialization state
+    private let subscriptionChangePropagationDelay: UInt64 = 1_500_000_000 // 1.5 seconds in nanoseconds
     private var isInitialized = false
 
     public func definition() -> ModuleDefinition {
@@ -337,13 +327,10 @@ public class ExpoIapModule: Module {
         }
 
         Function("initConnection") { () -> Bool in
-            // Clean up any existing state first (important for hot reload)
             self.cleanupExistingState()
             
-            // Initialize fresh state
             self.productStore = ProductStore()
             
-            // Set up PaymentObserver for promoted products
             if self.paymentObserver == nil {
                 self.paymentObserver = PaymentObserver(module: self)
                 SKPaymentQueue.default().add(self.paymentObserver!)
@@ -416,7 +403,6 @@ public class ExpoIapModule: Module {
                 return nil
             }
             
-            // Convert SKProduct to dictionary
             return [
                 "productIdentifier": product.productIdentifier,
                 "localizedTitle": product.localizedTitle,
@@ -439,15 +425,35 @@ public class ExpoIapModule: Module {
                 )
             }
             
-            // Add the deferred payment to the queue
             SKPaymentQueue.default().add(payment)
             
-            // Clear the promoted product data
             self.promotedPayment = nil
             self.promotedProduct = nil
         }
 
+        AsyncFunction("fetchProducts") { (skus: [String]) -> [[String: Any?]?] in
+            try self.ensureConnection()
+            
+            let productStore = self.productStore!
+            
+            do {
+                let fetchedProducts = try await Product.products(for: skus)
+                await productStore.performOnActor { isolatedStore in
+                    fetchedProducts.forEach { product in
+                        isolatedStore.addProduct(product)
+                    }
+                }
+                let products = await productStore.getAllProducts()
+                return products.map { serializeProduct($0) }.compactMap { $0 }
+            } catch {
+                print("Error fetching items: \(error)")
+                throw error
+            }
+        }
+
         AsyncFunction("requestProducts") { (skus: [String]) -> [[String: Any?]?] in
+            print("WARNING: 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.")
+            
             try self.ensureConnection()
             
             let productStore = self.productStore!
@@ -482,63 +488,26 @@ public class ExpoIapModule: Module {
             func addTransaction(transaction: Transaction, jwsRepresentationIOS: String? = nil) {
                 let serialized = serializeTransaction(transaction, jwsRepresentationIOS: jwsRepresentationIOS)
                 purchasedItemsSerialized.append(serialized)
-                
-                if alsoPublishToEventListenerIOS {
-                    self.sendEvent(IapEvent.PurchaseUpdated, serialized)
-                }
             }
 
-            for await verification in onlyIncludeActiveItemsIOS
-                ? Transaction.currentEntitlements : Transaction.all
-            {
-                do {
-                    let transaction = try self.checkVerified(verification)
-                    if !onlyIncludeActiveItemsIOS {
-                        addTransaction(transaction: transaction, jwsRepresentationIOS: verification.jwsRepresentation)
-                        continue
-                    }
-                    switch transaction.productType {
-                    case .nonConsumable, .autoRenewable, .consumable:
-                        if await self.productStore?.getProduct(productID: transaction.productID)
-                            != nil
-                        {
+            if onlyIncludeActiveItemsIOS {
+                for await verification in Transaction.currentEntitlements {
+                    do {
+                        let transaction = try self.checkVerified(verification)
+                        if await self.productStore?.getProduct(productID: transaction.productID) != nil {
                             addTransaction(transaction: transaction, jwsRepresentationIOS: verification.jwsRepresentation)
                         }
-                    case .nonRenewable:
-                        if await self.productStore?.getProduct(productID: transaction.productID)
-                            != nil
-                        {
-                            let currentDate = Date()
-                            let expirationDate = Calendar(identifier: .gregorian).date(
-                                byAdding: DateComponents(year: 1), to: transaction.purchaseDate)!
-                            if currentDate < expirationDate {
-                                addTransaction(transaction: transaction, jwsRepresentationIOS: verification.jwsRepresentation)
-                            }
-                        }
-                    default:
-                        break
-                    }
-                } catch StoreError.failedVerification {
-                    let err = [
-                        "responseCode": IapErrorCode.transactionValidationFailed,
-                        "debugMessage": StoreError.failedVerification.localizedDescription,
-                        "code": IapErrorCode.transactionValidationFailed,
-                        "message": StoreError.failedVerification.localizedDescription,
-                        "productId": "unknown",
-                    ]
-                    if alsoPublishToEventListenerIOS {
-                        self.sendEvent(IapEvent.PurchaseError, err)
+                    } catch {
+                        print("[ExpoIapModule] Failed to verify transaction: \(error)")
                     }
-                } catch {
-                    let err = [
-                        "responseCode": IapErrorCode.unknown,
-                        "debugMessage": error.localizedDescription,
-                        "code": IapErrorCode.unknown,
-                        "message": error.localizedDescription,
-                        "productId": "unknown",
-                    ]
-                    if alsoPublishToEventListenerIOS {
-                        self.sendEvent(IapEvent.PurchaseError, err)
+                }
+            } else {
+                for await verification in Transaction.all {
+                    do {
+                        let transaction = try self.checkVerified(verification)
+                        addTransaction(transaction: transaction, jwsRepresentationIOS: verification.jwsRepresentation)
+                    } catch {
+                        print("[ExpoIapModule] Failed to verify transaction: \(error)")
                     }
                 }
             }
@@ -609,7 +578,6 @@ public class ExpoIapModule: Module {
                     case .success(let verification):
                         let transaction = try self.checkVerified(verification)
                         
-                        // Debug: Log JWS representation
                         let jwsRepresentation = verification.jwsRepresentation
                         if !jwsRepresentation.isEmpty {
                             logDebug("buyProduct JWS: exists")
@@ -625,7 +593,6 @@ public class ExpoIapModule: Module {
                             self.transactions[String(transaction.id)] = transaction
                             let serialized = serializeTransaction(transaction, jwsRepresentationIOS: verification.jwsRepresentation)
                             
-                            // Debug: Check if jwsRepresentationIOS is included in serialized result
                             logDebug("buyProduct serialized includes JWS: \(serialized["jwsRepresentationIOS"] != nil)")
                             
                             self.sendEvent(IapEvent.PurchaseUpdated, serialized)
@@ -667,15 +634,12 @@ public class ExpoIapModule: Module {
                         throw error
                     }
                     
-                    // Map StoreKit errors to proper error codes
                     var errorCode = IapErrorCode.purchaseError
                     var errorMessage = error.localizedDescription
                     
-                    // Check for specific StoreKit error types
                     if let nsError = error as NSError? {
                         switch nsError.domain {
                         case "SKErrorDomain":
-                            // Handle SKError codes
                             switch nsError.code {
                             case 0: // SKError.unknown
                                 errorCode = IapErrorCode.unknown
@@ -844,19 +808,76 @@ public class ExpoIapModule: Module {
             #endif
         }
 
-        AsyncFunction("showManageSubscriptionsIOS") { () -> Bool in
+        AsyncFunction("showManageSubscriptionsIOS") { () -> [[String: Any?]] in
             #if !os(tvOS)
                 guard let windowScene = await self.currentWindowScene() else {
                     throw Exception(name: "ExpoIapModule", description: "Cannot find window scene or not available on macOS", code: IapErrorCode.serviceError)
                 }
-                // Get all subscription products before showing the management UI
+                
+                var beforeStatuses: [String: Bool] = [:]
                 let subscriptionSkus = await self.getAllSubscriptionProductIds()
-                self.pollingSkus = Set(subscriptionSkus)
-                // Show the management UI
+                
+                for sku in subscriptionSkus {
+                    if let product = await self.productStore?.getProduct(productID: sku),
+                       let subscription = product.subscription {
+                        do {
+                            let statuses = try await subscription.status
+                            if let s = statuses.first(where: { status in
+                                if case .verified(let info) = status.renewalInfo {
+                                    return info.currentProductID == sku
+                                }
+                                return false
+                            }) {
+                                var willAutoRenew = false
+                                if case .verified(let info) = s.renewalInfo {
+                                    willAutoRenew = info.willAutoRenew
+                                }
+                                beforeStatuses[sku] = willAutoRenew
+                            }
+                        } catch {
+                            // ignore
+                        }
+                    }
+                }
+                
                 try await AppStore.showManageSubscriptions(in: windowScene)
-                // Start polling for status changes
-                self.pollForSubscriptionStatusChanges()
-                return true
+                
+                try? await Task.sleep(nanoseconds: subscriptionChangePropagationDelay)
+                
+                var updatedSubscriptions: [[String: Any?]] = []
+                
+                for sku in subscriptionSkus {
+                    if let product = await self.productStore?.getProduct(productID: sku),
+                       let subscription = product.subscription,
+                       let result = await product.latestTransaction {
+                        let statuses = try? await subscription.status
+                        let matchedStatus = statuses?.first(where: { status in
+                            if case .verified(let info) = status.renewalInfo {
+                                return info.currentProductID == sku
+                            }
+                            return false
+                        })
+                        
+                        var currentWillAutoRenew = false
+                        if let s = matchedStatus, case .verified(let info) = s.renewalInfo {
+                            currentWillAutoRenew = info.willAutoRenew
+                        }
+                        
+                        let previousWillAutoRenew = beforeStatuses[sku] ?? false
+                        if previousWillAutoRenew != currentWillAutoRenew {
+                            do {
+                                let transaction = try self.checkVerified(result)
+                                var purchaseMap = serializeTransaction(transaction, jwsRepresentationIOS: result.jwsRepresentation)
+                                purchaseMap["willAutoRenewIOS"] = currentWillAutoRenew
+                                updatedSubscriptions.append(purchaseMap)
+                            } catch {
+                                print("[ExpoIapModule] Failed to verify subscription change: \(error)")
+                            }
+                        }
+                    }
+                }
+                
+                return updatedSubscriptions
             #else
                 throw Exception(name: "ExpoIapModule", description: "This method is not available on tvOS", code: IapErrorCode.serviceError)
             #endif
@@ -1015,12 +1036,8 @@ public class ExpoIapModule: Module {
         updateListenerTask?.cancel()
         updateListenerTask = nil
         
-        subscriptionPollingTask?.cancel()
-        subscriptionPollingTask = nil
-        
         // Clear collections
         transactions.removeAll()
-        pollingSkus.removeAll()
         
         // Reset promoted products
         promotedPayment = nil
@@ -1116,71 +1133,6 @@ public class ExpoIapModule: Module {
         }
     }
 
-    private func pollForSubscriptionStatusChanges() {
-        subscriptionPollingTask?.cancel()
-        subscriptionPollingTask = Task {
-            try? await Task.sleep(nanoseconds: 1_500_000_000) // 1.5 seconds
-            
-            var previousStatuses: [String: Bool] = [:] // Track auto-renewal state with Bool
-            
-            for sku in self.pollingSkus {
-                guard let product = await self.productStore?.getProduct(productID: sku),
-                      let status = try? await product.subscription?.status.first else { continue }
-                
-                // Track willAutoRenew as a bool value
-                var willAutoRenew = false
-                if case .verified(let info) = status.renewalInfo {
-                    willAutoRenew = info.willAutoRenew
-                }
-                previousStatuses[sku] = willAutoRenew
-            }
-
-            for _ in 1...5 {
-                try? await Task.sleep(nanoseconds: 2_000_000_000) // 2 seconds
-                if Task.isCancelled {
-                    return
-                }
-                
-                for sku in self.pollingSkus {
-                    guard let product = await self.productStore?.getProduct(productID: sku),
-                          let status = try? await product.subscription?.status.first,
-                          let result = await product.latestTransaction else { continue }
-                    // Try to verify the transaction
-                    let transaction: Transaction
-                    do {
-                        transaction = try self.checkVerified(result)
-                    } catch {
-                        continue // Skip if verification fails
-                    }
-                    
-                    // Track current auto-renewal state
-                    var currentWillAutoRenew = false
-                    if case .verified(let info) = status.renewalInfo {
-                        currentWillAutoRenew = info.willAutoRenew
-                    }
-                    
-                    // Compare with previous state
-                    if let previousWillAutoRenew = previousStatuses[sku], 
-                       previousWillAutoRenew != currentWillAutoRenew {
-                        
-                        // Use the jwsRepresentation when serializing the transaction
-                        var purchaseMap = serializeTransaction(transaction, jwsRepresentationIOS: result.jwsRepresentation)
-                        
-                        if case .verified(let renewalInfo) = status.renewalInfo {
-                            if let renewalInfoDict = serializeRenewalInfo(.verified(renewalInfo)) {
-                                purchaseMap["renewalInfo"] = renewalInfoDict
-                            }
-                        }
-                        
-                        self.sendEvent(IapEvent.PurchaseUpdated, purchaseMap)
-                        previousStatuses[sku] = currentWillAutoRenew
-                    }
-                }
-            }
-            self.pollingSkus.removeAll()
-        }
-    }
-    
     private func getReceiptDataInternal() throws -> String {
         if let appStoreReceiptURL = Bundle.main.appStoreReceiptURL,
            FileManager.default.fileExists(atPath: appStoreReceiptURL.path) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-iap",
-  "version": "2.8.6",
+  "version": "2.8.8",
   "description": "In App Purchase module in Expo",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -25,7 +25,8 @@
     "docs:start": "cd docs && bun run start",
     "docs:build": "cd docs && bun run build",
     "docs:serve": "cd docs && bun run serve",
-    "docs:install": "cd docs && bun install"
+    "docs:install": "cd docs && bun install",
+    "generate:icon": "npx sharp-cli resize 32 32 -i docs/static/img/icon.png -o docs/static/img/favicon-32x32.png && npx sharp-cli resize 16 16 -i docs/static/img/icon.png -o docs/static/img/favicon-16x16.png && npx sharp-cli resize 180 180 -i docs/static/img/icon.png -o docs/static/img/apple-touch-icon.png && npx sharp-cli resize 192 192 -i docs/static/img/icon.png -o docs/static/img/android-chrome-192x192.png && npx sharp-cli resize 512 512 -i docs/static/img/icon.png -o docs/static/img/android-chrome-512x512.png && npx sharp-cli resize 150 150 -i docs/static/img/icon.png -o docs/static/img/mstile-150x150.png && npx sharp-cli resize 1200 630 -i docs/static/img/icon.png -o docs/static/img/og-image.png && npx sharp-cli resize 1200 600 -i docs/static/img/icon.png -o docs/static/img/twitter-card.png && npx sharp-cli resize 16 16 -i docs/static/img/icon.png -o docs/static/img/favicon.png && cp docs/static/img/favicon-16x16.png docs/static/img/favicon.ico"
   },
   "keywords": [
     "react-native",

package/src/helpers/subscription.ts

@@ -4,6 +4,9 @@ import {getAvailablePurchases} from '../index';
 export interface ActiveSubscription {
   productId: string;
   isActive: boolean;
+  transactionId: string; // Transaction identifier for backend validation
+  purchaseToken?: string; // JWT token (iOS) or purchase token (Android) for backend validation
+  transactionDate: number; // Transaction timestamp
   expirationDateIOS?: Date;
   autoRenewingAndroid?: boolean;
   environmentIOS?: string;
@@ -79,6 +82,9 @@ export const getActiveSubscriptions = async (
       const subscription: ActiveSubscription = {
         productId: purchase.productId,
         isActive: true,
+        transactionId: purchase.transactionId || purchase.id,
+        purchaseToken: purchase.purchaseToken,
+        transactionDate: purchase.transactionDate,
       };
 
       // Add platform-specific details

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.requestProducts(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.requestProducts('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.requestProducts(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.requestProducts('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.requestProducts(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.requestProducts(type, skus);
+    const items = await ExpoIapModule.fetchProducts(type, skus);
     const filteredItems = items.filter((item: unknown) => {
       if (!isProductAndroid(item)) return false;
       return (
@@ -271,6 +271,41 @@ 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.
  */

package/src/modules/ios.ts

@@ -168,15 +168,14 @@ 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 an array of subscriptions that had status changes after the UI is closed.
  *
- * @returns Promise resolving to null on success
+ * @returns Promise<Purchase[]> - Array of subscriptions with status changes (e.g., auto-renewal toggled)
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
  */
-export const showManageSubscriptionsIOS = (): Promise<null> => {
+export const showManageSubscriptionsIOS = (): Promise<Purchase[]> => {
   return ExpoIapModule.showManageSubscriptionsIOS();
 };
 
@@ -415,7 +414,7 @@ export const beginRefundRequest = (
 /**
  * @deprecated Use `showManageSubscriptionsIOS` instead. This function will be removed in version 3.0.0.
  */
-export const showManageSubscriptions = (): Promise<null> => {
+export const showManageSubscriptions = (): Promise<Purchase[]> => {
   console.warn(
     '`showManageSubscriptions` is deprecated. Use `showManageSubscriptionsIOS` instead. This function will be removed in version 3.0.0.',
   );