react-native-iap 15.4.0 → 15.4.1

package/nitrogen/generated/shared/c++/NitroRequestPurchaseAndroid.hpp

@@ -68,7 +68,7 @@ namespace margelo::nitro::iap {
     explicit NitroRequestPurchaseAndroid(std::vector<std::string> skus, std::optional<std::variant<nitro::NullType, std::string>> obfuscatedAccountId, std::optional<std::variant<nitro::NullType, std::string>> obfuscatedProfileId, std::optional<std::variant<nitro::NullType, bool>> isOfferPersonalized, std::optional<std::variant<nitro::NullType, std::string>> offerToken, std::optional<std::variant<nitro::NullType, std::vector<AndroidSubscriptionOfferInput>>> subscriptionOffers, std::optional<std::variant<nitro::NullType, double>> replacementMode, std::optional<std::variant<nitro::NullType, std::string>> purchaseToken, std::optional<std::variant<nitro::NullType, std::string>> originalExternalTransactionId, std::optional<std::variant<nitro::NullType, DeveloperBillingOptionParamsAndroid>> developerBillingOption, std::optional<std::variant<nitro::NullType, SubscriptionProductReplacementParamsAndroid>> subscriptionProductReplacementParams): skus(skus), obfuscatedAccountId(obfuscatedAccountId), obfuscatedProfileId(obfuscatedProfileId), isOfferPersonalized(isOfferPersonalized), offerToken(offerToken), subscriptionOffers(subscriptionOffers), replacementMode(replacementMode), purchaseToken(purchaseToken), originalExternalTransactionId(originalExternalTransactionId), developerBillingOption(developerBillingOption), subscriptionProductReplacementParams(subscriptionProductReplacementParams) {}
 
   public:
-    friend bool operator==(const NitroRequestPurchaseAndroid& lhs, const NitroRequestPurchaseAndroid& rhs) = default;
+    // NitroRequestPurchaseAndroid is not equatable because these properties are not equatable: skus, subscriptionOffers
   };
 
 } // namespace margelo::nitro::iap

package/nitrogen/generated/shared/c++/NitroSubscriptionStatus.hpp

@@ -28,12 +28,12 @@
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
 
-// Forward declaration of `NitroSubscriptionRenewalInfo` to properly resolve imports.
-namespace margelo::nitro::iap { struct NitroSubscriptionRenewalInfo; }
+// Forward declaration of `NitroRenewalInfoIOS` to properly resolve imports.
+namespace margelo::nitro::iap { struct NitroRenewalInfoIOS; }
 
 #include <string>
 #include <NitroModules/Null.hpp>
-#include "NitroSubscriptionRenewalInfo.hpp"
+#include "NitroRenewalInfoIOS.hpp"
 #include <variant>
 #include <optional>
 
@@ -46,11 +46,11 @@ namespace margelo::nitro::iap {
   public:
     double state     SWIFT_PRIVATE;
     std::string platform     SWIFT_PRIVATE;
-    std::optional<std::variant<nitro::NullType, NitroSubscriptionRenewalInfo>> renewalInfo     SWIFT_PRIVATE;
+    std::optional<std::variant<nitro::NullType, NitroRenewalInfoIOS>> renewalInfo     SWIFT_PRIVATE;
 
   public:
     NitroSubscriptionStatus() = default;
-    explicit NitroSubscriptionStatus(double state, std::string platform, std::optional<std::variant<nitro::NullType, NitroSubscriptionRenewalInfo>> renewalInfo): state(state), platform(platform), renewalInfo(renewalInfo) {}
+    explicit NitroSubscriptionStatus(double state, std::string platform, std::optional<std::variant<nitro::NullType, NitroRenewalInfoIOS>> renewalInfo): state(state), platform(platform), renewalInfo(renewalInfo) {}
 
   public:
     friend bool operator==(const NitroSubscriptionStatus& lhs, const NitroSubscriptionStatus& rhs) = default;
@@ -68,14 +68,14 @@ namespace margelo::nitro {
       return margelo::nitro::iap::NitroSubscriptionStatus(
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "state"))),
         JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "platform"))),
