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

package/src/specs/RnIap.nitro.ts

@@ -25,6 +25,7 @@ import type {HybridObject} from 'react-native-nitro-modules';
 // removing the types entirely.
 import type {
   ActiveSubscription,
+  AdvancedCommerceInfoIOS,
   AndroidSubscriptionOfferInput,
   DeepLinkOptions,
   InitConnectionConfig,
@@ -35,6 +36,7 @@ import type {
   ExternalPurchaseCustomLinkTokenTypeIOS,
   ExternalPurchaseLinkResultIOS,
   ExternalPurchaseNoticeResultIOS,
+  DeveloperBillingOptionParamsAndroid,
   DeveloperProvidedBillingDetailsAndroid,
   MutationFinishTransactionArgs,
   ProductCommon,
@@ -52,7 +54,12 @@ import type {
   RequestSubscriptionIosProps,
   UserChoiceBillingDetails,
   PaymentModeIOS,
+  PendingPurchaseUpdateAndroid,
+  RenewalCommitmentInfoIOS,
+  SubscriptionBillingPlanTypeIOS,
   SubscriptionProductReplacementParamsAndroid,
+  SubResponseCodeAndroid,
+  TransactionCommitmentInfoIOS,
   WinBackOfferInputIOS,
 } from '../types';
 
@@ -96,13 +103,38 @@ export type PurchaseVerificationProvider = 'iapkit' | 'none';
 
 // Billing Programs API (Android)
 // GQL type exists but defined locally for Nitro codegen consistency
-// Android 8.2.0+, 8.3.0+ for external-payments, 7.0+ for user-choice-billing
+// Android 8.2.0+, 8.3.0+ for external-payments, 9.1.0+ for billing-choice,
+// 7.0+ for user-choice-billing
 export type BillingProgramAndroid =
   | 'unspecified'
   | 'external-content-link'
   | 'external-offer'
   | 'external-payments'
-  | 'user-choice-billing';
+  | 'user-choice-billing'
+  | 'billing-choice';
+
+export type BillingChoiceImageLayoutAndroid =
+  | 'rectangular-four-by-one'
+  | 'rectangular-three-by-one'
+  | 'rectangular-two-by-two';
+
+export type BillingChoiceScreenTypeAndroid =
+  | 'unspecified'
+  | 'developer-rendered'
+  | 'google-rendered';
+
+export type DeveloperBillingTypeAndroid =
+  | 'developer-billing-type-unspecified'
+  | 'in-app'
+  | 'external-link';
+
+export type InAppMessageCategoryAndroid =
+  | 'unknown-in-app-message-category-id'
+  | 'transactional';
+
+export type InAppMessageResponseCodeAndroid =
+  | 'no-action-needed'
+  | 'subscription-status-updated';
 
 // Developer Billing Launch Mode (Android 8.3.0+)
 // Defined locally for Nitro codegen
@@ -209,7 +241,7 @@ export interface NitroRequestPurchaseAndroid {
   obfuscatedProfileId?: RequestSubscriptionAndroidProps['obfuscatedProfileId'];
   isOfferPersonalized?: RequestSubscriptionAndroidProps['isOfferPersonalized'];
   /**
-   * Offer token for one-time purchase discounts (7.0+).
+   * Offer token for one-time purchase discounts (8.0+).
    * Pass the offerToken from oneTimePurchaseOfferDetailsAndroid or discountOffers
    * to apply a discount offer to the purchase.
    */
@@ -218,6 +250,10 @@ export interface NitroRequestPurchaseAndroid {
   /** @deprecated Use subscriptionProductReplacementParams instead for item-level replacement (8.1.0+) */
   replacementMode?: RequestSubscriptionAndroidProps['replacementMode'];
   purchaseToken?: RequestSubscriptionAndroidProps['purchaseToken'];
+  /** Original external transaction ID for developer-billed subscription replacement (9.1.0+). */
+  originalExternalTransactionId?: RequestSubscriptionAndroidProps['originalExternalTransactionId'];
+  /** Developer billing option for External Payments (8.3.0+) or Billing Choice (9.1.0+). */
+  developerBillingOption?: DeveloperBillingOptionParamsAndroid | null;
   /**
    * Product-level replacement parameters (8.1.0+)
    * Use this instead of replacementMode for item-level replacement
@@ -298,8 +334,10 @@ export interface NitroDeepLinkOptionsAndroid {
  * Parameters for launching an external link (Android 8.2.0+)
  */
 export interface NitroLaunchExternalLinkParamsAndroid {
-  /** The billing program (external-content-link or external-offer) */
+  /** The billing program (external-content-link, external-offer, or billing-choice) */
   billingProgram: BillingProgramAndroid;
+  /** Reporting token for a developer-rendered Billing Choice external-link flow (9.1.0+). */
+  externalTransactionToken?: string | null;
   /** The external link launch mode */
   launchMode: ExternalLinkLaunchModeAndroid;
   /** The type of the external link */
@@ -308,29 +346,32 @@ export interface NitroLaunchExternalLinkParamsAndroid {
   linkUri: string;
 }
 
+export interface NitroGetBillingChoiceInfoParamsAndroid {
+  billingProgram: BillingProgramAndroid;
+  playBillingChoiceImageLayout: BillingChoiceImageLayoutAndroid;
+  userLocale?: string | null;
+}
+
+export interface NitroBillingProgramInformationDialogParamsAndroid {
+  billingProgram: BillingProgramAndroid;
+  externalTransactionToken: string;
+}
+
+export interface NitroInAppMessageParamsAndroid {
+  categories?: InAppMessageCategoryAndroid[] | null;
+}
+
 // ╔══════════════════════════════════════════════════════════════════════════╗
 // ║                                  TYPES                                   ║
 // ╚══════════════════════════════════════════════════════════════════════════╝
 
-/**
- * Subscription renewal information (iOS only)
- */
-export interface NitroSubscriptionRenewalInfo {
-  autoRenewStatus: boolean;
-  autoRenewPreference?: string | null;
-  expirationReason?: number | null;
-  gracePeriodExpirationDate?: number | null;
-  currentProductID?: string | null;
-  platform: string;
-}
-
 /**
  * Subscription status information (iOS only)
  */
 export interface NitroSubscriptionStatus {
   state: number;
   platform: string;
-  renewalInfo?: NitroSubscriptionRenewalInfo | null;
+  renewalInfo?: NitroRenewalInfoIOS | null;
 }
 
 /**
@@ -342,6 +383,27 @@ export interface NitroPurchaseResult {
   code: string;
   message: string;
   purchaseToken?: string;
+  productId?: string;
+  productIds?: string[];
+  productType?: string;
+  isEmptyProductList?: boolean;
+  subResponseCodeAndroid?: SubResponseCodeAndroid;
+}
+
+export interface NitroBillingResultAndroid {
+  responseCode: number;
+  debugMessage?: string | null;
+  subResponseCode?: SubResponseCodeAndroid | null;
+}
+
+export interface NitroBillingChoiceInfoAndroid {
+  playBillingChoiceImageUrl: string;
+  playBillingLoyaltyInfo?: string | null;
+}
+
+export interface NitroInAppMessageResultAndroid {
+  responseCode: InAppMessageResponseCodeAndroid;
+  purchaseToken?: string | null;
 }
 
 export interface NitroReceiptValidationResultIOS {
@@ -428,8 +490,12 @@ export interface NitroVerifyPurchaseWithProviderResult {
 export interface NitroBillingProgramAvailabilityResultAndroid {
   /** The billing program that was checked */
   billingProgram: BillingProgramAndroid;
+  /** Billing Choice screen renderer. Populated only for available Billing Choice results. */
+  choiceScreenType?: BillingChoiceScreenTypeAndroid | null;
   /** Whether the billing program is available for the user */
   isAvailable: boolean;
+  /** Whether external-link payment is available for Billing Choice. */
+  isExternalLinkAvailable?: boolean | null;
 }
 
 /**
@@ -492,7 +558,7 @@ export interface NitroValidTimeWindowAndroid {
 
 /**
  * Android one-time purchase offer details
- * Available in Google Play Billing Library 7.0+
+ * Available in Google Play Billing Library 8.0+
  */
 export interface NitroOneTimePurchaseOfferDetail {
   discountDisplayInfo?: NitroDiscountDisplayInfoAndroid | null;
@@ -505,6 +571,7 @@ export interface NitroOneTimePurchaseOfferDetail {
   preorderDetailsAndroid?: NitroPreorderDetailsAndroid | null;
   priceAmountMicros: string;
   priceCurrencyCode: string;
+  purchaseOptionId?: string | null;
   rentalDetailsAndroid?: NitroRentalDetailsAndroid | null;
   validTimeWindow?: NitroValidTimeWindowAndroid | null;
 }
@@ -514,6 +581,8 @@ export interface NitroPurchase {
   productId: PurchaseCommon['productId'];
   transactionDate: PurchaseCommon['transactionDate'];
   purchaseToken?: PurchaseCommon['purchaseToken'];
+  currentPlanId?: PurchaseCommon['currentPlanId'];
+  ids?: PurchaseCommon['ids'];
   /** @deprecated Use store instead */
   platform: IapPlatform;
   /** Store where purchase was made */
@@ -522,6 +591,9 @@ export interface NitroPurchase {
   purchaseState: PurchaseCommon['purchaseState'];
   isAutoRenewing: PurchaseCommon['isAutoRenewing'];
   // iOS specific fields
+  advancedCommerceInfoIOS?: AdvancedCommerceInfoIOS | null;
+  billingPlanTypeIOS?: SubscriptionBillingPlanTypeIOS | null;
+  commitmentInfoIOS?: TransactionCommitmentInfoIOS | null;
   quantityIOS?: number | null;
   originalTransactionDateIOS?: number | null;
   originalTransactionIdentifierIOS?: string | null;
@@ -556,6 +628,7 @@ export interface NitroPurchase {
   obfuscatedProfileIdAndroid?: string | null;
   developerPayloadAndroid?: string | null;
   isSuspendedAndroid?: boolean | null;
+  pendingPurchaseUpdateAndroid?: PendingPurchaseUpdateAndroid | null;
 }
 
 /**
@@ -587,12 +660,14 @@ export interface NitroActiveSubscription {
 export interface NitroRenewalInfoIOS {
   willAutoRenew: boolean;
   autoRenewPreference?: string | null;
+  commitmentInfo?: RenewalCommitmentInfoIOS | null;
   pendingUpgradeProductId?: string | null;
   renewalDate?: number | null;
   expirationReason?: string | null;
   isInBillingRetry?: boolean | null;
   gracePeriodExpirationDate?: number | null;
   priceIncreaseStatus?: string | null;
+  renewalBillingPlanType?: SubscriptionBillingPlanTypeIOS | null;
   renewalOfferType?: string | null;
   renewalOfferId?: string | null;
   jsonRepresentation?: string | null;
@@ -602,6 +677,7 @@ export interface NitroProduct {
   id: ProductCommon['id'];
   title: ProductCommon['title'];
   description: ProductCommon['description'];
+  debugDescription?: ProductCommon['debugDescription'];
   type: string;
   displayName?: ProductCommon['displayName'];
   displayPrice?: ProductCommon['displayPrice'];
@@ -612,6 +688,8 @@ export interface NitroProduct {
   typeIOS?: string | null;
   isFamilyShareableIOS?: boolean | null;
   jsonRepresentationIOS?: string | null;
+  pricingTermsIOS?: string | null;
+  subscriptionInfoIOS?: string | null;
   discountsIOS?: string | null;
   introductoryPriceIOS?: string | null;
   introductoryPriceAsAmountIOS?: number | null;
@@ -808,10 +886,10 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
 
   /**
    * Buy the promoted product from the App Store (iOS only)
-   * @returns Promise<void>
+   * @returns Promise<boolean> - Whether a promoted product was available and the request was initiated
    * @platform iOS
    */
-  buyPromotedProductIOS(): Promise<void>;
+  buyPromotedProductIOS(): Promise<boolean>;
 
   /**
    * Present the code redemption sheet for offer codes (iOS only)
@@ -868,7 +946,7 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
 
   /**
    * Get the full StoreKit 2 transaction history as PurchaseIOS values.
-   * Requires SK2ConsumableTransactionHistory Info.plist key for finished consumables (iOS 18+).
+   * Requires SKIncludeConsumableInAppPurchaseHistory Info.plist key for finished consumables (iOS 18+).
    * @returns Promise<NitroPurchase[]> - Array of all transactions
    * @platform iOS
    */
@@ -1086,12 +1164,11 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
   ): void;
 
   /**
-   * Add a listener for developer provided billing events (Android 8.3.0+ only).
-   * Fires when a user selects developer billing in the External Payments flow.
+   * Add a listener for developer provided billing events (Android 8.3.0+).
+   * Fires for External Payments and Billing Choice developer billing flows.
    *
-   * External Payments is part of Google Play Billing Library 8.3.0+ and allows
-   * showing a side-by-side choice between Google Play Billing and developer's
-   * external payment option directly in the purchase flow. (Japan only)
+   * Billing Choice expands the payload with nullable link/original transaction
+   * fields and selected products in Billing Library 9.1.0+.
    *
    * @param listener - Function to call when user chooses developer billing
    * @platform Android
@@ -1117,7 +1194,7 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
    *
    * Fires when a user's active subscription enters a state that needs attention
    * (payment method failed, card expired, etc.). Unifies:
-   * - StoreKit 2 `Message.Reason.billingIssue` (iOS 18+ / Mac Catalyst 18+)
+   * - StoreKit 2 `Message.Reason.billingIssue` (iOS / Mac Catalyst 16.4+, visionOS 1.0+)
    * - Google Play Billing `Purchase.isSuspended` (Play Billing 8.1+)
    *
    * NOT fired on Meta Horizon (Billing 7.0 compat SDK lacks the suspended signal).
@@ -1161,6 +1238,18 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
     program: BillingProgramAndroid,
   ): Promise<NitroBillingProgramAvailabilityResultAndroid>;
 
+  /**
+   * Fetch Play Billing assets and loyalty text for developer-rendered Billing Choice screens.
+   *
+   * @param params - Billing Choice info request parameters
+   * @returns Promise with the Play-hosted image URL and optional loyalty info
+   * @platform Android
+   * @since Billing Library 9.1.0+
+   */
+  getBillingChoiceInfoAndroid(
+    params: NitroGetBillingChoiceInfoParamsAndroid,
+  ): Promise<NitroBillingChoiceInfoAndroid>;
+
   /**
    * Create billing program reporting details for external transactions (Android only).
    * Used to get the external transaction token needed for reporting to Google.
@@ -1172,8 +1261,33 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
    */
   createBillingProgramReportingDetailsAndroid(
     program: BillingProgramAndroid,
+    developerBillingType?: DeveloperBillingTypeAndroid | null,
   ): Promise<NitroBillingProgramReportingDetailsAndroid>;
 
+  /**
+   * Show the Play-provided Billing Choice information dialog.
+   *
+   * @param params - Billing Choice dialog parameters
+   * @returns Promise with BillingResult
+   * @platform Android
+   * @since Billing Library 9.1.0+
+   */
+  showBillingProgramInformationDialogAndroid(
+    params: NitroBillingProgramInformationDialogParamsAndroid,
+  ): Promise<NitroBillingResultAndroid>;
+
+  /**
+   * Show Play Billing in-app messages, such as transactional subscription updates.
+   *
+   * @param params - Optional in-app message categories
+   * @returns Promise with in-app message result
+   * @platform Android
+   * @since Billing Library 4.1.0+
+   */
+  showInAppMessagesAndroid(
+    params?: NitroInAppMessageParamsAndroid | null,
+  ): Promise<NitroInAppMessageResultAndroid>;
+
   /**
    * Launch external link for external offers or app download (Android only).
    *