react-native-iap 15.4.0-rc.3 → 15.4.1

package/src/hooks/useIAP.ts

@@ -24,7 +24,14 @@ import {
   checkAlternativeBillingAvailabilityAndroid,
   showAlternativeBillingDialogAndroid,
   createAlternativeBillingTokenAndroid,
+  getBillingChoiceInfoAndroid,
+  isBillingProgramAvailableAndroid,
+  createBillingProgramReportingDetailsAndroid,
+  launchExternalLinkAndroid,
+  showBillingProgramInformationDialogAndroid,
+  showInAppMessagesAndroid,
   userChoiceBillingListenerAndroid,
+  developerProvidedBillingListenerAndroid,
   subscriptionBillingIssueListener,
   isStandardIOS,
 } from '../';
@@ -35,7 +42,9 @@ import type {
   ProductQueryType,
   RequestPurchaseProps,
   AlternativeBillingModeAndroid,
+  BillingChoiceScreenTypeAndroid,
   BillingProgramAndroid,
+  DeveloperProvidedBillingDetailsAndroid,
   UserChoiceBillingDetails,
   VerifyPurchaseProps,
   VerifyPurchaseResult,
@@ -50,6 +59,8 @@ import type {
   PurchaseError,
   PurchaseUpdatedListenerOptions,
   ProductSubscription,
+  MutationField,
+  QueryField,
 } from '../types';
 import type {MutationFinishTransactionArgs} from '../types';
 
@@ -265,6 +276,18 @@ type UseIap = {
   createAlternativeBillingTokenAndroid?: (
     sku?: string,
   ) => Promise<string | null>;
+  /** Fetch assets and loyalty text for a developer-rendered Billing Choice screen. */
+  getBillingChoiceInfoAndroid?: QueryField<'getBillingChoiceInfoAndroid'>;
+  /** Check Billing Program availability and the configured choice renderer. */
+  isBillingProgramAvailableAndroid?: MutationField<'isBillingProgramAvailableAndroid'>;
+  /** Create Google Play reporting details for a developer billing transaction. */
+  createBillingProgramReportingDetailsAndroid?: MutationField<'createBillingProgramReportingDetailsAndroid'>;
+  /** Launch a supported Billing Program external link. */
+  launchExternalLinkAndroid?: MutationField<'launchExternalLinkAndroid'>;
+  /** Show the required Billing Choice information dialog. */
+  showBillingProgramInformationDialogAndroid?: MutationField<'showBillingProgramInformationDialogAndroid'>;
+  /** Show Play billing in-app messages. */
+  showInAppMessagesAndroid?: MutationField<'showInAppMessagesAndroid'>;
 };
 
 export interface UseIapOptions {
@@ -281,9 +304,16 @@ export interface UseIapOptions {
   onPromotedProductIOS?: (product: Product) => void;
   onUserChoiceBillingAndroid?: (details: UserChoiceBillingDetails) => void;
   /**
-   * Fires when an active subscription enters a billing-issue state
-   * (StoreKit 2 Message.billingIssue on iOS 18+, Purchase.isSuspended on
-   * Play Billing 8.1+). Not invoked on Meta Horizon.
+   * Fires when the user selects developer-provided billing in an External
+   * Payments or Google-rendered Billing Choice flow.
+   */
+  onDeveloperProvidedBillingAndroid?: (
+    details: DeveloperProvidedBillingDetailsAndroid,
+  ) => void;
+  /**
+   * Fires when a subscription enters a billing-issue state
+   * (StoreKit 2 Message.billingIssue on iOS / Mac Catalyst 16.4+ and visionOS 1.0+, Purchase.isSuspended on
+   * Play Billing 8.1+). Not invoked on Meta Horizon or Amazon Appstore.
    *
    * Recommended: call deepLinkToSubscriptions on the returned purchase so
    * the user can update their payment method in the platform subscription
@@ -301,8 +331,14 @@ export interface UseIapOptions {
    * 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+).
+   * Use 'billing-choice' for Billing Choice (9.1.0+).
    */
   enableBillingProgramAndroid?: BillingProgramAndroid;
+  /**
+   * Select who renders the Billing Choice screen (9.1.0+). Must match the
+   * choiceScreenType returned by isBillingProgramAvailableAndroid.
+   */
+  billingChoiceScreenTypeAndroid?: BillingChoiceScreenTypeAndroid;
 }
 
 /**
@@ -356,6 +392,7 @@ export function useIAP(options?: UseIapOptions): UseIap {
     purchaseError?: EventSubscription;
     promotedProductIOS?: EventSubscription;
     userChoiceBillingAndroid?: EventSubscription;
+    developerProvidedBillingAndroid?: EventSubscription;
     subscriptionBillingIssue?: EventSubscription;
   }>({});
 
@@ -398,7 +435,10 @@ export function useIAP(options?: UseIapOptions): UseIap {
           skus: params.skus,
           type: requestType,
         });
-        RnIapConsole.debug('[useIAP] fetchProducts result:', result);
+        RnIapConsole.debug(
+          '[useIAP] fetchProducts count:',
+          result?.length ?? 0,
+        );
         const items = (result ?? []) as (Product | ProductSubscription)[];
 
         // fetchProducts already returns properly filtered results based on type
@@ -565,6 +605,7 @@ export function useIAP(options?: UseIapOptions): UseIap {
       | {
           enableBillingProgramAndroid?: BillingProgramAndroid;
           alternativeBillingModeAndroid?: AlternativeBillingModeAndroid;
+          billingChoiceScreenTypeAndroid?: BillingChoiceScreenTypeAndroid;
         }
       | undefined;
 
@@ -573,6 +614,12 @@ export function useIAP(options?: UseIapOptions): UseIap {
         config = {
           enableBillingProgramAndroid:
             optionsRef.current.enableBillingProgramAndroid,
+          ...(optionsRef.current.billingChoiceScreenTypeAndroid
+            ? {
+                billingChoiceScreenTypeAndroid:
+                  optionsRef.current.billingChoiceScreenTypeAndroid,
+              }
+            : {}),
         };
       } else if (optionsRef.current?.alternativeBillingModeAndroid) {
         config = {
@@ -644,6 +691,17 @@ export function useIAP(options?: UseIapOptions): UseIap {
         });
     }
 
+    if (
+      Platform.OS === 'android' &&
+      optionsRef.current?.onDeveloperProvidedBillingAndroid &&
+      !subscriptionsRef.current.developerProvidedBillingAndroid
+    ) {
+      subscriptionsRef.current.developerProvidedBillingAndroid =
+        developerProvidedBillingListenerAndroid((details) => {
+          optionsRef.current?.onDeveloperProvidedBillingAndroid?.(details);
+        });
+    }
+
     // Always attach so callers that supply `onSubscriptionBillingIssue` later
     // (after the hook has already set up listeners) still receive events.
     if (!subscriptionsRef.current.subscriptionBillingIssue) {
@@ -660,11 +718,13 @@ export function useIAP(options?: UseIapOptions): UseIap {
     subscriptionsRef.current.purchaseError?.remove();
     subscriptionsRef.current.promotedProductIOS?.remove();
     subscriptionsRef.current.userChoiceBillingAndroid?.remove();
+    subscriptionsRef.current.developerProvidedBillingAndroid?.remove();
     subscriptionsRef.current.subscriptionBillingIssue?.remove();
     subscriptionsRef.current.purchaseUpdate = undefined;
     subscriptionsRef.current.purchaseError = undefined;
     subscriptionsRef.current.promotedProductIOS = undefined;
     subscriptionsRef.current.userChoiceBillingAndroid = undefined;
+    subscriptionsRef.current.developerProvidedBillingAndroid = undefined;
     subscriptionsRef.current.subscriptionBillingIssue = undefined;
   }, []);
 
@@ -763,6 +823,12 @@ export function useIAP(options?: UseIapOptions): UseIap {
           checkAlternativeBillingAvailabilityAndroid,
           showAlternativeBillingDialogAndroid,
           createAlternativeBillingTokenAndroid,
+          getBillingChoiceInfoAndroid,
+          isBillingProgramAvailableAndroid,
+          createBillingProgramReportingDetailsAndroid,
+          launchExternalLinkAndroid,
+          showBillingProgramInformationDialogAndroid,
+          showInAppMessagesAndroid,
         }
       : {}),
   };

package/src/index.kepler.ts

@@ -293,12 +293,21 @@ export const createAlternativeBillingTokenAndroid: MutationField<
 export const isBillingProgramAvailableAndroid: MutationField<
   'isBillingProgramAvailableAndroid'
 > = async () => unsupported('isBillingProgramAvailableAndroid');
+export const getBillingChoiceInfoAndroid: QueryField<
+  'getBillingChoiceInfoAndroid'
+> = async () => unsupported('getBillingChoiceInfoAndroid');
 export const launchExternalLinkAndroid: MutationField<
   'launchExternalLinkAndroid'
 > = async () => unsupported('launchExternalLinkAndroid');
 export const createBillingProgramReportingDetailsAndroid: MutationField<
   'createBillingProgramReportingDetailsAndroid'
 > = async () => unsupported('createBillingProgramReportingDetailsAndroid');
+export const showBillingProgramInformationDialogAndroid: MutationField<
+  'showBillingProgramInformationDialogAndroid'
+> = async () => unsupported('showBillingProgramInformationDialogAndroid');
+export const showInAppMessagesAndroid: MutationField<
+  'showInAppMessagesAndroid'
+> = async () => unsupported('showInAppMessagesAndroid');
 export const userChoiceBillingListenerAndroid = (): EventSubscription => ({
   remove: () => {},
 });