-        JSIConverter<std::optional<std::variant<nitro::NullType, margelo::nitro::iap::NitroSubscriptionRenewalInfo>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "renewalInfo")))
+        JSIConverter<std::optional<std::variant<nitro::NullType, margelo::nitro::iap::NitroRenewalInfoIOS>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "renewalInfo")))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::NitroSubscriptionStatus& arg) {
       jsi::Object obj(runtime);
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "state"), JSIConverter<double>::toJSI(runtime, arg.state));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "platform"), JSIConverter<std::string>::toJSI(runtime, arg.platform));
-      obj.setProperty(runtime, PropNameIDCache::get(runtime, "renewalInfo"), JSIConverter<std::optional<std::variant<nitro::NullType, margelo::nitro::iap::NitroSubscriptionRenewalInfo>>>::toJSI(runtime, arg.renewalInfo));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "renewalInfo"), JSIConverter<std::optional<std::variant<nitro::NullType, margelo::nitro::iap::NitroRenewalInfoIOS>>>::toJSI(runtime, arg.renewalInfo));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -88,7 +88,7 @@ namespace margelo::nitro {
       }
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "state")))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "platform")))) return false;
-      if (!JSIConverter<std::optional<std::variant<nitro::NullType, margelo::nitro::iap::NitroSubscriptionRenewalInfo>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "renewalInfo")))) return false;
+      if (!JSIConverter<std::optional<std::variant<nitro::NullType, margelo::nitro::iap::NitroRenewalInfoIOS>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "renewalInfo")))) return false;
       return true;
     }
   };

package/nitrogen/generated/shared/c++/NitroVerifyPurchaseWithProviderResult.hpp

@@ -59,7 +59,7 @@ namespace margelo::nitro::iap {
     explicit NitroVerifyPurchaseWithProviderResult(std::optional<std::variant<nitro::NullType, NitroVerifyPurchaseWithIapkitResult>> iapkit, std::optional<std::variant<nitro::NullType, std::vector<NitroVerifyPurchaseWithProviderError>>> errors, PurchaseVerificationProvider provider): iapkit(iapkit), errors(errors), provider(provider) {}
 
   public:
-    friend bool operator==(const NitroVerifyPurchaseWithProviderResult& lhs, const NitroVerifyPurchaseWithProviderResult& rhs) = default;
+    // NitroVerifyPurchaseWithProviderResult is not equatable because these properties are not equatable: errors
   };
 
 } // namespace margelo::nitro::iap

package/nitrogen/generated/shared/c++/PendingPurchaseUpdateAndroid.hpp

@@ -48,7 +48,7 @@ namespace margelo::nitro::iap {
     explicit PendingPurchaseUpdateAndroid(std::vector<std::string> products, std::string purchaseToken): products(products), purchaseToken(purchaseToken) {}
 
   public:
-    friend bool operator==(const PendingPurchaseUpdateAndroid& lhs, const PendingPurchaseUpdateAndroid& rhs) = default;
+    // PendingPurchaseUpdateAndroid is not equatable because these properties are not equatable: products
   };
 
 } // namespace margelo::nitro::iap

package/nitrogen/generated/shared/c++/PurchaseAndroid.hpp

