react-native-iap 15.6.2 → 16.0.1

package/lib/module/index.js

@@ -13,8 +13,6 @@ import { convertNitroProductToProduct, convertNitroPurchaseToPurchase, convertPr
 import { isUserCancelledError, parseErrorStringToJsonObj } from "./utils/error.js";
 import { normalizeErrorCodeFromNative, createPurchaseError, DUPLICATE_PURCHASE_CODE } from "./utils/errorMapping.js";
 import { RnIapConsole } from "./utils/debug.js";
-import { warnLegacyOnce } from "./utils/deprecation.js";
-import { selectCanonicalPlatformRequest } from "./utils/platform-request.js";
 import { getSuccessFromPurchaseVariant } from "./utils/purchase.js";
 import { parseAppTransactionPayload } from "./utils.js";
 import { getVegaIapModule, isVegaOS } from "./vega.js";
@@ -33,14 +31,8 @@ export * from "./types.js";
 export * from "./utils/error.js";
 export * from "./vega.js";
 
-/**
- * Product type accepted by public query and purchase helpers.
- *
- * Compatibility note: the `'inapp'` member is deprecated. Use `'in-app'`
- * instead; the alias will be removed in react-native-iap 16.0.0.
- */
+/** Product type accepted by public query and purchase helpers. */
 
-const LEGACY_INAPP_WARNING = "[react-native-iap] `type: 'inapp'` is deprecated and will be removed in react-native-iap 16.0.0. Use 'in-app' instead.";
 const toErrorMessage = error => {
   if (typeof error === 'object' && error !== null && 'message' in error && error.message != null) {
     return String(error.message);
@@ -281,6 +273,13 @@ export const purchaseUpdatedListener = (listener, options) => {
       if (listeners.size > 0) {
         return;
       }
+
+      // StoreKit-backed Nitro listener disposal can abort in iOS release builds
+      // when a native modal is being popped. Keep the singleton native listener
+      // attached for the app session and only remove the JS callback above.
+      if (Platform.OS === 'ios') {
+        return;
+      }
       const token = receiveDuplicateTransactionUpdatesIOS ? purchaseUpdateDuplicateNativeToken : purchaseUpdateNativeToken;
       if (token == null) {
         return;
@@ -318,7 +317,18 @@ export const purchaseErrorListener = listener => {
   return {
     remove: () => {
       purchaseErrorJsListeners.delete(listener);
-      if (purchaseErrorJsListeners.size === 0 && purchaseErrorNativeAttached) {
+      if (purchaseErrorJsListeners.size > 0) {
+        return;
+      }
+
+      // Same iOS policy as purchaseUpdatedListener: releasing the stored
+      // native callback from a JS unsubscribe can race an in-flight dispatch
+      // snapshot on another thread. Keep the singleton attached; endConnection
+      // owns native disposal.
+      if (Platform.OS === 'ios') {
+        return;
+      }
+      if (purchaseErrorNativeAttached) {
         try {
           IAP.instance.removePurchaseErrorListener(purchaseErrorNativeHandler);
           purchaseErrorNativeAttached = false;
@@ -619,8 +629,7 @@ export const fetchProducts = async request => {
         platform: item.platform
       })));
 
-      // For 'all' type, need to properly distinguish between products and subscriptions
-      // On Android, check subscriptionOfferDetailsAndroid to determine if it's a real subscription
+      // The major schema uses the canonical `type` discriminator on every store.
       const productItems = [];
       const subscriptionItems = [];
       converted.forEach(item => {
@@ -629,31 +638,7 @@ export const fetchProducts = async request => {
           productItems.push(item);
           return;
         }
-
-        // item.type === 'subs' case
-        // For Android, check if subscription items have actual offers
-        if (isAndroidStoreRuntime() && item.platform === 'android' && item.type === 'subs') {
-          // TypeScript now knows this is ProductSubscriptionAndroid
-          const hasSubscriptionOffers = item.subscriptionOfferDetailsAndroid && Array.isArray(item.subscriptionOfferDetailsAndroid) && item.subscriptionOfferDetailsAndroid.length > 0;
-          RnIapConsole.debug(`[fetchProducts] ${item.id}: type=${item.type}, hasOffers=${hasSubscriptionOffers}`);
-          if (hasSubscriptionOffers) {
-            subscriptionItems.push(item);
-          } else {
-            // Treat as product if no offers - convert type
-            const {
-              subscriptionOfferDetailsAndroid: _,
-              ...productFields
-            } = item;
-            productItems.push({
-              ...productFields,
-              type: 'in-app'
-            });
-          }
-        } else if (item.platform === 'ios' && item.type === 'subs') {
-          // iOS: type field is reliable with discriminated unions
-          // TypeScript now knows this is ProductSubscriptionIOS
-          subscriptionItems.push(item);
-        }
+        subscriptionItems.push(item);
       });
       RnIapConsole.debug('[fetchProducts] After filtering - products:', productItems.length, 'subs:', subscriptionItems.length);
       return [...productItems, ...subscriptionItems];
@@ -736,7 +721,7 @@ export const getAvailablePurchases = async options => {
       // For Android Play/Horizon/Fire OS, query in-app items and subscriptions separately.
       const inappNitroPurchases = await IAP.instance.getAvailablePurchases({
         android: {
-          type: 'inapp',
+          type: 'in-app',
           includeSuspended
         }
       });
@@ -775,7 +760,7 @@ export const getPromotedProductIOS = async () => {
     return null;
   }
   try {
-    const nitroProduct = typeof IAP.instance.getPromotedProductIOS === 'function' ? await IAP.instance.getPromotedProductIOS() : await IAP.instance.requestPromotedProductIOS();
+    const nitroProduct = await IAP.instance.getPromotedProductIOS();
     if (!nitroProduct) {
       return null;
     }
@@ -792,46 +777,6 @@ export const getPromotedProductIOS = async () => {
   }
 };
 
-/**
- * @deprecated Use `getPromotedProductIOS` instead. This compatibility alias
- * will be removed in react-native-iap 16.0.0.
- */
-export const requestPromotedProductIOS = getPromotedProductIOS;
-
-/**
- * Get the storefront identifier for the user's App Store account (iOS only)
- * @returns Promise<string> - The storefront identifier (e.g., 'USA' for United States)
- * @platform iOS
- *
- * @example
- * ```typescript
- * const storefront = await getStorefrontIOS();
- * console.log('User storefront:', storefront); // e.g., 'USA', 'GBR', 'KOR'
- * ```
- *
- * @see {@link https://openiap.dev/docs/apis/ios/get-storefront-ios}
- * @deprecated Use `getStorefront` instead. Scheduled for removal in
- * react-native-iap 16.0.0.
- */
-export const getStorefrontIOS = async () => {
-  if (Platform.OS !== 'ios') {
-    throw new Error('getStorefrontIOS is only available on iOS');
-  }
-  try {
-    const storefront = await IAP.instance.getStorefrontIOS();
-    if (typeof storefront !== 'string' || storefront.trim().length === 0) {
-      throw createPurchaseError({
-        code: ErrorCode.ServiceError,
-        message: 'Storefront lookup returned no country code.'
-      });
-    }
-    return storefront;
-  } catch (error) {
-    RnIapConsole.error('Failed to get storefront:', error);
-    throw error;
-  }
-};
-
 /**
  * Return the user's storefront country code.
  *
@@ -844,17 +789,9 @@ export const getStorefront = async () => {
       message: `Storefront lookup is not supported on ${Platform.OS}.`
     });
   }
-  const hasUnifiedMethod = typeof IAP.instance.getStorefront === 'function';
-  if (!hasUnifiedMethod && Platform.OS !== 'ios') {
-    throw createPurchaseError({
-      code: ErrorCode.FeatureNotSupported,
-      message: 'Native getStorefront is not available on this build.',
-      platform: 'android'
-    });
-  }
   let storefront;
   try {
-    storefront = hasUnifiedMethod ? await IAP.instance.getStorefront() : await getStorefrontIOS();
+    storefront = await IAP.instance.getStorefront();
   } catch (error) {
     const parsedError = parseErrorAndLogIfNeeded(`[getStorefront] Failed to get storefront on ${Platform.OS}:`, error);
     throw createPurchaseError({
@@ -966,7 +903,7 @@ export const currentEntitlementIOS = async sku => {
     const nitroPurchase = await IAP.instance.currentEntitlementIOS(sku);
     if (nitroPurchase) {
       const converted = convertNitroPurchaseToPurchase(nitroPurchase);
-      return converted.platform === 'ios' ? converted : null;
+      return converted.store === 'apple' ? converted : null;
     }
     return null;
   } catch (error) {
@@ -996,7 +933,7 @@ export const latestTransactionIOS = async sku => {
     const nitroPurchase = await IAP.instance.latestTransactionIOS(sku);
     if (nitroPurchase) {
       const converted = convertNitroPurchaseToPurchase(nitroPurchase);
-      return converted.platform === 'ios' ? converted : null;
+      return converted.store === 'apple' ? converted : null;
     }
     return null;
   } catch (error) {
@@ -1023,7 +960,7 @@ export const getPendingTransactionsIOS = async () => {
   }
   try {
     const nitroPurchases = await IAP.instance.getPendingTransactionsIOS();
-    return nitroPurchases.map(convertNitroPurchaseToPurchase).filter(purchase => purchase.platform === 'ios');
+    return nitroPurchases.map(convertNitroPurchaseToPurchase).filter(purchase => purchase.store === 'apple');
   } catch (error) {
     const parsedError = parseErrorAndLogIfNeeded('[getPendingTransactionsIOS] Failed:', error);
     throw createPurchaseError({
@@ -1046,7 +983,7 @@ export const getAllTransactionsIOS = async () => {
   }
   try {
     const nitroPurchases = await IAP.instance.getAllTransactionsIOS();
-    return nitroPurchases.map(convertNitroPurchaseToPurchase).filter(purchase => purchase.platform === 'ios');
+    return nitroPurchases.map(convertNitroPurchaseToPurchase).filter(purchase => purchase.store === 'apple');
   } catch (error) {
     const parsedError = parseErrorAndLogIfNeeded('[getAllTransactionsIOS] Failed:', error);
     throw createPurchaseError({
@@ -1071,7 +1008,7 @@ export const showManageSubscriptionsIOS = async () => {
   }
   try {
     const nitroPurchases = await IAP.instance.showManageSubscriptionsIOS();
-    return nitroPurchases.map(convertNitroPurchaseToPurchase).filter(purchase => purchase.platform === 'ios');
+    return nitroPurchases.map(convertNitroPurchaseToPurchase).filter(purchase => purchase.store === 'apple');
   } catch (error) {
     const parsedError = parseErrorAndLogIfNeeded('[showManageSubscriptionsIOS] Failed:', error);
     throw createPurchaseError({
@@ -1132,34 +1069,6 @@ export const getReceiptDataIOS = async () => {
     });
   }
 };
-
-/**
- * Legacy alias for `getReceiptDataIOS`.
- *
- * @deprecated Use `getReceiptDataIOS` for the cumulative App Store receipt or
- * `getTransactionJwsIOS(productId)` for one transaction. This alias will be
- * removed in react-native-iap 16.0.0.
- */
-export const getReceiptIOS = async () => {
-  if (Platform.OS !== 'ios') {
-    throw new Error('getReceiptIOS is only available on iOS');
-  }
-  RnIapConsole.warn('[getReceiptIOS] is deprecated and will be removed in react-native-iap 16.0.0. ' + 'Use getReceiptDataIOS() for the cumulative receipt. iOS receipts contain ALL transactions, not just the latest one. ' + 'For individual purchase validation, use getTransactionJwsIOS(productId) instead. ' + 'See: https://react-native-iap.hyo.dev/docs/guides/receipt-validation');
-  try {
-    if (typeof IAP.instance.getReceiptIOS === 'function') {
-      return await IAP.instance.getReceiptIOS();
-    }
-    return await IAP.instance.getReceiptDataIOS();
-  } catch (error) {
-    const parsedError = parseErrorAndLogIfNeeded('[getReceiptIOS] Failed:', error);
-    throw createPurchaseError({
-      code: parsedError.code,
-      message: parsedError.message,
-      responseCode: parsedError.responseCode,
-      debugMessage: parsedError.debugMessage
-    });
-  }
-};
 export const requestReceiptRefreshIOS = async () => {
   if (Platform.OS !== 'ios') {
     throw new Error('requestReceiptRefreshIOS is only available on iOS');
@@ -1361,8 +1270,8 @@ export const requestPurchase = async request => {
     if (!perPlatformRequest) {
       throw new Error('Missing purchase request configuration');
     }
-    const iosRequestSource = Platform.OS === 'ios' ? selectApplePurchaseRequest(perPlatformRequest) : undefined;
-    const androidRequestSource = isAndroidStoreRuntime() ? selectGooglePurchaseRequest(perPlatformRequest) : undefined;
+    const iosRequestSource = Platform.OS === 'ios' ? perPlatformRequest.apple : undefined;
+    const androidRequestSource = isAndroidStoreRuntime() ? perPlatformRequest.google : undefined;
     if (Platform.OS === 'ios') {
       if (!iosRequestSource?.sku) {
         throw new Error('Invalid request for iOS. The `sku` property is required.');
@@ -1446,9 +1355,6 @@ export const requestPurchase = async request => {
         if (subsRequest.originalExternalTransactionId) {
           androidPayload.originalExternalTransactionId = subsRequest.originalExternalTransactionId;
         }
-        if (subsRequest.replacementMode != null) {
-          androidPayload.replacementMode = subsRequest.replacementMode;
-        }
         if (subsRequest.subscriptionProductReplacementParams) {
           androidPayload.subscriptionProductReplacementParams = subsRequest.subscriptionProductReplacementParams;
         }
@@ -1648,8 +1554,7 @@ export const openRedeemOfferCodeAndroid = async () => {
 // ============================================================================
 
 /**
- * Validate receipt on both iOS and Android platforms
- * @deprecated Use `verifyPurchase` instead. This function will be removed in react-native-iap 16.0.0.
+ * Verify a purchase on iOS or Android.
  * @param options - Platform-specific verification options
  * @param options.apple - Apple App Store verification options (iOS)
  * @param options.google - Google Play verification options (Android)
@@ -1673,7 +1578,7 @@ export const openRedeemOfferCodeAndroid = async () => {
  *
  * @see {@link https://openiap.dev/docs/apis/validate-receipt}
  */
-export const validateReceipt = async options => {
+export const verifyPurchase = async options => {
   const {
     apple,
     google,
@@ -1721,7 +1626,7 @@ export const validateReceipt = async options => {
         accessToken: horizon.accessToken
       } : null
     };
-    const nitroResult = await IAP.instance.validateReceipt(params);
+    const nitroResult = await IAP.instance.verifyPurchase(params);
 
     // Convert Nitro result to public API result
     if (Platform.OS === 'ios') {
@@ -1759,7 +1664,7 @@ export const validateReceipt = async options => {
       return result;
     }
   } catch (error) {
-    const parsedError = parseErrorAndLogIfNeeded('[validateReceipt] Failed:', error);
+    const parsedError = parseErrorAndLogIfNeeded('[verifyPurchase] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1769,36 +1674,6 @@ export const validateReceipt = async options => {
   }
 };
 
-/**
- * Verify purchase with the configured providers
- *
- * This function uses the native OpenIAP verifyPurchase implementation
- * which validates purchases using platform-specific methods.
- * This is an alias for validateReceipt for API consistency with OpenIAP.
- *
- * @param options - Receipt validation options containing the SKU
- * @returns Promise resolving to receipt validation result
- *
- * @see {@link https://openiap.dev/docs/features/validation#verify-purchase}
- */
-export const verifyPurchase = validateReceipt;
-
-/**
- * iOS-only receipt validation alias.
- *
- * @deprecated Use `verifyPurchase` instead. This compatibility alias will be
- * removed in react-native-iap 16.0.0. Throws on non-iOS platforms.
- *
- * @see {@link https://openiap.dev/docs/apis/ios/validate-receipt-ios}
- */
-export const validateReceiptIOS = async options => {
-  if (Platform.OS !== 'ios') {
-    throw new Error('validateReceiptIOS is only available on iOS');
-  }
-  const result = await validateReceipt(options);
-  return result;
-};
-
 /**
  * Verify purchase with a specific provider (e.g., IAPKit)
  *
@@ -1894,18 +1769,25 @@ export const syncIOS = async () => {
 
 /**
  * Present the code redemption sheet for offer codes (iOS only)
- * @returns Promise<boolean> - Indicates whether the redemption sheet was presented
+ * @returns The verified redeemed purchase on iOS 27+, or null after the
+ * legacy sheet is presented on earlier iOS versions.
  * @platform iOS
  *
  * @see {@link https://openiap.dev/docs/apis/ios/present-code-redemption-sheet-ios}
  */
 export const presentCodeRedemptionSheetIOS = async () => {
   if (Platform.OS !== 'ios') {
-    return false;
+    return null;
   }
   try {
     const result = await IAP.instance.presentCodeRedemptionSheetIOS();
-    return Boolean(result);
+    if (result == null) {
+      return null;
+    }
+    if (!validateNitroPurchase(result)) {
+      throw new Error('Invalid redeemed purchase returned by native StoreKit');
+    }
+    return convertNitroPurchaseToPurchase(result);
   } catch (error) {
     const parsedError = parseErrorAndLogIfNeeded('[presentCodeRedemptionSheetIOS] Failed:', error);
     throw createPurchaseError({
@@ -1917,47 +1799,6 @@ export const presentCodeRedemptionSheetIOS = async () => {
   }
 };
 
-/**
- * Buy promoted product on iOS
- * @deprecated In StoreKit 2, promoted products can be purchased directly via
- * the standard `requestPurchase()` flow. This alias will be removed in
- * react-native-iap 16.0.0.
- * 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
- *
- * @see {@link https://openiap.dev/docs/apis/ios/request-purchase-on-promoted-product-ios}
- */
-export const requestPurchaseOnPromotedProductIOS = async () => {
-  if (Platform.OS !== 'ios') {
-    throw new Error('requestPurchaseOnPromotedProductIOS is only available on iOS');
-  }
-  try {
-    return await IAP.instance.buyPromotedProductIOS();
-  } catch (error) {
-    const parsedError = parseErrorAndLogIfNeeded('[requestPurchaseOnPromotedProductIOS] Failed:', error);
-    throw createPurchaseError({
-      code: parsedError.code,
-      message: parsedError.message,
-      responseCode: parsedError.responseCode,
-      debugMessage: parsedError.debugMessage
-    });
-  }
-};
-
 /**
  * Clear unfinished transactions on iOS
  * @returns Promise<boolean>
@@ -2087,12 +1928,14 @@ export const getActiveSubscriptions = async subscriptionIds => {
       // iOS specific fields
       expirationDateIOS: sub.expirationDateIOS ?? null,
       environmentIOS: sub.environmentIOS ?? null,
-      willExpireSoon: sub.willExpireSoon ?? null,
       daysUntilExpirationIOS: sub.daysUntilExpirationIOS ?? null,
       // renewalInfoIOS contains subscription lifecycle information on iOS.
       renewalInfoIOS: sub.renewalInfoIOS ? {
         willAutoRenew: sub.renewalInfoIOS.willAutoRenew ?? false,
         autoRenewPreference: sub.renewalInfoIOS.autoRenewPreference ?? null,
+        bundleOriginalTransactionId: sub.renewalInfoIOS.bundleOriginalTransactionId ?? null,
+        bundleProductId: sub.renewalInfoIOS.bundleProductId ?? null,
+        bundleSubscriptionGroupId: sub.renewalInfoIOS.bundleSubscriptionGroupId ?? null,
         commitmentInfo: sub.renewalInfoIOS.commitmentInfo ?? null,
         pendingUpgradeProductId: sub.renewalInfoIOS.pendingUpgradeProductId ?? null,
         renewalDate: sub.renewalInfoIOS.renewalDate ?? null,
@@ -2103,7 +1946,8 @@ export const getActiveSubscriptions = async subscriptionIds => {
         renewalBillingPlanType: sub.renewalInfoIOS.renewalBillingPlanType ?? null,
         renewalOfferType: sub.renewalInfoIOS.renewalOfferType ?? null,
         renewalOfferId: sub.renewalInfoIOS.renewalOfferId ?? null,
-        jsonRepresentation: sub.renewalInfoIOS.jsonRepresentation ?? null
+        jsonRepresentation: sub.renewalInfoIOS.jsonRepresentation ?? null,
+        willUnbundle: sub.renewalInfoIOS.willUnbundle ?? null
       } : null,
       // Android specific fields
       autoRenewingAndroid: sub.autoRenewingAndroid ?? null,
@@ -2150,37 +1994,10 @@ export const hasActiveSubscriptions = async subscriptionIds => {
 // Type conversion utilities
 export { convertNitroProductToProduct, convertNitroPurchaseToPurchase, convertProductToProductSubscription, validateNitroProduct, validateNitroPurchase, checkTypeSynchronization } from "./utils/type-bridge.js";
 
-// Deprecated exports for backward compatibility
-/**
- * @deprecated Use acknowledgePurchaseAndroid instead. This alias will be
- * removed in react-native-iap 16.0.0.
- */
-export const acknowledgePurchase = acknowledgePurchaseAndroid;
-
-/**
- * @deprecated Use consumePurchaseAndroid instead. This alias will be removed
- * in react-native-iap 16.0.0.
- */
-export const consumePurchase = consumePurchaseAndroid;
-
 // ============================================================================
 // Internal Helpers
 // ============================================================================
 
-const selectApplePurchaseRequest = request => {
-  const selection = selectCanonicalPlatformRequest(request, 'apple', 'ios');
-  if (selection.usesLegacyKey && selection.value != null) {
-    warnLegacyOnce('request-purchase.ios', '[react-native-iap] `request.ios` is deprecated and will be removed in react-native-iap 16.0.0. Use `request.apple` instead.');
-  }
-  return selection.value;
-};
-const selectGooglePurchaseRequest = request => {
-  const selection = selectCanonicalPlatformRequest(request, 'google', 'android');
-  if (selection.usesLegacyKey && selection.value != null) {
-    warnLegacyOnce('request-purchase.android', '[react-native-iap] `request.android` is deprecated and will be removed in react-native-iap 16.0.0. Use `request.google` instead.');
-  }
-  return selection.value;
-};
 const toDiscountOfferRecordIOS = offer => {
   if (!offer) {
     return undefined;
@@ -2194,159 +2011,26 @@ const toDiscountOfferRecordIOS = offer => {
   };
 };
 const toNitroProductType = type => {
-  if (type === 'subs') {
-    return 'subs';
-  }
-  if (type === 'all') {
-    return 'all';
-  }
-  if (type === 'inapp') {
-    warnLegacyOnce('product-type.inapp', LEGACY_INAPP_WARNING);
-    return 'in-app';
+  switch (type) {
+    case 'in-app':
+      return 'in-app';
+    case 'subs':
+      return 'subs';
+    case 'all':
+      return 'all';
+    default:
+      throw new Error(`Unsupported product type: ${String(type)}. Use in-app, subs, or all.`);
   }
-  return 'in-app';
 };
 const isSubscriptionQuery = type => type === 'subs';
 const normalizeProductQueryType = type => {
+  if (type == null) {
+    return 'in-app';
+  }
   if (type === 'all' || type === 'subs' || type === 'in-app') {
     return type;
   }
-  if (typeof type === 'string') {
-    const normalized = type.trim().toLowerCase().replace(/_/g, '-');
-    if (normalized === 'all') {
-      return 'all';
-    }
-    if (normalized === 'subs') {
-      return 'subs';
-    }
-    if (normalized === 'inapp') {
-      warnLegacyOnce('product-type.inapp', LEGACY_INAPP_WARNING);
-      return 'in-app';
-    }
-    if (normalized === 'in-app') {
-      return 'in-app';
-    }
-  }
-  return 'in-app';
-};
-
-// ============================================================================
-// ALTERNATIVE BILLING APIs
-// ============================================================================
-
-// ------------------------------
-// Android Alternative Billing
-// ------------------------------
-
-/**
- * Check if alternative billing is available for this user/device (Android only).
- * Step 1 of alternative billing flow.
- *
- * @returns Promise<boolean> - true if available, false otherwise
- * @throws Error if billing client not ready
- * @platform Android
- *
- * @example
- * ```typescript
- * const isAvailable = await checkAlternativeBillingAvailabilityAndroid();
- * if (isAvailable) {
- *   // Proceed with alternative billing flow
- * }
- * ```
- *
- * @see {@link https://openiap.dev/docs/apis/android/check-alternative-billing-availability-android}
- * @deprecated Use `isBillingProgramAvailableAndroid('external-offer')`
- * instead. Scheduled for removal in react-native-iap 16.0.0.
- */
-export const checkAlternativeBillingAvailabilityAndroid = async () => {
-  if (Platform.OS !== 'android') {
-    throw new Error('Alternative billing is only supported on Android');
-  }
-  try {
-    return await IAP.instance.checkAlternativeBillingAvailabilityAndroid();
-  } catch (error) {
-    RnIapConsole.error('Failed to check alternative billing availability:', error);
-    throw error;
-  }
-};
-
-/**
- * Show alternative billing information dialog to user (Android only).
- * Step 2 of alternative billing flow.
- * Must be called BEFORE processing payment in your payment system.
- *
- * @returns Promise<boolean> - true if user accepted, false if user canceled
- * @throws Error if billing client not ready
- * @platform Android
- *
- * @example
- * ```typescript
- * const userAccepted = await showAlternativeBillingDialogAndroid();
- * if (userAccepted) {
- *   // Process payment in your payment system
- *   const success = await processCustomPayment();
- *   if (success) {
- *     // Create reporting token
- *     const token = await createAlternativeBillingTokenAndroid();
- *     // Send token to your backend for Google Play reporting
- *   }
- * }
- * ```
- *
- * @see {@link https://openiap.dev/docs/apis/android/show-alternative-billing-dialog-android}
- * @deprecated Use `launchExternalLinkAndroid` instead. Scheduled for removal in
- * react-native-iap 16.0.0.
- */
-export const showAlternativeBillingDialogAndroid = async () => {
-  if (Platform.OS !== 'android') {
-    throw new Error('Alternative billing is only supported on Android');
-  }
-  try {
-    return await IAP.instance.showAlternativeBillingDialogAndroid();
-  } catch (error) {
-    RnIapConsole.error('Failed to show alternative billing dialog:', error);
-    throw error;
-  }
-};
-
-/**
- * Create external transaction token for Google Play reporting (Android only).
- * Step 3 of alternative billing flow.
- * Must be called AFTER successful payment in your payment system.
- * Token must be reported to Google Play backend within 24 hours.
- *
- * @param sku - Optional product SKU that was purchased
- * @returns Promise<string | null> - Token string or null if creation failed
- * @throws Error if billing client not ready
- * @platform Android
- *
- * @example
- * ```typescript
- * const token = await createAlternativeBillingTokenAndroid('premium_subscription');
- * if (token) {
- *   // Send token to your backend
- *   await fetch('/api/report-transaction', {
- *     method: 'POST',
- *     body: JSON.stringify({ token, sku: 'premium_subscription' })
- *   });
- * }
- * ```
- *
- * @see {@link https://openiap.dev/docs/apis/android/create-alternative-billing-token-android}
- * @deprecated Use
- * `createBillingProgramReportingDetailsAndroid('external-offer')` instead.
- * Scheduled for removal in react-native-iap 16.0.0.
- */
-export const createAlternativeBillingTokenAndroid = async sku => {
-  if (Platform.OS !== 'android') {
-    throw new Error('Alternative billing is only supported on Android');
-  }
-  try {
-    return await IAP.instance.createAlternativeBillingTokenAndroid(sku ?? null);
-  } catch (error) {
-    RnIapConsole.error('Failed to create alternative billing token:', error);
-    throw error;
-  }
+  throw new Error(`Unsupported product type: ${String(type)}. Use in-app, subs, or all.`);
 };
 
 /**