expo-iap 2.8.0 → 2.8.2

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.2",
   "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,
+  PurchaseAndroid,
+  ProductSubscriptionAndroid,
 } from './types/ExpoIapAndroid.types';
 import {
   ProductIOS,
-  ProductPurchaseIOS,
-  SubscriptionProductIOS,
+  PurchaseIOS,
+  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,34 @@ export type Product =
   | (ProductIOS & IosPlatform);
 
 export type SubscriptionProduct =
-  | (SubscriptionProductAndroid & AndroidPlatform)
-  | (SubscriptionProductIOS & IosPlatform);
+  | (ProductSubscriptionAndroid & AndroidPlatform)
+  | (ProductSubscriptionIOS & IosPlatform);
 
-// ============================================================================
-// Legacy Types (For backward compatibility with useIAP hook)
-// ============================================================================
+// Re-export platform-specific types
+export type {
+  PurchaseAndroid,
+  ProductSubscriptionAndroid,
+} from './types/ExpoIapAndroid.types';
+export type {
+  PurchaseIOS,
+  ProductSubscriptionIOS,
+} from './types/ExpoIapIOS.types';
 
-// Re-export platform-specific purchase types for legacy compatibility
-export type {ProductPurchaseAndroid} from './types/ExpoIapAndroid.types';
-export type {ProductPurchaseIOS} from './types/ExpoIapIOS.types';
+// Unified purchase type for both products and subscriptions
+export type Purchase =
+  | (PurchaseAndroid & AndroidPlatform)
+  | (PurchaseIOS & IosPlatform);
 
+// Legacy type aliases - deprecated, use Purchase instead
 /**
- * @deprecated Use ProductPurchaseIOS instead. This alias will be removed in v3.0.0.
+ * @deprecated Use `Purchase` instead. This type alias will be removed in v2.9.0.
  */
-export type ProductPurchaseIos = ProductPurchaseIOS;
-
-// Union type for platform-specific purchase types (legacy support)
-export type ProductPurchase =
-  | (ProductPurchaseAndroid & AndroidPlatform)
-  | (ProductPurchaseIOS & IosPlatform);
-
-// Union type for platform-specific subscription purchase types (legacy support)
-export type SubscriptionPurchase =
-  | (ProductPurchaseAndroid & AndroidPlatform & {autoRenewingAndroid: boolean})
-  | (ProductPurchaseIOS & IosPlatform);
-
-export type Purchase = ProductPurchase | SubscriptionPurchase;
+export type ProductPurchase = Purchase;
+/**
+ * @deprecated Use `Purchase` instead. This type alias will be removed in v2.9.0.
+ */
+export type SubscriptionPurchase = Purchase;
 
-// Legacy result type
 export type PurchaseResult = {
   responseCode?: number;
   debugMessage?: string;
@@ -310,7 +321,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 +339,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 +375,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 +383,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 +398,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

@@ -18,16 +18,14 @@ import {
 // Types
 import {
   Product,
-  ProductPurchase,
   Purchase,
   PurchaseError,
   PurchaseResult,
   RequestSubscriptionProps,
   RequestPurchaseProps,
   SubscriptionProduct,
-  SubscriptionPurchase,
 } from './ExpoIap.types';
-import {ProductPurchaseAndroid} from './types/ExpoIapAndroid.types';
+import {PurchaseAndroid} from './types/ExpoIapAndroid.types';
 import {PaymentDiscount} from './types/ExpoIapIOS.types';
 
 // Export all types
@@ -281,7 +279,7 @@ export const getPurchaseHistory = ({
 }: {
   alsoPublishToEventListener?: boolean;
   onlyIncludeActiveItems?: boolean;
-} = {}): Promise<ProductPurchase[]> => {
+} = {}): Promise<Purchase[]> => {
   console.warn(
     '`getPurchaseHistory` is deprecated. Use `getPurchaseHistories` instead. This function will be removed in version 3.0.0.',
   );
@@ -297,7 +295,7 @@ export const getPurchaseHistories = ({
 }: {
   alsoPublishToEventListener?: boolean;
   onlyIncludeActiveItems?: boolean;
-} = {}): Promise<ProductPurchase[]> =>
+} = {}): Promise<Purchase[]> =>
   (
     Platform.select({
       ios: async () => {
@@ -323,7 +321,7 @@ export const getAvailablePurchases = ({
 }: {
   alsoPublishToEventListener?: boolean;
   onlyIncludeActiveItems?: boolean;
-} = {}): Promise<ProductPurchase[]> =>
+} = {}): Promise<Purchase[]> =>
   (
     Platform.select({
       ios: () =>
@@ -409,13 +407,7 @@ const normalizeRequestProps = (
  */
 export const requestPurchase = (
   requestObj: PurchaseRequest,
-): Promise<
-  | ProductPurchase
-  | SubscriptionPurchase
-  | ProductPurchase[]
-  | SubscriptionPurchase[]
-  | void
-> => {
+): Promise<Purchase | Purchase[] | void> => {
   const {request, type = 'inapp'} = requestObj;
 
   if (Platform.OS === 'ios') {
@@ -429,7 +421,7 @@ export const requestPurchase = (
 
     const {
       sku,
-      andDangerouslyFinishTransactionAutomaticallyIOS = false,
+      andDangerouslyFinishTransactionAutomatically = false,
       appAccountToken,
       quantity,
       withOffer,
@@ -439,15 +431,13 @@ export const requestPurchase = (
       const offer = offerToRecordIOS(withOffer);
       const purchase = await ExpoIapModule.buyProduct(
         sku,
-        andDangerouslyFinishTransactionAutomaticallyIOS,
+        andDangerouslyFinishTransactionAutomatically,
         appAccountToken,
         quantity ?? -1,
         offer,
       );
 
-      return type === 'inapp'
-        ? (purchase as ProductPurchase)
-        : (purchase as SubscriptionPurchase);
+      return type === 'inapp' ? (purchase as Purchase) : (purchase as Purchase);
     })();
   }
 
@@ -478,7 +468,7 @@ export const requestPurchase = (
           obfuscatedProfileId: obfuscatedProfileIdAndroid,
           offerTokenArr: [],
           isOfferPersonalized: isOfferPersonalized ?? false,
-        }) as Promise<ProductPurchase[]>;
+        }) as Promise<Purchase[]>;
       })();
     }
 
@@ -504,7 +494,7 @@ export const requestPurchase = (
           obfuscatedProfileId: obfuscatedProfileIdAndroid,
           offerTokenArr: subscriptionOffers.map((so: any) => so.offerToken),
           isOfferPersonalized: isOfferPersonalized ?? false,
-        }) as Promise<SubscriptionPurchase[]>;
+        }) as Promise<Purchase[]>;
       })();
     }
 