@@ -82,7 +82,7 @@ namespace margelo::nitro::iap {
     explicit PurchaseAndroid(std::optional<std::variant<nitro::NullType, bool>> autoRenewingAndroid, std::optional<std::variant<nitro::NullType, std::string>> currentPlanId, std::optional<std::variant<nitro::NullType, std::string>> dataAndroid, std::optional<std::variant<nitro::NullType, std::string>> developerPayloadAndroid, std::string id, std::optional<std::variant<nitro::NullType, std::vector<std::string>>> ids, std::optional<std::variant<nitro::NullType, bool>> isAcknowledgedAndroid, bool isAutoRenewing, std::optional<std::variant<nitro::NullType, bool>> isSuspendedAndroid, std::optional<std::variant<nitro::NullType, std::string>> obfuscatedAccountIdAndroid, std::optional<std::variant<nitro::NullType, std::string>> obfuscatedProfileIdAndroid, std::optional<std::variant<nitro::NullType, std::string>> packageNameAndroid, std::optional<std::variant<nitro::NullType, PendingPurchaseUpdateAndroid>> pendingPurchaseUpdateAndroid, IapPlatform platform, std::string productId, PurchaseState purchaseState, std::optional<std::variant<nitro::NullType, std::string>> purchaseToken, double quantity, std::optional<std::variant<nitro::NullType, std::string>> signatureAndroid, IapStore store, double transactionDate, std::optional<std::variant<nitro::NullType, std::string>> transactionId): autoRenewingAndroid(autoRenewingAndroid), currentPlanId(currentPlanId), dataAndroid(dataAndroid), developerPayloadAndroid(developerPayloadAndroid), id(id), ids(ids), isAcknowledgedAndroid(isAcknowledgedAndroid), isAutoRenewing(isAutoRenewing), isSuspendedAndroid(isSuspendedAndroid), obfuscatedAccountIdAndroid(obfuscatedAccountIdAndroid), obfuscatedProfileIdAndroid(obfuscatedProfileIdAndroid), packageNameAndroid(packageNameAndroid), pendingPurchaseUpdateAndroid(pendingPurchaseUpdateAndroid), platform(platform), productId(productId), purchaseState(purchaseState), purchaseToken(purchaseToken), quantity(quantity), signatureAndroid(signatureAndroid), store(store), transactionDate(transactionDate), transactionId(transactionId) {}
 
   public:
-    friend bool operator==(const PurchaseAndroid& lhs, const PurchaseAndroid& rhs) = default;
+    // PurchaseAndroid is not equatable because these properties are not equatable: ids, pendingPurchaseUpdateAndroid
   };
 
 } // namespace margelo::nitro::iap

package/nitrogen/generated/shared/c++/PurchaseIOS.hpp

