react-native-iap 14.6.4 → 14.7.1

package/nitrogen/generated/shared/c++/PurchaseVerificationProvider.hpp

@@ -2,7 +2,7 @@
 /// PurchaseVerificationProvider.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

package/nitrogen/generated/shared/c++/RenewalInfoIOS.hpp

@@ -2,7 +2,7 @@
 /// RenewalInfoIOS.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

package/nitrogen/generated/shared/c++/UserChoiceBillingDetails.hpp

@@ -2,7 +2,7 @@
 /// UserChoiceBillingDetails.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2025 Marc Rousavy @ Margelo
+/// Copyright © 2026 Marc Rousavy @ Margelo
 ///
 
 #pragma once

package/openiap-versions.json

@@ -1,6 +1,6 @@
 {
-  "apple": "1.3.8",
-  "google": "1.3.19",
-  "gql": "1.3.10",
+  "apple": "1.3.9",
+  "google": "1.3.21",
+  "gql": "1.3.11",
   "docs": "1.3.7"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "14.6.4",
+  "version": "14.7.1",
   "description": "React Native In-App Purchases module for iOS and Android using Nitro",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/hooks/useIAP.ts

@@ -34,6 +34,7 @@ import type {
   RequestPurchaseProps,
   RequestPurchaseResult,
   AlternativeBillingModeAndroid,
+  BillingProgramAndroid,
   UserChoiceBillingDetails,
   VerifyPurchaseProps,
   VerifyPurchaseResult,
@@ -105,7 +106,19 @@ export interface UseIapOptions {
   onPurchaseError?: (error: PurchaseError) => void;
   onPromotedProductIOS?: (product: Product) => void;
   onUserChoiceBillingAndroid?: (details: UserChoiceBillingDetails) => void;
+  /**
+   * @deprecated Use enableBillingProgramAndroid instead.
+   * - 'user-choice' → 'user-choice-billing'
+   * - 'alternative-only' → 'external-offer'
+   */
   alternativeBillingModeAndroid?: AlternativeBillingModeAndroid;
+  /**
+   * Enable a specific billing program for Android (8.2.0+)
+   * Use 'user-choice-billing' for User Choice Billing (7.0+).
+   * Use 'external-offer' for External Offer program.
+   * Use 'external-payments' for Developer Provided Billing (Japan only, 8.3.0+).
+   */
+  enableBillingProgramAndroid?: BillingProgramAndroid;
 }
 
 /**
@@ -391,14 +404,29 @@ export function useIAP(options?: UseIapOptions): UseIap {
     }
 
     // Initialize connection with config
-    const config =
-      Platform.OS === 'android' &&
-      optionsRef.current?.alternativeBillingModeAndroid
-        ? {
-            alternativeBillingModeAndroid:
-              optionsRef.current.alternativeBillingModeAndroid,
-          }
-        : undefined;
+    // Prefer enableBillingProgramAndroid over deprecated alternativeBillingModeAndroid
+    let config:
+      | {
+          enableBillingProgramAndroid?: BillingProgramAndroid;
+          alternativeBillingModeAndroid?: AlternativeBillingModeAndroid;
+        }
+      | undefined;
+
+    if (Platform.OS === 'android') {
+      if (optionsRef.current?.enableBillingProgramAndroid) {
+        config = {
+          enableBillingProgramAndroid:
+            optionsRef.current.enableBillingProgramAndroid,
+        };
+      } else if (optionsRef.current?.alternativeBillingModeAndroid) {
+        // Deprecated: use alternativeBillingModeAndroid for backwards compatibility
+        config = {
+          alternativeBillingModeAndroid:
+            optionsRef.current.alternativeBillingModeAndroid,
+        };
+      }
+    }
+
     const result = await initConnection(config);
     setConnected(result);
     if (!result) {

package/src/index.ts

@@ -1206,16 +1206,11 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
         sku: iosRequest.sku,
       };
 
-      const explicitAutoFinish =
-        iosRequest.andDangerouslyFinishTransactionAutomatically ?? undefined;
-      const autoFinish =
-        explicitAutoFinish !== undefined
-          ? explicitAutoFinish
-          : isSubs
-            ? true
-            : undefined;
-      if (autoFinish !== undefined) {
-        iosPayload.andDangerouslyFinishTransactionAutomatically = autoFinish;
+      if (
+        iosRequest.andDangerouslyFinishTransactionAutomatically !== undefined
+      ) {
+        iosPayload.andDangerouslyFinishTransactionAutomatically =
+          iosRequest.andDangerouslyFinishTransactionAutomatically;
       }
       if (iosRequest.appAccountToken) {
         iosPayload.appAccountToken = iosRequest.appAccountToken;

package/src/specs/RnIap.nitro.ts

@@ -45,12 +45,13 @@ export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon';
 // Note: Nitro requires at least 2 values for union types
 export type PurchaseVerificationProvider = 'iapkit' | 'none';
 
-// Billing Programs API types (Android 8.2.0+, 8.3.0+ for external-payments)
+// Billing Programs API types (Android 8.2.0+, 8.3.0+ for external-payments, 7.0+ for user-choice-billing)
 export type BillingProgramAndroid =
   | 'unspecified'
   | 'external-content-link'
   | 'external-offer'
-  | 'external-payments';
+  | 'external-payments'
+  | 'user-choice-billing';
 
 // Developer Billing Launch Mode (Android 8.3.0+)
 export type DeveloperBillingLaunchModeAndroid =

package/src/types.ts

@@ -39,6 +39,8 @@ export interface ActiveSubscription {
 /**
  * Alternative billing mode for Android
  * Controls which billing system is used
+ * @deprecated Use enableBillingProgramAndroid with BillingProgramAndroid instead.
+ * Use USER_CHOICE_BILLING for user choice billing, EXTERNAL_OFFER for alternative only.
  */
 export type AlternativeBillingModeAndroid = 'none' | 'user-choice' | 'alternative-only';
 
@@ -69,7 +71,7 @@ export interface AppTransaction {
  * Billing program types for external content links, external offers, and external payments (Android)
  * Available in Google Play Billing Library 8.2.0+, EXTERNAL_PAYMENTS added in 8.3.0
  */
-export type BillingProgramAndroid = 'unspecified' | 'external-content-link' | 'external-offer' | 'external-payments';
+export type BillingProgramAndroid = 'unspecified' | 'user-choice-billing' | 'external-content-link' | 'external-offer' | 'external-payments';
 
 /**
  * Result of checking billing program availability (Android)
@@ -97,16 +99,6 @@ export interface BillingProgramReportingDetailsAndroid {
   externalTransactionToken: string;
 }
 
-/**
- * Parameters for creating billing program reporting details (Android)
- * Used with createBillingProgramReportingDetailsAsync
- * Available in Google Play Billing Library 8.3.0+
- */
-export interface BillingProgramReportingDetailsParamsAndroid {
-  /** The billing program to create reporting details for */
-  billingProgram: BillingProgramAndroid;
-}
-
 export interface DeepLinkOptions {
   /** Android package name to target (required on Android) */
   packageNameAndroid?: (string | null);
@@ -329,12 +321,17 @@ export interface InitConnectionConfig {
   /**
    * Alternative billing mode for Android
    * If not specified, defaults to NONE (standard Google Play billing)
+   * @deprecated Use enableBillingProgramAndroid instead.
+   * Use USER_CHOICE_BILLING for user choice billing, EXTERNAL_OFFER for alternative only.
    */
   alternativeBillingModeAndroid?: (AlternativeBillingModeAndroid | null);
   /**
-   * Enable a specific billing program for Android (8.2.0+)
+   * Enable a specific billing program for Android (7.0+)
    * When set, enables the specified billing program for external transactions.
-   * Use 'external-payments' for Developer Provided Billing (Japan only, 8.3.0+).
+   * - USER_CHOICE_BILLING: User can select between Google Play or alternative (7.0+)
+   * - EXTERNAL_CONTENT_LINK: Link to external content (8.2.0+)
+   * - EXTERNAL_OFFER: External offers for digital content (8.2.0+)
+   * - EXTERNAL_PAYMENTS: Developer provided billing, Japan only (8.3.0+)
    */
   enableBillingProgramAndroid?: (BillingProgramAndroid | null);
 }
@@ -829,7 +826,7 @@ export interface PurchaseOptions {
   onlyIncludeActiveItemsIOS?: (boolean | null);
 }
 
-export type PurchaseState = 'pending' | 'purchased' | 'failed' | 'restored' | 'deferred' | 'unknown';
+export type PurchaseState = 'pending' | 'purchased' | 'unknown';
 
 export type PurchaseVerificationProvider = 'iapkit';
 

package/src/utils/type-bridge.ts

@@ -37,11 +37,8 @@ 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';
-const PURCHASE_STATE_FAILED: PurchaseState = 'failed';
 const PURCHASE_STATE_PENDING: PurchaseState = 'pending';
 const PURCHASE_STATE_PURCHASED: PurchaseState = 'purchased';
-const PURCHASE_STATE_RESTORED: PurchaseState = 'restored';
 const PURCHASE_STATE_UNKNOWN: PurchaseState = 'unknown';
 const PAYMENT_MODE_EMPTY: PaymentModeIOS = 'empty';
 const PAYMENT_MODE_FREE_TRIAL: PaymentModeIOS = 'free-trial';
@@ -147,15 +144,11 @@ function normalizePurchaseState(state: unknown): PurchaseState {
   if (typeof state === 'string') {
     switch (state.toLowerCase()) {
       case PURCHASE_STATE_PURCHASED:
+      case 'restored': // Restored purchases are treated as purchased
         return PURCHASE_STATE_PURCHASED;
       case PURCHASE_STATE_PENDING:
+      case 'deferred': // Deferred is treated as pending
         return PURCHASE_STATE_PENDING;
-      case PURCHASE_STATE_FAILED:
-        return PURCHASE_STATE_FAILED;
-      case PURCHASE_STATE_RESTORED:
-        return PURCHASE_STATE_RESTORED;
-      case PURCHASE_STATE_DEFERRED:
-        return PURCHASE_STATE_DEFERRED;
       default:
         return PURCHASE_STATE_UNKNOWN;
     }