expo-iap 2.8.0 → 2.8.1

package/ios/ExpoIapModule.swift

@@ -106,10 +106,26 @@ func serializeTransaction(_ transaction: Transaction, jwsRepresentationIOS: Stri
 
     if #available(iOS 15.4, *), let jsonData = jsonData {
         if let price = jsonData["price"] as? NSNumber {
+            // START: Deprecated - will be removed in v2.9.0
+            // Use currencyCodeIOS, currencySymbolIOS, countryCodeIOS instead
             purchaseMap["priceIOS"] = price.doubleValue
+            // END: Deprecated - will be removed in v2.9.0
         }
         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
+            
+            // START: Deprecated - will be removed in v2.9.0
+            // Use currencyCodeIOS instead
             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
         }
     }
 
@@ -162,20 +178,86 @@ 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
+    var introductoryPricePaymentModeIOS: String? = nil
+    var introductoryPriceNumberOfPeriodsIOS: String? = nil
+    var introductoryPriceSubscriptionPeriodIOS: String? = nil
+    var subscriptionPeriodNumberIOS: String? = nil
+    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 [
+                    "identifier": offer.id ?? "",
+                    "type": offer.type.rawValue,
+                    "numberOfPeriods": "\(offer.periodCount)",
+                    "price": "\(offer.price)",
+                    "localizedPrice": offer.displayPrice,
+                    "paymentMode": offer.paymentMode.rawValue,
+                    "subscriptionPeriod": getPeriodIOS(offer.period.unit)
+                ]
+            }
+        }
+        
+        // Extract introductory price from introductory offer
+        if let introOffer = subscription.introductoryOffer {
+            introductoryPrice = introOffer.displayPrice
+            introductoryPriceAsAmountIOS = "\(introOffer.price)"
+            introductoryPricePaymentModeIOS = introOffer.paymentMode.rawValue
+            introductoryPriceNumberOfPeriodsIOS = "\(introOffer.periodCount)"
+            introductoryPriceSubscriptionPeriodIOS = getPeriodIOS(introOffer.period.unit)
+        }
+        
+        // Extract subscription period information
+        subscriptionPeriodNumberIOS = "\(subscription.subscriptionPeriod.value)"
+        subscriptionPeriodUnitIOS = getPeriodIOS(subscription.subscriptionPeriod.unit)
+    }
+    
     return [
         "debugDescription": serializeDebug(p.debugDescription),
         "description": p.description,
-        "displayName": p.displayName,
+        // New iOS-suffixed fields
+        "displayNameIOS": p.displayName,
+        "discountsIOS": discounts,
+        "introductoryPriceIOS": introductoryPrice,
+        "introductoryPriceAsAmountIOS": introductoryPriceAsAmountIOS,
+        "introductoryPricePaymentModeIOS": introductoryPricePaymentModeIOS,
+        "introductoryPriceNumberOfPeriodsIOS": introductoryPriceNumberOfPeriodsIOS,
+        "introductoryPriceSubscriptionPeriodIOS": introductoryPriceSubscriptionPeriodIOS,
+        "subscriptionPeriodNumberIOS": subscriptionPeriodNumberIOS,
+        "subscriptionPeriodUnitIOS": subscriptionPeriodUnitIOS,
         "displayPrice": p.displayPrice,
         "id": p.id,
         "title": p.displayName,
-        "isFamilyShareable": p.isFamilyShareable,
-        "jsonRepresentation": String(data: p.jsonRepresentation, encoding: .utf8),
+        "isFamilyShareableIOS": p.isFamilyShareable,
+        "jsonRepresentationIOS": String(data: p.jsonRepresentation, encoding: .utf8),
         "price": p.price,
-        "subscription": serializeSubscription(p.subscription),
-        "type": p.type,
+        "subscriptionInfoIOS": serializeSubscription(p.subscription),
+        "type": productType,
         "currency": p.priceFormatStyle.currencyCode,
         "platform": "ios",
+        // START: Deprecated - will be removed in v2.9.0
+        // Use displayNameIOS instead of displayName
+        "displayName": p.displayName,
+        // Use discountsIOS instead of discounts
+        "discounts": discounts,
+        // Use introductoryPriceIOS instead of introductoryPrice
+        "introductoryPrice": introductoryPrice,
+        // Use isFamilyShareableIOS instead of isFamilyShareable
+        "isFamilyShareable": p.isFamilyShareable,
+        // Use jsonRepresentationIOS instead of jsonRepresentation
+        "jsonRepresentation": String(data: p.jsonRepresentation, encoding: .utf8),
+        // Use subscriptionInfoIOS instead of subscription
+        "subscription": serializeSubscription(p.subscription),
+        // END: Deprecated - will be removed in v2.9.0
     ]
 }
 

