react-native-iap 15.3.5 → 15.4.0-rc.1

package/README.md

@@ -105,7 +105,7 @@ Before installing React Native IAP, make sure you have:
 
 #### Android Configuration
 
-**Kotlin Version Requirement:** This library requires Kotlin 2.0+. Configure your project's Kotlin version:
+**Kotlin Version Requirement:** This library requires Kotlin 2.2+. Configure your project's Kotlin version:
 
 In your root `android/build.gradle`:
 

package/android/build.gradle

@@ -107,8 +107,13 @@ def getExtOrIntegerDefault(name) {
   return getExtOrDefault(name).toString().toInteger()
 }
 
-// Read horizonEnabled from gradle.properties, default to false (play)
+// Read store flags from gradle.properties, default to play
 def horizonEnabled = project.findProperty('horizonEnabled')?.toBoolean() ?: false
+def fireOsEnabled = project.findProperty('fireOsEnabled')?.toBoolean() ?: false
+if (horizonEnabled && fireOsEnabled) {
+  throw new GradleException("react-native-iap: horizonEnabled and fireOsEnabled cannot both be true")
+}
+def openiapFlavor = fireOsEnabled ? 'amazon' : (horizonEnabled ? 'horizon' : 'play')
 
 def resolveOpenIapGoogleBuildFile() {
   def candidates = [
@@ -155,9 +160,8 @@ android {
     // Ship consumer keep rules so Nitro HybridObjects aren't stripped in app release builds
     consumerProguardFiles 'consumer-rules.pro'
 
-    // Use horizonEnabled to determine platform flavor
-    def flavor = horizonEnabled ? 'horizon' : 'play'
-    missingDimensionStrategy "platform", flavor
+    // Use explicit store flags to determine platform flavor
+    missingDimensionStrategy "platform", openiapFlavor
 
     externalNativeBuild {
       cmake {
@@ -251,7 +255,9 @@ dependencies {
   }
 
   // Google Play Services
-  implementation "com.google.android.gms:play-services-base:$playServicesBaseVersion"
+  if (!fireOsEnabled && !horizonEnabled) {
+    implementation "com.google.android.gms:play-services-base:$playServicesBaseVersion"
+  }
 
   // Kotlin coroutines
   implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:$coroutinesVersion"
@@ -261,6 +267,8 @@ dependencies {
   def localGoogleProject = findProject(':openiap')
   if (localGoogleProject != null) {
     implementation project(':openiap')
+  } else if (fireOsEnabled) {
+    implementation "io.github.hyochan.openiap:openiap-google-amazon:${googleVersionString}"
   } else if (horizonEnabled) {
     implementation "io.github.hyochan.openiap:openiap-google-horizon:${googleVersionString}"
   } else {

package/android/src/main/java/com/margelo/nitro/iap/HybridRnIap.kt

@@ -43,13 +43,13 @@ import dev.hyo.openiap.ExternalLinkLaunchModeAndroid as OpenIapExternalLinkLaunc
 import dev.hyo.openiap.ExternalLinkTypeAndroid as OpenIapExternalLinkType
 import dev.hyo.openiap.listener.OpenIapDeveloperProvidedBillingListener
 import dev.hyo.openiap.store.OpenIapStore
+import java.util.Locale
 import kotlin.coroutines.cancellation.CancellationException
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
 import kotlinx.coroutines.CompletableDeferred
 import org.json.JSONArray
 import org.json.JSONObject
-import java.util.Locale
 
 /**
  * Custom exception for OpenIAP errors that only includes the error JSON without stack traces.
@@ -575,7 +575,7 @@ class HybridRnIap : HybridRnIapSpec() {
                 mapOf("type" to androidOptions?.type?.name, "includeSuspended" to includeSuspended)
             )
 
-            val typeName = androidOptions?.type?.name?.lowercase()
+            val typeName = androidOptions?.type?.name?.lowercase(java.util.Locale.ROOT)
             val normalizedType = when (typeName) {
                 "inapp" -> {
                     RnIapLog.warn("getAvailablePurchases received legacy type 'inapp'; forwarding as 'in-app'")
@@ -1279,6 +1279,7 @@ class HybridRnIap : HybridRnIapSpec() {
             dev.hyo.openiap.IapStore.Apple -> IapStore.APPLE
             dev.hyo.openiap.IapStore.Google -> IapStore.GOOGLE
             dev.hyo.openiap.IapStore.Horizon -> IapStore.HORIZON
+            dev.hyo.openiap.IapStore.Amazon -> IapStore.AMAZON
             dev.hyo.openiap.IapStore.Unknown -> IapStore.UNKNOWN
         }
     }
@@ -1469,7 +1470,7 @@ class HybridRnIap : HybridRnIapSpec() {
         return Promise.async {
             try {
                 // Convert Nitro enum to string (e.g., IAPKIT -> "iapkit")
-                val providerString = params.provider.name.lowercase()
+                val providerString = params.provider.name.lowercase(java.util.Locale.ROOT)
                 RnIapLog.payload("verifyPurchaseWithProvider", mapOf("provider" to providerString))
 
                 // Build the props map for OpenIAP - use string value for provider
@@ -1482,6 +1483,14 @@ class HybridRnIap : HybridRnIapSpec() {
                     (iapkit.google as? Variant_NullType_NitroVerifyPurchaseWithIapkitGoogleProps.Second)?.value?.let { google ->
                         iapkitMap["google"] = mapOf("purchaseToken" to google.purchaseToken)
                     }
+                    (iapkit.amazon as? Variant_NullType_NitroVerifyPurchaseWithIapkitAmazonProps.Second)?.value?.let { amazon ->
+                        val amazonMap = mutableMapOf<String, Any?>(
+                            "receiptId" to amazon.receiptId
+                        )
+                        amazon.userId.unwrapString()?.let { amazonMap["userId"] = it }
+                        amazon.sandbox.unwrapBool()?.let { amazonMap["sandbox"] = it }
+                        iapkitMap["amazon"] = amazonMap
+                    }
                     (iapkit.apple as? Variant_NullType_NitroVerifyPurchaseWithIapkitAppleProps.Second)?.value?.let { apple ->
                         iapkitMap["apple"] = mapOf("jws" to apple.jws)
                     }
@@ -1609,6 +1618,7 @@ class HybridRnIap : HybridRnIapSpec() {
     // Alternative Billing (Android)
     // -------------------------------------------------------------------------
 
+    @Suppress("DEPRECATION")
     override fun checkAlternativeBillingAvailabilityAndroid(): Promise<Boolean> {
         return Promise.async {
             RnIapLog.payload("checkAlternativeBillingAvailabilityAndroid", null)
@@ -1626,6 +1636,7 @@ class HybridRnIap : HybridRnIapSpec() {
         }
     }
 
+    @Suppress("DEPRECATION")
     override fun showAlternativeBillingDialogAndroid(): Promise<Boolean> {
         return Promise.async {
             RnIapLog.payload("showAlternativeBillingDialogAndroid", null)
@@ -1647,6 +1658,7 @@ class HybridRnIap : HybridRnIapSpec() {
         }
     }
 
+    @Suppress("DEPRECATION")
     override fun createAlternativeBillingTokenAndroid(sku: Variant_NullType_String?): Promise<Variant_NullType_String> {
         return Promise.async {
             val skuValue = sku.unwrapString()
@@ -2000,6 +2012,7 @@ class HybridRnIap : HybridRnIapSpec() {
             "APPLE" -> IapStore.APPLE
             "GOOGLE" -> IapStore.GOOGLE
             "HORIZON" -> IapStore.HORIZON
+            "AMAZON" -> IapStore.AMAZON
             else -> IapStore.UNKNOWN
         }
     }

package/ios/HybridRnIap.swift

@@ -446,6 +446,18 @@ class HybridRnIap: HybridRnIapSpec {
                     if case .second(let google) = iapkit.google {
                         iapkitDict["google"] = ["purchaseToken": google.purchaseToken]
                     }
+                    if case .second(let amazon) = iapkit.amazon {
+                        var amazonDict: [String: Any] = [
+                            "receiptId": amazon.receiptId
+                        ]
+                        if case .second(let sandbox) = amazon.sandbox {
+                            amazonDict["sandbox"] = sandbox
+                        }
+                        if case .second(let userId) = amazon.userId {
+                            amazonDict["userId"] = userId
+                        }
+                        iapkitDict["amazon"] = amazonDict
+                    }
                     propsDict["iapkit"] = iapkitDict
                 }
                 // Use JSONSerialization + JSONDecoder like expo-iap does

package/lib/module/index.js

@@ -10,11 +10,12 @@ import { NitroModules } from 'react-native-nitro-modules';
 
 import { ErrorCode } from "./types.js";
 import { convertNitroProductToProduct, convertNitroPurchaseToPurchase, convertProductToProductSubscription, validateNitroProduct, validateNitroPurchase, convertNitroSubscriptionStatusToSubscriptionStatusIOS } from "./utils/type-bridge.js";
-import { parseErrorStringToJsonObj } from "./utils/error.js";
+import { isUserCancelledError, parseErrorStringToJsonObj } from "./utils/error.js";
 import { normalizeErrorCodeFromNative, createPurchaseError, DUPLICATE_PURCHASE_CODE } from "./utils/errorMapping.js";
 import { RnIapConsole } from "./utils/debug.js";
 import { getSuccessFromPurchaseVariant } from "./utils/purchase.js";
 import { parseAppTransactionPayload } from "./utils.js";
+import { getVegaIapModule, isVegaOS } from "./vega.js";
 
 // ------------------------------
 // Billing Programs API (Android 8.2.0+)
@@ -28,6 +29,7 @@ import { parseAppTransactionPayload } from "./utils.js";
 
 export * from "./types.js";
 export * from "./utils/error.js";
+export * from "./vega.js";
 const LEGACY_INAPP_WARNING = "[react-native-iap] `type: 'inapp'` is deprecated and will be removed in a future major version. Use 'in-app' instead.";
 const toErrorMessage = error => {
   if (typeof error === 'object' && error !== null && 'message' in error && error.message != null) {
@@ -35,6 +37,13 @@ const toErrorMessage = error => {
   }
   return String(error ?? '');
 };
+const parseErrorAndLogIfNeeded = (message, error) => {
+  const parsedError = parseErrorStringToJsonObj(error);
+  if (!isUserCancelledError(parsedError)) {
+    RnIapConsole.error(message, error);
+  }
+  return parsedError;
+};
 const unsupportedPlatformError = () => new Error(`Unsupported platform: ${Platform.OS}`);
 // ActiveSubscription and PurchaseError types are already exported via 'export * from ./types'
 
@@ -56,6 +65,10 @@ let iapRef = null;
  */
 export const isNitroReady = () => {
   if (iapRef) return true;
+  if (isVegaOS()) {
+    iapRef = getVegaIapModule();
+    return Boolean(iapRef);
+  }
   try {
     iapRef = NitroModules.createHybridObject('RnIap');
     return true;
@@ -86,9 +99,20 @@ export const isMacOS = () => {
 export const isStandardIOS = () => {
   return Platform.OS === 'ios' && !isTVOS() && !isMacOS();
 };
+const isAndroidStoreRuntime = () => {
+  return Platform.OS === 'android' || isVegaOS();
+};
 const IAP = {
   get instance() {
     if (iapRef) return iapRef;
+    if (isVegaOS()) {
+      const vegaModule = getVegaIapModule();
+      if (!vegaModule) {
+        throw new Error('Amazon Vega IAP module is unavailable. Install @amazon-devices/keplerscript-appstore-iap-lib in the Vega app target and build with the React Native for Vega kepler platform.');
+      }
+      iapRef = vegaModule;
+      return iapRef;
+    }
 
     // Attempt to create the HybridObject and map common Nitro/JSI readiness errors
     try {
@@ -500,7 +524,7 @@ function tryAttachSubscriptionBillingIssueNative() {
   } catch (e) {
     const msg = toErrorMessage(e);
     if (msg.includes('Nitro runtime not installed')) {
-      RnIapConsole.warn('[subscriptionBillingIssueListener] Nitro not ready yet; will retry on next registration after initConnection()');
+      RnIapConsole.warn('[subscriptionBillingIssueListener] Nitro not ready yet; will retry after initConnection()');
     } else {
       throw e;
     }
@@ -590,7 +614,7 @@ export const fetchProducts = async request => {
 
         // item.type === 'subs' case
         // For Android, check if subscription items have actual offers
-        if (Platform.OS === 'android' && item.platform === 'android' && item.type === 'subs') {
+        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}`);
@@ -622,8 +646,7 @@ export const fetchProducts = async request => {
     }
     return convertedProducts;
   } catch (error) {
-    RnIapConsole.error('[fetchProducts] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[fetchProducts] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -677,9 +700,22 @@ export const getAvailablePurchases = async options => {
         RnIapConsole.warn(`[getAvailablePurchases] Some purchases failed validation: ${nitroPurchases.length - validPurchases.length} invalid`);
       }
       return validPurchases.map(convertNitroPurchaseToPurchase);
-    } else if (Platform.OS === 'android') {
-      // For Android, we need to call twice for inapp and subs
+    } else if (isAndroidStoreRuntime()) {
       const includeSuspended = Boolean(options?.includeSuspendedAndroid ?? false);
+      if (isVegaOS()) {
+        const nitroPurchases = await IAP.instance.getAvailablePurchases({
+          android: {
+            includeSuspended
+          }
+        });
+        const validPurchases = nitroPurchases.filter(validateNitroPurchase);
+        if (validPurchases.length !== nitroPurchases.length) {
+          RnIapConsole.warn(`[getAvailablePurchases] Some Vega purchases failed validation: ${nitroPurchases.length - validPurchases.length} invalid`);
+        }
+        return validPurchases.map(convertNitroPurchaseToPurchase);
+      }
+
+      // For Android Play/Horizon/Fire OS, query in-app items and subscriptions separately.
       const inappNitroPurchases = await IAP.instance.getAvailablePurchases({
         android: {
           type: 'inapp',
@@ -728,8 +764,7 @@ export const getPromotedProductIOS = async () => {
     const converted = convertNitroProductToProduct(nitroProduct);
     return converted.platform === 'ios' ? converted : null;
   } catch (error) {
-    RnIapConsole.error('[getPromotedProductIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[getPromotedProductIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -772,8 +807,8 @@ export const getStorefrontIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/get-storefront}
  */
 export const getStorefront = async () => {
-  if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
-    RnIapConsole.warn('[getStorefront] Storefront lookup is only supported on iOS and Android.');
+  if (Platform.OS !== 'ios' && !isAndroidStoreRuntime()) {
+    RnIapConsole.warn('[getStorefront] Storefront lookup is only supported on iOS, Android, and Vega OS.');
     return '';
   }
   const hasUnifiedMethod = typeof IAP.instance.getStorefront === 'function';
@@ -858,8 +893,7 @@ export const subscriptionStatusIOS = async sku => {
     if (!Array.isArray(statuses)) return [];
     return statuses.filter(status => status != null).map(convertNitroSubscriptionStatusToSubscriptionStatusIOS);
   } catch (error) {
-    RnIapConsole.error('[subscriptionStatusIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[subscriptionStatusIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -889,8 +923,7 @@ export const currentEntitlementIOS = async sku => {
     }
     return null;
   } catch (error) {
-    RnIapConsole.error('[currentEntitlementIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[currentEntitlementIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -920,8 +953,7 @@ export const latestTransactionIOS = async sku => {
     }
     return null;
   } catch (error) {
-    RnIapConsole.error('[latestTransactionIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[latestTransactionIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -946,8 +978,7 @@ export const getPendingTransactionsIOS = async () => {
     const nitroPurchases = await IAP.instance.getPendingTransactionsIOS();
     return nitroPurchases.map(convertNitroPurchaseToPurchase).filter(purchase => purchase.platform === 'ios');
   } catch (error) {
-    RnIapConsole.error('[getPendingTransactionsIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[getPendingTransactionsIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -970,8 +1001,7 @@ export const getAllTransactionsIOS = async () => {
     const nitroPurchases = await IAP.instance.getAllTransactionsIOS();
     return nitroPurchases.map(convertNitroPurchaseToPurchase).filter(purchase => purchase.platform === 'ios');
   } catch (error) {
-    RnIapConsole.error('[getAllTransactionsIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[getAllTransactionsIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -996,8 +1026,7 @@ export const showManageSubscriptionsIOS = async () => {
     const nitroPurchases = await IAP.instance.showManageSubscriptionsIOS();
     return nitroPurchases.map(convertNitroPurchaseToPurchase).filter(purchase => purchase.platform === 'ios');
   } catch (error) {
-    RnIapConsole.error('[showManageSubscriptionsIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[showManageSubscriptionsIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1022,8 +1051,7 @@ export const isEligibleForIntroOfferIOS = async groupID => {
   try {
     return await IAP.instance.isEligibleForIntroOfferIOS(groupID);
   } catch (error) {
-    RnIapConsole.error('[isEligibleForIntroOfferIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[isEligibleForIntroOfferIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1048,8 +1076,7 @@ export const getReceiptDataIOS = async () => {
   try {
     return await IAP.instance.getReceiptDataIOS();
   } catch (error) {
-    RnIapConsole.error('[getReceiptDataIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[getReceiptDataIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1069,8 +1096,7 @@ export const getReceiptIOS = async () => {
     }
     return await IAP.instance.getReceiptDataIOS();
   } catch (error) {
-    RnIapConsole.error('[getReceiptIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[getReceiptIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1090,8 +1116,7 @@ export const requestReceiptRefreshIOS = async () => {
     }
     return await IAP.instance.getReceiptDataIOS();
   } catch (error) {
-    RnIapConsole.error('[requestReceiptRefreshIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[requestReceiptRefreshIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1116,8 +1141,7 @@ export const isTransactionVerifiedIOS = async sku => {
   try {
     return await IAP.instance.isTransactionVerifiedIOS(sku);
   } catch (error) {
-    RnIapConsole.error('[isTransactionVerifiedIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[isTransactionVerifiedIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1142,8 +1166,7 @@ export const getTransactionJwsIOS = async sku => {
   try {
     return await IAP.instance.getTransactionJwsIOS(sku);
   } catch (error) {
-    RnIapConsole.error('[getTransactionJwsIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[getTransactionJwsIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1178,10 +1201,13 @@ export const getTransactionJwsIOS = async sku => {
  */
 export const initConnection = async config => {
   try {
-    return await IAP.instance.initConnection(config);
+    const result = await IAP.instance.initConnection(config);
+    if (subscriptionBillingIssueJsListeners.size > 0) {
+      tryAttachSubscriptionBillingIssueNative();
+    }
+    return result;
   } catch (error) {
-    RnIapConsole.error('Failed to initialize IAP connection:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('Failed to initialize IAP connection:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1203,8 +1229,7 @@ export const endConnection = async () => {
     resetListenerState();
     return result;
   } catch (error) {
-    RnIapConsole.error('Failed to end IAP connection:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('Failed to end IAP connection:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1229,8 +1254,7 @@ export const restorePurchases = async () => {
       onlyIncludeActiveItemsIOS: true
     });
   } catch (error) {
-    RnIapConsole.error('Failed to restore purchases:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('Failed to restore purchases:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1284,7 +1308,7 @@ export const requestPurchase = async request => {
       if (!iosRequest?.sku) {
         throw new Error('Invalid request for iOS. The `sku` property is required.');
       }
-    } else if (Platform.OS === 'android') {
+    } else if (isAndroidStoreRuntime()) {
       // Support both 'google' (recommended) and 'android' (deprecated) fields
       const androidRequest = perPlatformRequest.google ?? perPlatformRequest.android;
       if (!androidRequest?.skus?.length) {
@@ -1338,7 +1362,7 @@ export const requestPurchase = async request => {
 
     // Support both 'google' (recommended) and 'android' (deprecated) fields
     const androidRequestSource = perPlatformRequest.google ?? perPlatformRequest.android;
-    if (Platform.OS === 'android' && androidRequestSource) {
+    if (isAndroidStoreRuntime() && androidRequestSource) {
       const androidRequest = isSubs ? androidRequestSource : androidRequestSource;
       const androidPayload = {
         skus: androidRequest.skus
@@ -1380,8 +1404,7 @@ export const requestPurchase = async request => {
     }
     return await IAP.instance.requestPurchase(unifiedRequest);
   } catch (error) {
-    RnIapConsole.error('Failed to request purchase:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('Failed to request purchase:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1432,7 +1455,7 @@ export const finishTransaction = async args => {
           transactionId: purchase.id
         }
       };
-    } else if (Platform.OS === 'android') {
+    } else if (isAndroidStoreRuntime()) {
       const token = purchase.purchaseToken ?? undefined;
       if (!token) {
         throw new Error('purchaseToken required to finish Android transaction');
@@ -1482,8 +1505,8 @@ export const finishTransaction = async args => {
  */
 export const acknowledgePurchaseAndroid = async purchaseToken => {
   try {
-    if (Platform.OS !== 'android') {
-      throw new Error('acknowledgePurchaseAndroid is only available on Android');
+    if (!isAndroidStoreRuntime()) {
+      throw new Error('acknowledgePurchaseAndroid is only available on Android and Vega OS');
     }
     const result = await IAP.instance.finishTransaction({
       android: {
@@ -1493,8 +1516,7 @@ export const acknowledgePurchaseAndroid = async purchaseToken => {
     });
     return getSuccessFromPurchaseVariant(result, 'acknowledgePurchaseAndroid');
   } catch (error) {
-    RnIapConsole.error('Failed to acknowledge purchase Android:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('Failed to acknowledge purchase Android:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1518,8 +1540,8 @@ export const acknowledgePurchaseAndroid = async purchaseToken => {
  */
 export const consumePurchaseAndroid = async purchaseToken => {
   try {
-    if (Platform.OS !== 'android') {
-      throw new Error('consumePurchaseAndroid is only available on Android');
+    if (!isAndroidStoreRuntime()) {
+      throw new Error('consumePurchaseAndroid is only available on Android and Vega OS');
     }
     const result = await IAP.instance.finishTransaction({
       android: {
@@ -1529,8 +1551,7 @@ export const consumePurchaseAndroid = async purchaseToken => {
     });
     return getSuccessFromPurchaseVariant(result, 'consumePurchaseAndroid');
   } catch (error) {
-    RnIapConsole.error('Failed to consume purchase Android:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('Failed to consume purchase Android:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1656,8 +1677,7 @@ export const validateReceipt = async options => {
       return result;
     }
   } catch (error) {
-    RnIapConsole.error('[validateReceipt] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[validateReceipt] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1713,8 +1733,14 @@ export const validateReceiptIOS = async options => {
  *   provider: 'iapkit',
  *   iapkit: {
  *     apiKey: 'your-api-key',
- *     apple: { jws: purchase.purchaseToken },
- *     google: { purchaseToken: purchase.purchaseToken },
+ *     // Choose exactly one store payload.
+ *     // apple: { jws: purchase.purchaseToken },
+ *     // google: { purchaseToken: purchase.purchaseToken },
+ *     amazon: {
+ *       userId: amazonUserId,
+ *       receiptId: purchase.purchaseToken,
+ *       sandbox: __DEV__,
+ *     },
  *   },
  * });
  * ```
@@ -1744,8 +1770,7 @@ export const verifyPurchaseWithProvider = async options => {
       errors: result.errors ?? null
     };
   } catch (error) {
-    RnIapConsole.error('[verifyPurchaseWithProvider] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[verifyPurchaseWithProvider] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1770,8 +1795,7 @@ export const syncIOS = async () => {
     const result = await IAP.instance.syncIOS();
     return Boolean(result);
   } catch (error) {
-    RnIapConsole.error('[syncIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[syncIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1796,8 +1820,7 @@ export const presentCodeRedemptionSheetIOS = async () => {
     const result = await IAP.instance.presentCodeRedemptionSheetIOS();
     return Boolean(result);
   } catch (error) {
-    RnIapConsole.error('[presentCodeRedemptionSheetIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[presentCodeRedemptionSheetIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1846,8 +1869,7 @@ export const requestPurchaseOnPromotedProductIOS = async () => {
     }
     return true;
   } catch (error) {
-    RnIapConsole.error('[requestPurchaseOnPromotedProductIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[requestPurchaseOnPromotedProductIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1872,8 +1894,7 @@ export const clearTransactionIOS = async () => {
     await IAP.instance.clearTransactionIOS();
     return true;
   } catch (error) {
-    RnIapConsole.error('[clearTransactionIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[clearTransactionIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1899,8 +1920,7 @@ export const beginRefundRequestIOS = async sku => {
     const status = await IAP.instance.beginRefundRequestIOS(sku);
     return status ?? null;
   } catch (error) {
-    RnIapConsole.error('[beginRefundRequestIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[beginRefundRequestIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -1946,8 +1966,7 @@ export const deepLinkToSubscriptionsIOS = async () => {
     await IAP.instance.showManageSubscriptionsIOS();
     return true;
   } catch (error) {
-    RnIapConsole.error('[deepLinkToSubscriptionsIOS] Failed:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('[deepLinkToSubscriptionsIOS] Failed:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,
@@ -2015,8 +2034,7 @@ export const getActiveSubscriptions = async subscriptionIds => {
       RnIapConsole.error('IAP connection not initialized:', error);
       throw error;
     }
-    RnIapConsole.error('Failed to get active subscriptions:', error);
-    const parsedError = parseErrorStringToJsonObj(error);
+    const parsedError = parseErrorAndLogIfNeeded('Failed to get active subscriptions:', error);
     throw createPurchaseError({
       code: parsedError.code,
       message: parsedError.message,