react-native-iap 14.6.2 → 14.6.3-rc.2

package/src/index.ts

@@ -1068,14 +1068,17 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
     }
 
     if (Platform.OS === 'ios') {
-      const iosRequest = perPlatformRequest.ios;
+      // Support both 'apple' (recommended) and 'ios' (deprecated) fields
+      const iosRequest = perPlatformRequest.apple ?? perPlatformRequest.ios;
       if (!iosRequest?.sku) {
         throw new Error(
           'Invalid request for iOS. The `sku` property is required.',
         );
       }
     } else if (Platform.OS === 'android') {
-      const androidRequest = perPlatformRequest.android;
+      // Support both 'google' (recommended) and 'android' (deprecated) fields
+      const androidRequest =
+        perPlatformRequest.google ?? perPlatformRequest.android;
       if (!androidRequest?.skus?.length) {
         throw new Error(
           'Invalid request for Android. The `skus` property is required and must be a non-empty array.',
@@ -1087,10 +1090,12 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
 
     const unifiedRequest: NitroPurchaseRequest = {};
 
-    if (Platform.OS === 'ios' && perPlatformRequest.ios) {
+    // Support both 'apple' (recommended) and 'ios' (deprecated) fields
+    const iosRequestSource = perPlatformRequest.apple ?? perPlatformRequest.ios;
+    if (Platform.OS === 'ios' && iosRequestSource) {
       const iosRequest = isSubs
-        ? (perPlatformRequest.ios as RequestSubscriptionIosProps)
-        : (perPlatformRequest.ios as RequestPurchaseIosProps);
+        ? (iosRequestSource as RequestSubscriptionIosProps)
+        : (iosRequestSource as RequestPurchaseIosProps);
 
       const iosPayload: NonNullable<NitroPurchaseRequest['ios']> = {
         sku: iosRequest.sku,
@@ -1117,14 +1122,20 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
       if (offerRecord) {
         iosPayload.withOffer = offerRecord;
       }
+      if (iosRequest.advancedCommerceData) {
+        iosPayload.advancedCommerceData = iosRequest.advancedCommerceData;
+      }
 
       unifiedRequest.ios = iosPayload;
     }
 
-    if (Platform.OS === 'android' && perPlatformRequest.android) {
+    // Support both 'google' (recommended) and 'android' (deprecated) fields
+    const androidRequestSource =
+      perPlatformRequest.google ?? perPlatformRequest.android;
+    if (Platform.OS === 'android' && androidRequestSource) {
       const androidRequest = isSubs
-        ? (perPlatformRequest.android as RequestSubscriptionAndroidProps)
-        : (perPlatformRequest.android as RequestPurchaseAndroidProps);
+        ? (androidRequestSource as RequestSubscriptionAndroidProps)
+        : (androidRequestSource as RequestPurchaseAndroidProps);
 
       const androidPayload: NonNullable<NitroPurchaseRequest['android']> = {
         skus: androidRequest.skus,
@@ -1601,43 +1612,60 @@ export const presentCodeRedemptionSheetIOS: MutationField<
 
 /**
  * Buy promoted product on iOS
+ * @deprecated In StoreKit 2, promoted products can be purchased directly via the standard `requestPurchase()` flow.
+ * Use `promotedProductListenerIOS` to receive the product ID when a user taps a promoted product,
+ * then call `requestPurchase()` with the received SKU directly.
+ *
+ * @example
+ * ```typescript
+ * // Recommended approach
+ * promotedProductListenerIOS(async (product) => {
+ *   await requestPurchase({
+ *     request: { apple: { sku: product.id } },
+ *     type: 'in-app'
+ *   });
+ * });
+ * ```
+ *
  * @returns Promise<boolean> - true when the request triggers successfully
  * @platform iOS
  */
-export const requestPurchaseOnPromotedProductIOS: MutationField<
-  'requestPurchaseOnPromotedProductIOS'
-> = async () => {
-  if (Platform.OS !== 'ios') {
-    throw new Error(
-      'requestPurchaseOnPromotedProductIOS is only available on iOS',
-    );
-  }
-
-  try {
-    await IAP.instance.buyPromotedProductIOS();
-    const pending = await IAP.instance.getPendingTransactionsIOS();
-    const latest = pending.find((purchase) => purchase != null);
-    if (!latest) {
-      throw new Error('No promoted purchase available after request');
+export const requestPurchaseOnPromotedProductIOS =
+  async (): Promise<boolean> => {
+    if (Platform.OS !== 'ios') {
+      throw new Error(
+        'requestPurchaseOnPromotedProductIOS is only available on iOS',
+      );
     }
 
-    const converted = convertNitroPurchaseToPurchase(latest);
-    if (converted.platform !== 'ios') {
-      throw new Error('Promoted purchase result not available for iOS');
-    }
+    try {
+      await IAP.instance.buyPromotedProductIOS();
+      const pending = await IAP.instance.getPendingTransactionsIOS();
+      const latest = pending.find((purchase) => purchase != null);
+      if (!latest) {
+        throw new Error('No promoted purchase available after request');
+      }
 
-    return true;
-  } catch (error) {
-    RnIapConsole.error('[requestPurchaseOnPromotedProductIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
-    throw createPurchaseError({
-      code: parsedError.code,
-      message: parsedError.message,
-      responseCode: parsedError.responseCode,
-      debugMessage: parsedError.debugMessage,
-    });
-  }
-};
+      const converted = convertNitroPurchaseToPurchase(latest);
+      if (converted.platform !== 'ios') {
+        throw new Error('Promoted purchase result not available for iOS');
+      }
+
+      return true;
+    } catch (error) {
+      RnIapConsole.error(
+        '[requestPurchaseOnPromotedProductIOS] Failed:',
+        error,
+      );
+      const parsedError = parseErrorStringToJsonObj(error);
+      throw createPurchaseError({
+        code: parsedError.code,
+        message: parsedError.message,
+        responseCode: parsedError.responseCode,
+        debugMessage: parsedError.debugMessage,
+      });
+    }
+  };
 
 /**
  * Clear unfinished transactions on iOS
@@ -2333,9 +2361,9 @@ export const enableBillingProgramAndroid = (
  * }
  * ```
  */
-export const isBillingProgramAvailableAndroid = async (
-  program: BillingProgramAndroid,
-): Promise<BillingProgramAvailabilityResultAndroid> => {
+export const isBillingProgramAvailableAndroid: MutationField<
+  'isBillingProgramAvailableAndroid'
+> = async (program) => {
   if (Platform.OS !== 'android') {
     throw new Error('Billing Programs API is only supported on Android');
   }
@@ -2372,9 +2400,9 @@ export const isBillingProgramAvailableAndroid = async (
  * });
  * ```
  */
-export const createBillingProgramReportingDetailsAndroid = async (
-  program: BillingProgramAndroid,
-): Promise<BillingProgramReportingDetailsAndroid> => {
+export const createBillingProgramReportingDetailsAndroid: MutationField<
+  'createBillingProgramReportingDetailsAndroid'
+> = async (program) => {
   if (Platform.OS !== 'android') {
     throw new Error('Billing Programs API is only supported on Android');
   }
@@ -2417,9 +2445,9 @@ export const createBillingProgramReportingDetailsAndroid = async (
  * }
  * ```
  */
-export const launchExternalLinkAndroid = async (
-  params: LaunchExternalLinkParamsAndroid,
-): Promise<boolean> => {
+export const launchExternalLinkAndroid: MutationField<
+  'launchExternalLinkAndroid'
+> = async (params) => {
   if (Platform.OS !== 'android') {
     throw new Error('Billing Programs API is only supported on Android');
   }

package/src/specs/RnIap.nitro.ts

@@ -102,6 +102,13 @@ export interface NitroRequestPurchaseIos {
   appAccountToken?: RequestPurchaseIosProps['appAccountToken'];
   quantity?: RequestPurchaseIosProps['quantity'];
   withOffer?: Record<string, string> | null;
+  /**
+   * Advanced commerce data for StoreKit 2's Product.PurchaseOption.custom API.
+   * Used to pass attribution data (campaign tokens, affiliate IDs) during purchases.
+   * Data is formatted as JSON: {"signatureInfo": {"token": "<value>"}}
+   * @platform iOS
+   */
+  advancedCommerceData?: RequestPurchaseIosProps['advancedCommerceData'];
 }
 
 export interface NitroRequestPurchaseAndroid {

package/src/types.ts

@@ -342,6 +342,15 @@ export interface Mutation {
    * Throws OpenIapError.NotPrepared if billing client not ready
    */
   createAlternativeBillingTokenAndroid?: Promise<(string | null)>;
+  /**
+   * Create reporting details for a billing program
+   * Replaces the deprecated createExternalOfferReportingDetailsAsync API
+   *
+   * Available in Google Play Billing Library 8.2.0+
+   * Returns external transaction token needed for reporting external transactions
+   * Throws OpenIapError.NotPrepared if billing client not ready
+   */
+  createBillingProgramReportingDetailsAndroid: Promise<BillingProgramReportingDetailsAndroid>;
   /** Open the native subscription management surface */
   deepLinkToSubscriptions: Promise<void>;
   /** Close the platform billing connection */
@@ -350,6 +359,24 @@ export interface Mutation {
   finishTransaction: Promise<void>;
   /** Establish the platform billing connection */
   initConnection: Promise<boolean>;
+  /**
+   * Check if a billing program is available for the current user
+   * Replaces the deprecated isExternalOfferAvailableAsync API
+   *
+   * Available in Google Play Billing Library 8.2.0+
+   * Returns availability result with isAvailable flag
+   * Throws OpenIapError.NotPrepared if billing client not ready
+   */
+  isBillingProgramAvailableAndroid: Promise<BillingProgramAvailabilityResultAndroid>;
+  /**
+   * Launch external link flow for external billing programs
+   * Replaces the deprecated showExternalOfferInformationDialog API
+   *
+   * Available in Google Play Billing Library 8.2.0+
+   * Shows Play Store dialog and optionally launches external URL
+   * Throws OpenIapError.NotPrepared if billing client not ready
+   */
+  launchExternalLinkAndroid: Promise<boolean>;
   /** Present the App Store code redemption sheet */
   presentCodeRedemptionSheetIOS: Promise<boolean>;
   /** Present external purchase custom link with StoreKit UI (iOS 18.2+) */
@@ -358,8 +385,15 @@ export interface Mutation {
   presentExternalPurchaseNoticeSheetIOS: Promise<ExternalPurchaseNoticeResultIOS>;
   /** Initiate a purchase flow; rely on events for final state */
   requestPurchase?: Promise<(Purchase | Purchase[] | null)>;
-  /** Purchase the promoted product surfaced by the App Store */
-  requestPurchaseOnPromotedProductIOS: Promise<boolean>;
+  /**
+   * Purchase the promoted product surfaced by the App Store.
+   *
+   * @deprecated Use promotedProductListenerIOS to receive the productId,
+   * then call requestPurchase with that SKU instead. In StoreKit 2,
+   * promoted products can be purchased directly via the standard purchase flow.
+   * @deprecated Use promotedProductListenerIOS + requestPurchase instead
+   */
+  requestPurchaseOnPromotedProductIOS: boolean;
   /** Restore completed purchases across platforms */
   restorePurchases: Promise<void>;
   /**
@@ -394,6 +428,8 @@ export type MutationBeginRefundRequestIosArgs = string;
 
 export type MutationConsumePurchaseAndroidArgs = string;
 
+export type MutationCreateBillingProgramReportingDetailsAndroidArgs = BillingProgramAndroid;
+
 export type MutationDeepLinkToSubscriptionsArgs = (DeepLinkOptions | null) | undefined;
 
 export interface MutationFinishTransactionArgs {
@@ -404,6 +440,10 @@ export interface MutationFinishTransactionArgs {
 
 export type MutationInitConnectionArgs = (InitConnectionConfig | null) | undefined;
 
+export type MutationIsBillingProgramAvailableAndroidArgs = BillingProgramAndroid;
+
+export type MutationLaunchExternalLinkAndroidArgs = LaunchExternalLinkParamsAndroid;
+
 export type MutationPresentExternalPurchaseLinkIosArgs = string;
 
 export type MutationRequestPurchaseArgs =
@@ -889,6 +929,13 @@ export interface RequestPurchaseAndroidProps {
 }
 
 export interface RequestPurchaseIosProps {
+  /**
+   * Advanced commerce data token (iOS 15+).
+   * Used with StoreKit 2's Product.PurchaseOption.custom API for passing
+   * campaign tokens, affiliate IDs, or other attribution data.
+   * The data is formatted as JSON: {"signatureInfo": {"token": "<value>"}}
+   */
+  advancedCommerceData?: (string | null);
   /** Auto-finish transaction (dangerous) */
   andDangerouslyFinishTransactionAutomatically?: (boolean | null);
   /** App account token for user tracking */
@@ -964,6 +1011,13 @@ export interface RequestSubscriptionAndroidProps {
 }
 
 export interface RequestSubscriptionIosProps {
+  /**
+   * Advanced commerce data token (iOS 15+).
+   * Used with StoreKit 2's Product.PurchaseOption.custom API for passing
+   * campaign tokens, affiliate IDs, or other attribution data.
+   * The data is formatted as JSON: {"signatureInfo": {"token": "<value>"}}
+   */
+  advancedCommerceData?: (string | null);
   andDangerouslyFinishTransactionAutomatically?: (boolean | null);
   appAccountToken?: (string | null);
   quantity?: (number | null);
@@ -1286,10 +1340,13 @@ export type MutationArgsMap = {
   clearTransactionIOS: never;
   consumePurchaseAndroid: MutationConsumePurchaseAndroidArgs;
   createAlternativeBillingTokenAndroid: never;
+  createBillingProgramReportingDetailsAndroid: MutationCreateBillingProgramReportingDetailsAndroidArgs;
   deepLinkToSubscriptions: MutationDeepLinkToSubscriptionsArgs;
   endConnection: never;
   finishTransaction: MutationFinishTransactionArgs;
   initConnection: MutationInitConnectionArgs;
+  isBillingProgramAvailableAndroid: MutationIsBillingProgramAvailableAndroidArgs;
+  launchExternalLinkAndroid: MutationLaunchExternalLinkAndroidArgs;
   presentCodeRedemptionSheetIOS: never;
   presentExternalPurchaseLinkIOS: MutationPresentExternalPurchaseLinkIosArgs;
   presentExternalPurchaseNoticeSheetIOS: never;