package/package.json

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

package/src/ExpoIap.types.ts

@@ -1,12 +1,12 @@
 import {
   ProductAndroid,
   ProductPurchaseAndroid,
-  SubscriptionProductAndroid,
+  ProductSubscriptionAndroid,
 } from './types/ExpoIapAndroid.types';
 import {
   ProductIOS,
   ProductPurchaseIOS,
-  SubscriptionProductIOS,
+  ProductSubscriptionIOS,
 } from './types/ExpoIapIOS.types';
 import {NATIVE_ERROR_CODES} from './ExpoIapModule';
 
@@ -16,7 +16,11 @@ export type ChangeEventPayload = {
 
 export type ProductType = 'inapp' | 'subs';
 
-export type ProductBase = {
+// =============================================================================
+// COMMON TYPES (Base types shared across all platforms)
+// =============================================================================
+
+export type ProductCommon = {
   id: string;
   title: string;
   description: string;
@@ -25,15 +29,23 @@ export type ProductBase = {
   displayPrice: string;
   currency: string;
   price?: number;
+  debugDescription?: string;
+  platform?: string;
 };
 
-export type PurchaseBase = {
+export type PurchaseCommon = {
   id: string; // Transaction identifier - used by finishTransaction
   productId: string; // Product identifier - which product was purchased
+  ids?: string[]; // Product identifiers for purchases that include multiple products
   transactionId?: string; // @deprecated - use id instead
   transactionDate: number;
   transactionReceipt: string;
   purchaseToken?: string; // Unified purchase token (jwsRepresentation for iOS, purchaseToken for Android)
+  platform?: string;
+};
+
+export type ProductSubscriptionCommon = ProductCommon & {
+  type: 'subs';
 };
 
 // Define literal platform types for better type discrimination
@@ -46,35 +58,35 @@ export type Product =
   | (ProductIOS & IosPlatform);
 
 export type SubscriptionProduct =
-  | (SubscriptionProductAndroid & AndroidPlatform)
-  | (SubscriptionProductIOS & IosPlatform);
-
-// ============================================================================
-// Legacy Types (For backward compatibility with useIAP hook)
-// ============================================================================
-
-// Re-export platform-specific purchase types for legacy compatibility
-export type {ProductPurchaseAndroid} from './types/ExpoIapAndroid.types';
-export type {ProductPurchaseIOS} from './types/ExpoIapIOS.types';
+  | (ProductSubscriptionAndroid & AndroidPlatform)
+  | (ProductSubscriptionIOS & IosPlatform);
 
-/**
- * @deprecated Use ProductPurchaseIOS instead. This alias will be removed in v3.0.0.
- */
-export type ProductPurchaseIos = ProductPurchaseIOS;
+// Re-export platform-specific types
+export type {
+  ProductPurchaseAndroid,
+  PurchaseAndroid,
+  ProductSubscriptionAndroid,
+  SubscriptionProductAndroid, // Legacy
+} from './types/ExpoIapAndroid.types';
+export type {
+  ProductPurchaseIOS,
+  PurchaseIOS,
+  ProductSubscriptionIOS,
+  SubscriptionProductIOS, // Legacy
+} from './types/ExpoIapIOS.types';
 
-// Union type for platform-specific purchase types (legacy support)
+// Union type for platform-specific purchase types
 export type ProductPurchase =
   | (ProductPurchaseAndroid & AndroidPlatform)
   | (ProductPurchaseIOS & IosPlatform);
 
-// Union type for platform-specific subscription purchase types (legacy support)
+// Union type for platform-specific subscription purchase types
 export type SubscriptionPurchase =
   | (ProductPurchaseAndroid & AndroidPlatform & {autoRenewingAndroid: boolean})
   | (ProductPurchaseIOS & IosPlatform);
 
 export type Purchase = ProductPurchase | SubscriptionPurchase;
 
-// Legacy result type
 export type PurchaseResult = {
   responseCode?: number;
   debugMessage?: string;
@@ -310,7 +322,7 @@ export interface UnifiedRequestPurchaseProps {
   readonly skus?: string[]; // Multiple SKUs (Android native, iOS uses first item)
 
   // iOS-specific properties (ignored on Android)
-  readonly andDangerouslyFinishTransactionAutomaticallyIOS?: boolean;
+  readonly andDangerouslyFinishTransactionAutomatically?: boolean;
   readonly appAccountToken?: string;
   readonly quantity?: number;
   readonly withOffer?: import('./types/ExpoIapIOS.types').PaymentDiscount;
@@ -328,9 +340,9 @@ export interface UnifiedRequestPurchaseProps {
 /**
  * iOS-specific purchase request parameters
  */
-export interface RequestPurchaseIOSProps {
+export interface RequestPurchaseIosProps {
   readonly sku: string;
-  readonly andDangerouslyFinishTransactionAutomaticallyIOS?: boolean;
+  readonly andDangerouslyFinishTransactionAutomatically?: boolean;
   readonly appAccountToken?: string;
   readonly quantity?: number;
   readonly withOffer?: import('./types/ExpoIapIOS.types').PaymentDiscount;
@@ -364,7 +376,7 @@ export interface RequestSubscriptionAndroidProps
  * Allows clear separation of iOS and Android parameters
  */
 export interface RequestPurchasePropsByPlatforms {
-  readonly ios?: RequestPurchaseIOSProps;
+  readonly ios?: RequestPurchaseIosProps;
   readonly android?: RequestPurchaseAndroidProps;
 }
 
@@ -372,7 +384,7 @@ export interface RequestPurchasePropsByPlatforms {
  * Modern platform-specific subscription request structure (v2.7.0+)
  */
 export interface RequestSubscriptionPropsByPlatforms {
-  readonly ios?: RequestPurchaseIOSProps;
+  readonly ios?: RequestPurchaseIosProps;
   readonly android?: RequestSubscriptionAndroidProps;
 }
 
@@ -387,14 +399,3 @@ export type RequestPurchaseProps = RequestPurchasePropsByPlatforms;
  * This is the recommended API moving forward
  */
 export type RequestSubscriptionProps = RequestSubscriptionPropsByPlatforms;
-
-// ============================================================================
-// Deprecated Aliases for Backward Compatibility
-// ============================================================================
-
-/**
- * @deprecated Use RequestPurchaseIOSProps instead. This alias will be removed in v3.0.0.
- */
-export type RequestPurchaseIosProps = RequestPurchaseIOSProps;
-
-// Note: Type guard functions are exported from index.ts to avoid conflicts

package/src/index.ts

@@ -429,7 +429,7 @@ export const requestPurchase = (
 
     const {
       sku,
-      andDangerouslyFinishTransactionAutomaticallyIOS = false,
+      andDangerouslyFinishTransactionAutomatically = false,
       appAccountToken,
       quantity,
       withOffer,
@@ -439,7 +439,7 @@ export const requestPurchase = (
       const offer = offerToRecordIOS(withOffer);
       const purchase = await ExpoIapModule.buyProduct(
         sku,
-        andDangerouslyFinishTransactionAutomaticallyIOS,
+        andDangerouslyFinishTransactionAutomatically,
         appAccountToken,
         quantity ?? -1,
         offer,

package/src/types/ExpoIapAndroid.types.ts

@@ -1,6 +1,6 @@
-import {PurchaseBase, ProductBase} from '../ExpoIap.types';
+import {PurchaseCommon, ProductCommon} from '../ExpoIap.types';
 
-type OneTimePurchaseOfferDetails = {
+type ProductAndroidOneTimePurchaseOfferDetail = {
   priceCurrencyCode: string;
   formattedPrice: string;
   priceAmountMicros: string;
@@ -20,21 +20,34 @@ type PricingPhasesAndroid = {
   pricingPhaseList: PricingPhaseAndroid[];
 };
 
-type SubscriptionOfferDetail = {
+type ProductSubscriptionAndroidOfferDetail = {
   basePlanId: string;
-  offerId: string;
+  offerId: string | null;
   offerToken: string;
   offerTags: string[];
   pricingPhases: PricingPhasesAndroid;
 };
 
-export type ProductAndroid = ProductBase & {
-  name: string;
-  oneTimePurchaseOfferDetails?: OneTimePurchaseOfferDetails;
-  subscriptionOfferDetails?: SubscriptionOfferDetail[];
+export type ProductAndroid = ProductCommon & {
+  nameAndroid: string;
+  oneTimePurchaseOfferDetailsAndroid?: ProductAndroidOneTimePurchaseOfferDetail;
+  platform: 'android';
+  subscriptionOfferDetailsAndroid?: ProductSubscriptionAndroidOfferDetail[];
+  /**
+   * @deprecated Use `nameAndroid` instead. This field will be removed in v2.9.0.
+   */
+  name?: string;
+  /**
+   * @deprecated Use `oneTimePurchaseOfferDetailsAndroid` instead. This field will be removed in v2.9.0.
+   */
+  oneTimePurchaseOfferDetails?: ProductAndroidOneTimePurchaseOfferDetail;
+  /**
+   * @deprecated Use `subscriptionOfferDetailsAndroid` instead. This field will be removed in v2.9.0.
+   */
+  subscriptionOfferDetails?: ProductSubscriptionAndroidOfferDetail[];
 };
 
-type SubscriptionOfferAndroid = {
+type ProductSubscriptionAndroidOfferDetails = {
   basePlanId: string;
   offerId: string | null;
   offerToken: string;
@@ -42,10 +55,17 @@ type SubscriptionOfferAndroid = {
   offerTags: string[];
 };
 
-export type SubscriptionProductAndroid = ProductAndroid & {
-  subscriptionOfferDetails: SubscriptionOfferAndroid[];
+export type ProductSubscriptionAndroid = ProductAndroid & {
+  subscriptionOfferDetailsAndroid: ProductSubscriptionAndroidOfferDetails[];
+  /**
+   * @deprecated Use `subscriptionOfferDetailsAndroid` instead. This field will be removed in v2.9.0.
+   */
+  subscriptionOfferDetails?: ProductSubscriptionAndroidOfferDetails[];
 };
 
+// Legacy naming for backward compatibility
+export type SubscriptionProductAndroid = ProductSubscriptionAndroid;
+
 export type RequestPurchaseAndroidProps = {
   skus: string[];
   obfuscatedAccountIdAndroid?: string;
@@ -110,14 +130,21 @@ export enum FeatureTypeAndroid {
   SUBSCRIPTIONS_UPDATE = 'SUBSCRIPTIONS_UPDATE',
 }
 
-export enum PurchaseStateAndroid {
+export enum PurchaseAndroidState {
   UNSPECIFIED_STATE = 0,
   PURCHASED = 1,
   PENDING = 2,
 }
 
-export type ProductPurchaseAndroid = PurchaseBase & {
-  ids?: string[];
+// Legacy naming for backward compatibility
+/**
+ * @deprecated Use `PurchaseAndroidState` instead. This enum will be removed in v2.9.0.
+ */
+export const PurchaseStateAndroid = PurchaseAndroidState;
+
+// Legacy naming for backward compatibility
+export type ProductPurchaseAndroid = PurchaseCommon & {
+  platform: 'android';
   /**
    * @deprecated Use `purchaseToken` instead. This field will be removed in a future version.
    */
@@ -125,10 +152,30 @@ export type ProductPurchaseAndroid = PurchaseBase & {
   dataAndroid?: string;
   signatureAndroid?: string;
   autoRenewingAndroid?: boolean;
-  purchaseStateAndroid?: PurchaseStateAndroid;
+  purchaseStateAndroid?: PurchaseAndroidState;
   isAcknowledgedAndroid?: boolean;
   packageNameAndroid?: string;
   developerPayloadAndroid?: string;
   obfuscatedAccountIdAndroid?: string;
   obfuscatedProfileIdAndroid?: string;
 };
+
+// Preferred naming
+export type PurchaseAndroid = ProductPurchaseAndroid;
+
+// Legacy type aliases for backward compatibility
+/**
+ * @deprecated Use `ProductAndroidOneTimePurchaseOfferDetail` instead. This type will be removed in v2.9.0.
+ */
+export type OneTimePurchaseOfferDetails =
+  ProductAndroidOneTimePurchaseOfferDetail;
+
+/**
+ * @deprecated Use `ProductSubscriptionAndroidOfferDetail` instead. This type will be removed in v2.9.0.
+ */
+export type SubscriptionOfferDetail = ProductSubscriptionAndroidOfferDetail;
+
+/**
+ * @deprecated Use `ProductSubscriptionAndroidOfferDetails` instead. This type will be removed in v2.9.0.
+ */
+export type SubscriptionOfferAndroid = ProductSubscriptionAndroidOfferDetails;

package/src/types/ExpoIapIOS.types.ts

@@ -1,4 +1,4 @@
-import {PurchaseBase, ProductBase} from '../ExpoIap.types';
+import {PurchaseCommon, ProductCommon} from '../ExpoIap.types';
 
 type SubscriptionIosPeriod = 'DAY' | 'WEEK' | 'MONTH' | 'YEAR' | '';
 type PaymentMode = '' | 'FREETRIAL' | 'PAYASYOUGO' | 'PAYUPFRONT';
@@ -26,10 +26,27 @@ type SubscriptionInfo = {
   };
 };
 
-export type ProductIOS = ProductBase & {
-  displayName: string;
-  isFamilyShareable: boolean;
-  jsonRepresentation: string;
+export type ProductIOS = ProductCommon & {
+  displayNameIOS: string;
+  isFamilyShareableIOS: boolean;
+  jsonRepresentationIOS: string;
+  platform: 'ios';
+  subscriptionInfoIOS?: SubscriptionInfo;
+  /**
+   * @deprecated Use `displayNameIOS` instead. This field will be removed in v2.9.0.
+   */
+  displayName?: string;
+  /**
+   * @deprecated Use `isFamilyShareableIOS` instead. This field will be removed in v2.9.0.
+   */
+  isFamilyShareable?: boolean;
+  /**
+   * @deprecated Use `jsonRepresentationIOS` instead. This field will be removed in v2.9.0.
+   */
+  jsonRepresentation?: string;
+  /**
+   * @deprecated Use `subscriptionInfoIOS` instead. This field will be removed in v2.9.0.
+   */
   subscription?: SubscriptionInfo;
   introductoryPriceNumberOfPeriodsIOS?: string;
   introductoryPriceSubscriptionPeriodIOS?: SubscriptionIosPeriod;
@@ -45,17 +62,29 @@ export type Discount = {
   subscriptionPeriod: string;
 };
 
-export type SubscriptionProductIOS = ProductIOS & {
-  discounts?: Discount[];
-  introductoryPrice?: string;
+export type ProductSubscriptionIOS = ProductIOS & {
+  discountsIOS?: Discount[];
+  introductoryPriceIOS?: string;
   introductoryPriceAsAmountIOS?: string;
   introductoryPricePaymentModeIOS?: PaymentMode;
   introductoryPriceNumberOfPeriodsIOS?: string;
   introductoryPriceSubscriptionPeriodIOS?: SubscriptionIosPeriod;
+  platform: 'ios';
   subscriptionPeriodNumberIOS?: string;
   subscriptionPeriodUnitIOS?: SubscriptionIosPeriod;
+  /**
+   * @deprecated Use `discountsIOS` instead. This field will be removed in v2.9.0.
+   */
+  discounts?: Discount[];
+  /**
+   * @deprecated Use `introductoryPriceIOS` instead. This field will be removed in v2.9.0.
+   */
+  introductoryPrice?: string;
 };
 
+// Legacy naming for backward compatibility
+export type SubscriptionProductIOS = ProductSubscriptionIOS;
+
 export type PaymentDiscount = {
   /**
    * A string used to uniquely identify a discount offer for a product.
@@ -79,9 +108,9 @@ export type PaymentDiscount = {
   timestamp: number;
 };
 
-export type RequestPurchaseIOSProps = {
+export type RequestPurchaseIosProps = {
   sku: string;
-  andDangerouslyFinishTransactionAutomaticallyIOS?: boolean;
+  andDangerouslyFinishTransactionAutomatically?: boolean;
   /**
    * UUID representing user account
    */
@@ -90,18 +119,6 @@ export type RequestPurchaseIOSProps = {
   withOffer?: PaymentDiscount;
 };
 
-export type RequestSubscriptionIOSProps = RequestPurchaseIOSProps;
-
-/**
- * @deprecated Use RequestPurchaseIOSProps instead. This alias will be removed in v3.0.0.
- */
-export type RequestPurchaseIosProps = RequestPurchaseIOSProps;
-
-/**
- * @deprecated Use RequestSubscriptionIOSProps instead. This alias will be removed in v3.0.0.
- */
-export type RequestSubscriptionIosProps = RequestSubscriptionIOSProps;
-
 type SubscriptionStatus =
   | 'expired'
   | 'inBillingRetryPeriod'
@@ -120,8 +137,10 @@ export type ProductStatusIOS = {
   renewalInfo?: RenewalInfo;
 };
 
-export type ProductPurchaseIOS = PurchaseBase & {
+// Legacy naming for backward compatibility
+export type ProductPurchaseIOS = PurchaseCommon & {
   // iOS basic fields
+  platform: 'ios';
   quantityIOS?: number;
   originalTransactionDateIOS?: number;
   originalTransactionIdentifierIOS?: string;
@@ -146,8 +165,10 @@ export type ProductPurchaseIOS = PurchaseBase & {
     type: string;
     paymentMode: string;
   };
-  priceIOS?: number;
-  currencyIOS?: string;
+  // Price locale fields
+  currencyCodeIOS?: string;
+  currencySymbolIOS?: string;
+  countryCodeIOS?: string;
   /**
    * @deprecated Use `purchaseToken` instead. This field will be removed in a future version.
    * iOS 15+ JWS representation is now available through the `purchaseToken` field.
@@ -155,6 +176,9 @@ export type ProductPurchaseIOS = PurchaseBase & {
   jwsRepresentationIOS?: string;
 };
 
+// Preferred naming
+export type PurchaseIOS = ProductPurchaseIOS;
+
 export type AppTransactionIOS = {
   appTransactionId?: string; // Only available in iOS 18.4+
   originalPlatform?: string; // Only available in iOS 18.4+