@@ -543,13 +533,13 @@ export const requestPurchase = (
  */
 export const requestSubscription = async (
   request: RequestSubscriptionProps,
-): Promise<SubscriptionPurchase | SubscriptionPurchase[] | null | void> => {
+): Promise<Purchase | Purchase[] | null | void> => {
   console.warn(
     "`requestSubscription` is deprecated and will be removed in version 3.0.0. Use `requestPurchase({ request, type: 'subs' })` instead.",
   );
   return (await requestPurchase({request, type: 'subs'})) as
-    | SubscriptionPurchase
-    | SubscriptionPurchase[]
+    | Purchase
+    | Purchase[]
     | null
     | void;
 };
@@ -574,7 +564,7 @@ export const finishTransaction = ({
         return Promise.resolve(true);
       },
       android: async () => {
-        const androidPurchase = purchase as ProductPurchaseAndroid;
+        const androidPurchase = purchase as PurchaseAndroid;
 
         if (isConsumable) {
           return ExpoIapModule.consumeProduct(androidPurchase.purchaseToken);

package/src/modules/ios.ts

@@ -5,12 +5,7 @@ import {purchaseUpdatedListener} from '..';
 import ExpoIapModule from '../ExpoIapModule';
 
 // Types
-import {
-  ProductPurchase,
-  PurchaseError,
-  Purchase,
-  SubscriptionPurchase,
-} from '../ExpoIap.types';
+import {Purchase, PurchaseError} from '../ExpoIap.types';
 import type {
   ProductStatusIOS,
   AppTransactionIOS,
@@ -18,7 +13,7 @@ import type {
 import {Linking} from 'react-native';
 
 export type TransactionEvent = {
-  transaction?: ProductPurchase;
+  transaction?: Purchase;
   error?: PurchaseError;
 };
 
@@ -39,7 +34,7 @@ export type TransactionEvent = {
 export const transactionUpdatedIOS = (
   listener: (event: TransactionEvent) => void,
 ) => {
-  const isProductPurchase = (item: unknown): item is ProductPurchase => {
+  const isPurchase = (item: unknown): item is Purchase => {
     return (
       item != null &&
       typeof item === 'object' &&
@@ -51,18 +46,18 @@ export const transactionUpdatedIOS = (
 
   // Helper function to safely convert Purchase to TransactionEvent
   const mapPurchaseToTransactionEvent = (
-    purchase: Purchase | SubscriptionPurchase,
+    purchase: Purchase,
   ): TransactionEvent => {
     // Validate the purchase object before casting
-    if (isProductPurchase(purchase)) {
+    if (isPurchase(purchase)) {
       return {
-        transaction: purchase as ProductPurchase,
+        transaction: purchase as Purchase,
       };
     }
 
     // Fallback: create a basic TransactionEvent structure
     return {
-      transaction: purchase as ProductPurchase,
+      transaction: purchase as Purchase,
     };
   };
 
@@ -138,9 +133,7 @@ export const subscriptionStatusIOS = (
  *
  * @platform iOS
  */
-export const currentEntitlementIOS = (
-  sku: string,
-): Promise<ProductPurchase> => {
+export const currentEntitlementIOS = (sku: string): Promise<Purchase> => {
   return ExpoIapModule.currentEntitlement(sku);
 };
 
@@ -153,7 +146,7 @@ export const currentEntitlementIOS = (
  *
  * @platform iOS
  */
-export const latestTransactionIOS = (sku: string): Promise<ProductPurchase> => {
+export const latestTransactionIOS = (sku: string): Promise<Purchase> => {
   return ExpoIapModule.latestTransaction(sku);
 };
 
@@ -241,7 +234,7 @@ export const getTransactionJwsIOS = (sku: string): Promise<string> => {
  *   isValid: boolean;
  *   receiptData: string;
  *   jwsRepresentation: string;
- *   latestTransaction?: ProductPurchase;
+ *   latestTransaction?: Purchase;
  * }>}
  */
 export const validateReceiptIOS = async (
@@ -250,7 +243,7 @@ export const validateReceiptIOS = async (
   isValid: boolean;
   receiptData: string;
   jwsRepresentation: string;
-  latestTransaction?: ProductPurchase;
+  latestTransaction?: Purchase;
 }> => {
   const result = await ExpoIapModule.validateReceiptIOS(sku);
   return result;
@@ -362,7 +355,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> => {
+export const currentEntitlement = (sku: string): Promise<Purchase> => {
   console.warn(
     '`currentEntitlement` is deprecated. Use `currentEntitlementIOS` instead. This function will be removed in version 3.0.0.',
   );
@@ -372,7 +365,7 @@ 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> => {
+export const latestTransaction = (sku: string): Promise<Purchase> => {
   console.warn(
     '`latestTransaction` is deprecated. Use `latestTransactionIOS` instead. This function will be removed in version 3.0.0.',
   );

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;