@@ -109,7 +109,7 @@ namespace margelo::nitro::iap {
     explicit PurchaseIOS(std::optional<std::variant<nitro::NullType, AdvancedCommerceInfoIOS>> advancedCommerceInfoIOS, std::optional<std::variant<nitro::NullType, std::string>> appAccountToken, std::optional<std::variant<nitro::NullType, std::string>> appBundleIdIOS, std::optional<SubscriptionBillingPlanTypeIOS> billingPlanTypeIOS, std::optional<std::variant<nitro::NullType, TransactionCommitmentInfoIOS>> commitmentInfoIOS, std::optional<std::variant<nitro::NullType, std::string>> countryCodeIOS, std::optional<std::variant<nitro::NullType, std::string>> currencyCodeIOS, std::optional<std::variant<nitro::NullType, std::string>> currencySymbolIOS, std::optional<std::variant<nitro::NullType, std::string>> currentPlanId, std::optional<std::variant<nitro::NullType, std::string>> environmentIOS, std::optional<std::variant<nitro::NullType, double>> expirationDateIOS, std::string id, std::optional<std::variant<nitro::NullType, std::vector<std::string>>> ids, bool isAutoRenewing, std::optional<std::variant<nitro::NullType, bool>> isUpgradedIOS, std::optional<std::variant<nitro::NullType, PurchaseOfferIOS>> offerIOS, std::optional<std::variant<nitro::NullType, double>> originalTransactionDateIOS, std::optional<std::variant<nitro::NullType, std::string>> originalTransactionIdentifierIOS, std::optional<std::variant<nitro::NullType, std::string>> ownershipTypeIOS, IapPlatform platform, std::string productId, PurchaseState purchaseState, std::optional<std::variant<nitro::NullType, std::string>> purchaseToken, double quantity, std::optional<std::variant<nitro::NullType, double>> quantityIOS, std::optional<std::variant<nitro::NullType, std::string>> reasonIOS, std::optional<std::variant<nitro::NullType, std::string>> reasonStringRepresentationIOS, std::optional<std::variant<nitro::NullType, RenewalInfoIOS>> renewalInfoIOS, std::optional<std::variant<nitro::NullType, double>> revocationDateIOS, std::optional<std::variant<nitro::NullType, std::string>> revocationReasonIOS, IapStore store, std::optional<std::variant<nitro::NullType, std::string>> storefrontCountryCodeIOS, std::optional<std::variant<nitro::NullType, std::string>> subscriptionGroupIdIOS, double transactionDate, std::string transactionId, std::optional<std::variant<nitro::NullType, std::string>> transactionReasonIOS, std::optional<std::variant<nitro::NullType, std::string>> webOrderLineItemIdIOS): advancedCommerceInfoIOS(advancedCommerceInfoIOS), appAccountToken(appAccountToken), appBundleIdIOS(appBundleIdIOS), billingPlanTypeIOS(billingPlanTypeIOS), commitmentInfoIOS(commitmentInfoIOS), countryCodeIOS(countryCodeIOS), currencyCodeIOS(currencyCodeIOS), currencySymbolIOS(currencySymbolIOS), currentPlanId(currentPlanId), environmentIOS(environmentIOS), expirationDateIOS(expirationDateIOS), id(id), ids(ids), isAutoRenewing(isAutoRenewing), isUpgradedIOS(isUpgradedIOS), offerIOS(offerIOS), originalTransactionDateIOS(originalTransactionDateIOS), originalTransactionIdentifierIOS(originalTransactionIdentifierIOS), ownershipTypeIOS(ownershipTypeIOS), platform(platform), productId(productId), purchaseState(purchaseState), purchaseToken(purchaseToken), quantity(quantity), quantityIOS(quantityIOS), reasonIOS(reasonIOS), reasonStringRepresentationIOS(reasonStringRepresentationIOS), renewalInfoIOS(renewalInfoIOS), revocationDateIOS(revocationDateIOS), revocationReasonIOS(revocationReasonIOS), store(store), storefrontCountryCodeIOS(storefrontCountryCodeIOS), subscriptionGroupIdIOS(subscriptionGroupIdIOS), transactionDate(transactionDate), transactionId(transactionId), transactionReasonIOS(transactionReasonIOS), webOrderLineItemIdIOS(webOrderLineItemIdIOS) {}
 
   public:
-    friend bool operator==(const PurchaseIOS& lhs, const PurchaseIOS& rhs) = default;
+    // PurchaseIOS is not equatable because these properties are not equatable: advancedCommerceInfoIOS, ids
   };
 
 } // namespace margelo::nitro::iap

package/nitrogen/generated/shared/c++/UserChoiceBillingDetails.hpp

@@ -28,9 +28,14 @@
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
 
-
+// Forward declaration of `DeveloperProvidedBillingProductAndroid` to properly resolve imports.
+namespace margelo::nitro::iap { struct DeveloperProvidedBillingProductAndroid; }
 
 #include <string>
+#include <NitroModules/Null.hpp>
+#include <variant>
+#include <optional>
+#include "DeveloperProvidedBillingProductAndroid.hpp"
 #include <vector>
 
 namespace margelo::nitro::iap {
@@ -41,14 +46,16 @@ namespace margelo::nitro::iap {
   struct UserChoiceBillingDetails final {
   public:
     std::string externalTransactionToken     SWIFT_PRIVATE;
+    std::optional<std::variant<nitro::NullType, std::string>> originalExternalTransactionId     SWIFT_PRIVATE;
+    std::optional<std::variant<nitro::NullType, std::vector<DeveloperProvidedBillingProductAndroid>>> productDetailsAndroid     SWIFT_PRIVATE;
     std::vector<std::string> products     SWIFT_PRIVATE;
 
   public:
     UserChoiceBillingDetails() = default;
-    explicit UserChoiceBillingDetails(std::string externalTransactionToken, std::vector<std::string> products): externalTransactionToken(externalTransactionToken), products(products) {}
+    explicit UserChoiceBillingDetails(std::string externalTransactionToken, std::optional<std::variant<nitro::NullType, std::string>> originalExternalTransactionId, std::optional<std::variant<nitro::NullType, std::vector<DeveloperProvidedBillingProductAndroid>>> productDetailsAndroid, std::vector<std::string> products): externalTransactionToken(externalTransactionToken), originalExternalTransactionId(originalExternalTransactionId), productDetailsAndroid(productDetailsAndroid), products(products) {}
 
   public:
-    friend bool operator==(const UserChoiceBillingDetails& lhs, const UserChoiceBillingDetails& rhs) = default;
+    // UserChoiceBillingDetails is not equatable because these properties are not equatable: productDetailsAndroid, products
   };
 
 } // namespace margelo::nitro::iap
@@ -62,12 +69,16 @@ namespace margelo::nitro {
       jsi::Object obj = arg.asObject(runtime);
       return margelo::nitro::iap::UserChoiceBillingDetails(
         JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "externalTransactionToken"))),
