react-native-iap 14.4.47 → 14.5.1-rc.1

package/src/types.ts

@@ -72,6 +72,34 @@ export interface DeepLinkOptions {
   skuAndroid?: (string | null);
 }
 
+/**
+ * Discount amount details for one-time purchase offers (Android)
+ * Available in Google Play Billing Library 7.0+
+ */
+export interface DiscountAmountAndroid {
+  /** Discount amount in micro-units (1,000,000 = 1 unit of currency) */
+  discountAmountMicros: string;
+  /** Formatted discount amount with currency sign (e.g., "$4.99") */
+  formattedDiscountAmount: string;
+}
+
+/**
+ * Discount display information for one-time purchase offers (Android)
+ * Available in Google Play Billing Library 7.0+
+ */
+export interface DiscountDisplayInfoAndroid {
+  /**
+   * Absolute discount amount details
+   * Only returned for fixed amount discounts
+   */
+  discountAmount?: (DiscountAmountAndroid | null);
+  /**
+   * Percentage discount (e.g., 33 for 33% off)
+   * Only returned for percentage-based discounts
+   */
+  percentageDiscount?: (number | null);
+}
+
 export interface DiscountIOS {
   identifier: string;
   localizedPrice?: (string | null);
@@ -180,11 +208,11 @@ export type IapEvent = 'purchase-updated' | 'purchase-error' | 'promoted-product
 
 export type IapPlatform = 'ios' | 'android';
 
+export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon';
+
 /** Unified purchase states from IAPKit verification response. */
 export type IapkitPurchaseState = 'entitled' | 'pending-acknowledgment' | 'pending' | 'canceled' | 'expired' | 'ready-to-consume' | 'consumed' | 'unknown' | 'inauthentic';
 
-export type IapkitStore = 'apple' | 'google';
-
 /** Connection initialization configuration */
 export interface InitConnectionConfig {
   /**
@@ -194,6 +222,17 @@ export interface InitConnectionConfig {
   alternativeBillingModeAndroid?: (AlternativeBillingModeAndroid | null);
 }
 
+/**
+ * Limited quantity information for one-time purchase offers (Android)
+ * Available in Google Play Billing Library 7.0+
+ */
+export interface LimitedQuantityInfoAndroid {
+  /** Maximum quantity a user can purchase */
+  maximumQuantity: number;
+  /** Remaining quantity the user can still purchase */
+  remainingQuantity: number;
+}
+
 export interface Mutation {
   /** Acknowledge a non-consumable purchase or subscription */
   acknowledgePurchaseAndroid: Promise<boolean>;
@@ -310,6 +349,23 @@ export type MutationVerifyPurchaseWithProviderArgs = VerifyPurchaseWithProviderP
 
 export type PaymentModeIOS = 'empty' | 'free-trial' | 'pay-as-you-go' | 'pay-up-front';
 
+/**
+ * Pre-order details for one-time purchase products (Android)
+ * Available in Google Play Billing Library 8.1.0+
+ */
+export interface PreorderDetailsAndroid {
+  /**
+   * Pre-order presale end time in milliseconds since epoch.
+   * This is when the presale period ends and the product will be released.
+   */
+  preorderPresaleEndTimeMillis: string;
+  /**
+   * Pre-order release time in milliseconds since epoch.
+   * This is when the product will be available to users who pre-ordered.
+   */
+  preorderReleaseTimeMillis: string;
+}
+
 export interface PricingPhaseAndroid {
   billingCycleCount: number;
   billingPeriod: string;
@@ -333,7 +389,11 @@ export interface ProductAndroid extends ProductCommon {
   displayPrice: string;
   id: string;
   nameAndroid: string;
-  oneTimePurchaseOfferDetailsAndroid?: (ProductAndroidOneTimePurchaseOfferDetail | null);
+  /**
+   * One-time purchase offer details including discounts (Android)
+   * Returns all eligible offers. Available in Google Play Billing Library 7.0+
+   */
+  oneTimePurchaseOfferDetailsAndroid?: (ProductAndroidOneTimePurchaseOfferDetail[] | null);
   platform: 'android';
   price?: (number | null);
   subscriptionOfferDetailsAndroid?: (ProductSubscriptionAndroidOfferDetails[] | null);
@@ -341,10 +401,41 @@ export interface ProductAndroid extends ProductCommon {
   type: 'in-app';
 }
 
+/**
+ * One-time purchase offer details (Android)
+ * Available in Google Play Billing Library 7.0+
+ */
 export interface ProductAndroidOneTimePurchaseOfferDetail {
+  /**
+   * Discount display information
+   * Only available for discounted offers
+   */
+  discountDisplayInfo?: (DiscountDisplayInfoAndroid | null);
   formattedPrice: string;
+  /**
+   * Full (non-discounted) price in micro-units
+   * Only available for discounted offers
+   */
+  fullPriceMicros?: (string | null);
+  /** Limited quantity information */
+  limitedQuantityInfo?: (LimitedQuantityInfoAndroid | null);
+  /** Offer ID */
+  offerId?: (string | null);
+  /** List of offer tags */
+  offerTags: string[];
+  /** Offer token for use in BillingFlowParams when purchasing */
+  offerToken: string;
+  /**
+   * Pre-order details for products available for pre-order
+   * Available in Google Play Billing Library 8.1.0+
+   */
+  preorderDetailsAndroid?: (PreorderDetailsAndroid | null);
   priceAmountMicros: string;
   priceCurrencyCode: string;
+  /** Rental details for rental offers */
+  rentalDetailsAndroid?: (RentalDetailsAndroid | null);
+  /** Valid time window for the offer */
+  validTimeWindow?: (ValidTimeWindowAndroid | null);
 }
 
 export interface ProductCommon {
@@ -397,7 +488,11 @@ export interface ProductSubscriptionAndroid extends ProductCommon {
   displayPrice: string;
   id: string;
   nameAndroid: string;
-  oneTimePurchaseOfferDetailsAndroid?: (ProductAndroidOneTimePurchaseOfferDetail | null);
+  /**
+   * One-time purchase offer details including discounts (Android)
+   * Returns all eligible offers. Available in Google Play Billing Library 7.0+
+   */
+  oneTimePurchaseOfferDetailsAndroid?: (ProductAndroidOneTimePurchaseOfferDetail[] | null);
   platform: 'android';
   price?: (number | null);
   subscriptionOfferDetailsAndroid: ProductSubscriptionAndroidOfferDetails[];
@@ -454,15 +549,26 @@ export interface PurchaseAndroid extends PurchaseCommon {
   ids?: (string[] | null);
   isAcknowledgedAndroid?: (boolean | null);
   isAutoRenewing: boolean;
+  /**
+   * Whether the subscription is suspended (Android)
+   * A suspended subscription means the user's payment method failed and they need to fix it.
+   * Users should be directed to the subscription center to resolve the issue.
+   * Do NOT grant entitlements for suspended subscriptions.
+   * Available in Google Play Billing Library 8.1.0+
+   */
+  isSuspendedAndroid?: (boolean | null);
   obfuscatedAccountIdAndroid?: (string | null);
   obfuscatedProfileIdAndroid?: (string | null);
   packageNameAndroid?: (string | null);
+  /** @deprecated Use store instead */
   platform: IapPlatform;
   productId: string;
   purchaseState: PurchaseState;
   purchaseToken?: (string | null);
   quantity: number;
   signatureAndroid?: (string | null);
+  /** Store where purchase was made */
+  store: IapStore;
   transactionDate: number;
   transactionId?: (string | null);
 }
@@ -478,12 +584,15 @@ export interface PurchaseCommon {
   id: string;
   ids?: (string[] | null);
   isAutoRenewing: boolean;
+  /** @deprecated Use store instead */
   platform: IapPlatform;
   productId: string;
   purchaseState: PurchaseState;
   /** Unified purchase token (iOS JWS, Android purchaseToken) */
   purchaseToken?: (string | null);
   quantity: number;
+  /** Store where purchase was made */
+  store: IapStore;
   transactionDate: number;
 }
 
@@ -510,6 +619,7 @@ export interface PurchaseIOS extends PurchaseCommon {
   originalTransactionDateIOS?: (number | null);
   originalTransactionIdentifierIOS?: (string | null);
   ownershipTypeIOS?: (string | null);
+  /** @deprecated Use store instead */
   platform: IapPlatform;
   productId: string;
   purchaseState: PurchaseState;
@@ -521,6 +631,8 @@ export interface PurchaseIOS extends PurchaseCommon {
   renewalInfoIOS?: (RenewalInfoIOS | null);
   revocationDateIOS?: (number | null);
   revocationReasonIOS?: (string | null);
+  /** Store where purchase was made */
+  store: IapStore;
   storefrontCountryCodeIOS?: (string | null);
   subscriptionGroupIdIOS?: (string | null);
   transactionDate: number;
@@ -669,6 +781,20 @@ export interface RenewalInfoIOS {
   willAutoRenew: boolean;
 }
 
+/**
+ * Rental details for one-time purchase products that can be rented (Android)
+ * Available in Google Play Billing Library 7.0+
+ */
+export interface RentalDetailsAndroid {
+  /**
+   * Rental expiration period in ISO 8601 format
+   * Time after rental period ends when user can still extend
+   */
+  rentalExpirationPeriod?: (string | null);
+  /** Rental period in ISO 8601 format (e.g., P7D for 7 days) */
+  rentalPeriod: string;
+}
+
 export interface RequestPurchaseAndroidProps {
   /** Personalized offer flag */
   isOfferPersonalized?: (boolean | null);
@@ -710,9 +836,13 @@ export type RequestPurchaseProps =
     };
 
 export interface RequestPurchasePropsByPlatforms {
-  /** Android-specific purchase parameters */
+  /** @deprecated Use google instead */
   android?: (RequestPurchaseAndroidProps | null);
-  /** iOS-specific purchase parameters */
+  /** Apple-specific purchase parameters */
+  apple?: (RequestPurchaseIosProps | null);
+  /** Google-specific purchase parameters */
+  google?: (RequestPurchaseAndroidProps | null);
+  /** @deprecated Use apple instead */
   ios?: (RequestPurchaseIosProps | null);
 }
 
@@ -744,9 +874,13 @@ export interface RequestSubscriptionIosProps {
 }
 
 export interface RequestSubscriptionPropsByPlatforms {
-  /** Android-specific subscription parameters */
+  /** @deprecated Use google instead */
   android?: (RequestSubscriptionAndroidProps | null);
-  /** iOS-specific subscription parameters */
+  /** Apple-specific subscription parameters */
+  apple?: (RequestSubscriptionIosProps | null);
+  /** Google-specific subscription parameters */
+  google?: (RequestSubscriptionAndroidProps | null);
+  /** @deprecated Use apple instead */
   ios?: (RequestSubscriptionIosProps | null);
 }
 
@@ -774,7 +908,7 @@ export interface RequestVerifyPurchaseWithIapkitResult {
   isValid: boolean;
   /** The current state of the purchase. */
   state: IapkitPurchaseState;
-  store: IapkitStore;
+  store: IapStore;
 }
 
 export interface Subscription {
@@ -834,6 +968,17 @@ export interface UserChoiceBillingDetails {
   products: string[];
 }
 
+/**
+ * Valid time window for when an offer is available (Android)
+ * Available in Google Play Billing Library 7.0+
+ */
+export interface ValidTimeWindowAndroid {
+  /** End time in milliseconds since epoch */
+  endTimeMillis: string;
+  /** Start time in milliseconds since epoch */
+  startTimeMillis: string;
+}
+
 export interface VerifyPurchaseAndroidOptions {
   accessToken: string;
   isSub?: (boolean | null);
@@ -882,14 +1027,21 @@ export interface VerifyPurchaseResultIOS {
   receiptData: string;
 }
 
+export interface VerifyPurchaseWithProviderError {
+  code?: (string | null);
+  message: string;
+}
+
 export interface VerifyPurchaseWithProviderProps {
   iapkit?: (RequestVerifyPurchaseWithIapkitProps | null);
   provider: PurchaseVerificationProvider;
 }
 
 export interface VerifyPurchaseWithProviderResult {
-  /** IAPKit verification results (can include Apple and Google entries) */
-  iapkit: RequestVerifyPurchaseWithIapkitResult[];
+  /** Error details if verification failed */
+  errors?: (VerifyPurchaseWithProviderError[] | null);
+  /** IAPKit verification result */
+  iapkit?: (RequestVerifyPurchaseWithIapkitResult | null);
   provider: PurchaseVerificationProvider;
 }
 

package/src/utils/type-bridge.ts

@@ -12,6 +12,7 @@ import type {
 } from '../specs/RnIap.nitro';
 import type {
   IapPlatform,
+  IapStore,
   PaymentModeIOS,
   ProductType,
   ProductTypeIOS,
@@ -30,6 +31,10 @@ import {RnIapConsole} from './debug';
 
 const PLATFORM_IOS: IapPlatform = 'ios';
 const PLATFORM_ANDROID: IapPlatform = 'android';
+const STORE_UNKNOWN: IapStore = 'unknown';
+const STORE_APPLE: IapStore = 'apple';
+const STORE_GOOGLE: IapStore = 'google';
+const STORE_HORIZON: IapStore = 'horizon';
 const PRODUCT_TYPE_SUBS: ProductType = 'subs';
 const PRODUCT_TYPE_IN_APP: ProductType = 'in-app';
 const PURCHASE_STATE_DEFERRED: PurchaseState = 'deferred';
@@ -57,6 +62,19 @@ function normalizePlatform(value?: Nullable<string>): IapPlatform {
     : PLATFORM_ANDROID;
 }
 
+function normalizeStore(value?: Nullable<string>): IapStore {
+  switch (value?.toLowerCase()) {
+    case 'apple':
+      return STORE_APPLE;
+    case 'google':
+      return STORE_GOOGLE;
+    case 'horizon':
+      return STORE_HORIZON;
+    default:
+      return STORE_UNKNOWN;
+  }
+}
+
 function normalizeProductType(value?: Nullable<string>): ProductType {
   return value?.toLowerCase() === PRODUCT_TYPE_SUBS
     ? PRODUCT_TYPE_SUBS
@@ -332,6 +350,8 @@ export function convertNitroPurchaseToPurchase(
     purchaseState = normalizePurchaseState(nitroPurchase.purchaseStateAndroid);
   }
 
+  const store = normalizeStore(nitroPurchase.store);
+
   if (platform === PLATFORM_IOS) {
     const iosPurchase: PurchaseIOS = {
       id: nitroPurchase.id,
@@ -339,6 +359,7 @@ export function convertNitroPurchaseToPurchase(
       transactionDate: nitroPurchase.transactionDate ?? Date.now(),
       purchaseToken: nitroPurchase.purchaseToken ?? null,
       platform,
+      store,
       quantity: nitroPurchase.quantity ?? 1,
       purchaseState,
       isAutoRenewing: Boolean(nitroPurchase.isAutoRenewing),
@@ -433,6 +454,7 @@ export function convertNitroPurchaseToPurchase(
     purchaseToken:
       nitroPurchase.purchaseToken ?? nitroPurchase.purchaseTokenAndroid ?? null,
     platform,
+    store,
     quantity: nitroPurchase.quantity ?? 1,
     purchaseState,
     isAutoRenewing: Boolean(nitroPurchase.isAutoRenewing),
@@ -456,6 +478,7 @@ export function convertNitroPurchaseToPurchase(
     developerPayloadAndroid: toNullableString(
       nitroPurchase.developerPayloadAndroid,
     ),
+    isSuspendedAndroid: toNullableBoolean(nitroPurchase.isSuspendedAndroid),
   };
 
   return androidPurchase;