+        JSIConverter<std::optional<std::variant<nitro::NullType, std::string>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "originalExternalTransactionId"))),
+        JSIConverter<std::optional<std::variant<nitro::NullType, std::vector<margelo::nitro::iap::DeveloperProvidedBillingProductAndroid>>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "productDetailsAndroid"))),
         JSIConverter<std::vector<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "products")))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::UserChoiceBillingDetails& arg) {
       jsi::Object obj(runtime);
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "externalTransactionToken"), JSIConverter<std::string>::toJSI(runtime, arg.externalTransactionToken));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "originalExternalTransactionId"), JSIConverter<std::optional<std::variant<nitro::NullType, std::string>>>::toJSI(runtime, arg.originalExternalTransactionId));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "productDetailsAndroid"), JSIConverter<std::optional<std::variant<nitro::NullType, std::vector<margelo::nitro::iap::DeveloperProvidedBillingProductAndroid>>>>::toJSI(runtime, arg.productDetailsAndroid));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "products"), JSIConverter<std::vector<std::string>>::toJSI(runtime, arg.products));
       return obj;
     }
@@ -80,6 +91,8 @@ namespace margelo::nitro {
         return false;
       }
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "externalTransactionToken")))) return false;
+      if (!JSIConverter<std::optional<std::variant<nitro::NullType, std::string>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "originalExternalTransactionId")))) return false;
+      if (!JSIConverter<std::optional<std::variant<nitro::NullType, std::vector<margelo::nitro::iap::DeveloperProvidedBillingProductAndroid>>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "productDetailsAndroid")))) return false;
       if (!JSIConverter<std::vector<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "products")))) return false;
       return true;
     }

package/openiap-versions.json

@@ -1,5 +1,5 @@
 {
-  "spec": "2.1.0",
-  "google": "2.3.0",
-  "apple": "2.2.5"
+  "spec": "2.3.0",
+  "google": "2.3.1",
+  "apple": "2.3.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "15.4.0",
+  "version": "15.4.1",
   "description": "React Native In-App Purchases module for iOS and Android using Nitro",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -105,12 +105,12 @@
     "husky": "^8.0.3",
     "jest": "^30.1.1",
     "lint-staged": "^15.2.0",
-    "nitrogen": "^0.35.0",
+    "nitrogen": "^0.35.10",
     "prettier": "^3.3.3",
     "react": "19.1.0",
     "react-native": "0.81.1",
     "react-native-builder-bob": "^0.38.4",
-    "react-native-nitro-modules": "^0.35.0",
+    "react-native-nitro-modules": "^0.35.10",
     "react-test-renderer": "^19.1.1",
     "typescript": "^5.9.2"
   },
@@ -119,7 +119,7 @@
     "@amazon-devices/package-manager-lib": "~1.0.1767254401",
     "react": "*",
     "react-native": "*",
-    "react-native-nitro-modules": "^0.35.0"
+    "react-native-nitro-modules": "^0.35.10"
   },
   "peerDependenciesMeta": {
     "@amazon-devices/keplerscript-appstore-iap-lib": {
@@ -174,5 +174,8 @@
       "prettier --write"
     ]
   },
-  "packageManager": "yarn@3.6.1"
+  "packageManager": "yarn@3.6.1",
+  "resolutions": {
+    "nitrogen@^0.35.10": "patch:nitrogen@npm%3A0.35.10#./.yarn/patches/nitrogen-npm-0.35.10-ac6318648e.patch"
+  }
 }

package/src/hooks/useIAP.ts

@@ -311,9 +311,9 @@ export interface UseIapOptions {
     details: DeveloperProvidedBillingDetailsAndroid,
   ) => 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 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
@@ -435,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

package/src/index.ts

@@ -314,13 +314,23 @@ const purchaseUpdateDuplicateNativeHandler: NitroPurchaseListener = (
 const purchaseErrorJsListeners = new Set<(error: PurchaseError) => void>();
 let purchaseErrorNativeAttached = false;
 const purchaseErrorNativeHandler: NitroPurchaseErrorListener = (error) => {
+  const normalizedCode =
+    error.code === DUPLICATE_PURCHASE_CODE
+      ? ErrorCode.DuplicatePurchase
+      : normalizeErrorCodeFromNative(error.code);
   const normalized: PurchaseError = {
-    code:
-      error.code === DUPLICATE_PURCHASE_CODE
-        ? ErrorCode.DuplicatePurchase
-        : normalizeErrorCodeFromNative(error.code),
+    code: normalizedCode,
     message: error.message,
-    productId: undefined,
+    responseCode:
+      normalizedCode === ErrorCode.QueryProduct
+        ? error.responseCode
+        : undefined,
+    debugMessage: error.debugMessage,
+    productId: error.productId,
+    productIds: error.productIds,
+    productType: error.productType,
+    isEmptyProductList: error.isEmptyProductList,
+    subResponseCodeAndroid: error.subResponseCodeAndroid,
   };
   for (const listener of purchaseErrorJsListeners) {
     try {
@@ -712,8 +722,8 @@ export const developerProvidedBillingListenerAndroid = (
 /**
  * Listen for subscription billing-issue events (cross-platform).
  *
- * Fires when an active subscription enters a billing-issue state:
- * - iOS 18+ / Mac Catalyst 18+: via StoreKit 2 `Message.Reason.billingIssue`.
+ * Fires when a subscription enters a billing-issue state:
+ * - iOS / Mac Catalyst 16.4+ and visionOS 1.0+: via StoreKit 2 `Message.Reason.billingIssue`.
  * - Android (Play Billing 8.1+): when `isSuspendedAndroid === true` is observed.
  * - Horizon / iOS 17 / older platforms: never fires.
  *
@@ -854,7 +864,8 @@ export const fetchProducts: QueryField<'fetchProducts'> = async (request) => {
 
     if (normalizedType === 'all') {
       const converted = (await fetchAndConvert('all')) as (
-        Product | ProductSubscription
+        | Product
+        | ProductSubscription
       )[];
 
       RnIapConsole.debug(
@@ -1108,6 +1119,12 @@ export const getStorefrontIOS: QueryField<'getStorefrontIOS'> = async () => {
 
   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);
@@ -1122,35 +1139,50 @@ export const getStorefrontIOS: QueryField<'getStorefrontIOS'> = async () => {
  */
 export const getStorefront: QueryField<'getStorefront'> = async () => {
   if (Platform.OS !== 'ios' && !isAndroidStoreRuntime()) {
-    RnIapConsole.warn(
-      '[getStorefront] Storefront lookup is only supported on iOS, Android, and Vega OS.',
-    );
-    return '';
+    throw createPurchaseError({
+      code: ErrorCode.FeatureNotSupported,
+      message: `Storefront lookup is not supported on ${Platform.OS}.`,
+    });
   }
 
   const hasUnifiedMethod = typeof IAP.instance.getStorefront === 'function';
 
-  if (!hasUnifiedMethod && Platform.OS === 'ios') {
-    return getStorefrontIOS();
-  }
-
-  if (!hasUnifiedMethod) {
-    RnIapConsole.warn(
-      '[getStorefront] Native getStorefront is not available on this build.',
-    );
-    return '';
+  if (!hasUnifiedMethod && Platform.OS !== 'ios') {
+    throw createPurchaseError({
+      code: ErrorCode.FeatureNotSupported,
+      message: 'Native getStorefront is not available on this build.',
+      platform: 'android',
+    });
   }
 
+  let storefront: string | null | undefined;
   try {
-    const storefront = await IAP.instance.getStorefront();
-    return storefront ?? '';
+    storefront = hasUnifiedMethod
+      ? await IAP.instance.getStorefront()
+      : await getStorefrontIOS();
   } catch (error) {
-    RnIapConsole.error(
+    const parsedError = parseErrorAndLogIfNeeded(
       `[getStorefront] Failed to get storefront on ${Platform.OS}:`,
       error,
     );
-    throw error;
+    throw createPurchaseError({
+      code: parsedError.code,
+      message: parsedError.message,
+      responseCode: parsedError.responseCode,
+      debugMessage: parsedError.debugMessage,
+      platform: Platform.OS === 'ios' ? 'ios' : 'android',
+    });
   }
+
+  if (typeof storefront !== 'string' || storefront.trim().length === 0) {
+    throw createPurchaseError({
+      code: ErrorCode.ServiceError,
+      message: 'Storefront lookup returned no country code.',
+      platform: Platform.OS === 'ios' ? 'ios' : 'android',
+    });
+  }
+
+  return storefront;
 };
 
 /**
@@ -1851,7 +1883,7 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
           androidRequest.developerBillingOption;
       }
 
-      // One-time purchase offerToken (Android 7.0+)
+      // One-time purchase offerToken (Android 8.0+)
       if (!isSubs) {
         const purchaseRequest = androidRequest as RequestPurchaseAndroidProps;
         if (purchaseRequest.offerToken) {
@@ -2415,19 +2447,7 @@ export const requestPurchaseOnPromotedProductIOS: MutationField<
   }
 
   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');
-    }
-
-    const converted = convertNitroPurchaseToPurchase(latest);
-    if (converted.platform !== 'ios') {
-      throw new Error('Promoted purchase result not available for iOS');
-    }
-
-    return true;
+    return await IAP.instance.buyPromotedProductIOS();
   } catch (error) {
     const parsedError = parseErrorAndLogIfNeeded(
       '[requestPurchaseOnPromotedProductIOS] Failed:',

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,
@@ -53,8 +54,12 @@ import type {
   RequestSubscriptionIosProps,
   UserChoiceBillingDetails,
   PaymentModeIOS,
+  PendingPurchaseUpdateAndroid,
+  RenewalCommitmentInfoIOS,
+  SubscriptionBillingPlanTypeIOS,
   SubscriptionProductReplacementParamsAndroid,
   SubResponseCodeAndroid,
+  TransactionCommitmentInfoIOS,
   WinBackOfferInputIOS,
 } from '../types';
 
@@ -236,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.
    */
@@ -360,25 +365,13 @@ export interface NitroInAppMessageParamsAndroid {
 // ║                                  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;
 }
 
 /**
@@ -390,6 +383,11 @@ export interface NitroPurchaseResult {
   code: string;
   message: string;
   purchaseToken?: string;
+  productId?: string;
+  productIds?: string[];
+  productType?: string;
+  isEmptyProductList?: boolean;
+  subResponseCodeAndroid?: SubResponseCodeAndroid;
 }
 
 export interface NitroBillingResultAndroid {
@@ -560,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;
@@ -583,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 */
@@ -591,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;
@@ -625,6 +628,7 @@ export interface NitroPurchase {
   obfuscatedProfileIdAndroid?: string | null;
   developerPayloadAndroid?: string | null;
   isSuspendedAndroid?: boolean | null;
+  pendingPurchaseUpdateAndroid?: PendingPurchaseUpdateAndroid | null;
 }
 
 /**
@@ -656,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;
@@ -880,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)
@@ -940,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
    */
@@ -1188,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).