react-native-iap 14.4.27 → 14.4.29

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 // Forward declaration of `NitroFinishTransactionIosParams` to properly resolve imports.
 namespace margelo::nitro::iap { struct NitroFinishTransactionIosParams; }
@@ -67,6 +72,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::optional<margelo::nitro::iap::NitroFinishTransactionIosParams>>::canConvert(runtime, obj.getProperty(runtime, "ios"))) return false;
       if (!JSIConverter<std::optional<margelo::nitro::iap::NitroFinishTransactionAndroidParams>>::canConvert(runtime, obj.getProperty(runtime, "android"))) return false;
       return true;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 
 
@@ -65,6 +70,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "formattedPrice"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "priceAmountMicros"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "priceCurrencyCode"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 // Forward declaration of `IapPlatform` to properly resolve imports.
 namespace margelo::nitro::iap { enum class IapPlatform; }
@@ -155,6 +160,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "id"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "title"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "description"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 // Forward declaration of `IapPlatform` to properly resolve imports.
 namespace margelo::nitro::iap { enum class IapPlatform; }
@@ -185,6 +190,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "id"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "productId"))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "transactionDate"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 // Forward declaration of `NitroRequestPurchaseIos` to properly resolve imports.
 namespace margelo::nitro::iap { struct NitroRequestPurchaseIos; }
@@ -67,6 +72,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::optional<margelo::nitro::iap::NitroRequestPurchaseIos>>::canConvert(runtime, obj.getProperty(runtime, "ios"))) return false;
       if (!JSIConverter<std::optional<margelo::nitro::iap::NitroRequestPurchaseAndroid>>::canConvert(runtime, obj.getProperty(runtime, "android"))) return false;
       return true;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 
 
@@ -72,6 +77,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "responseCode"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "debugMessage"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "code"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 
 
@@ -69,6 +74,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "accessToken"))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "isSub"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "packageName"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 // Forward declaration of `NitroReceiptValidationAndroidOptions` to properly resolve imports.
 namespace margelo::nitro::iap { struct NitroReceiptValidationAndroidOptions; }
@@ -65,6 +70,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "sku"))) return false;
       if (!JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationAndroidOptions>>::canConvert(runtime, obj.getProperty(runtime, "androidOptions"))) return false;
       return true;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 
 
@@ -111,6 +116,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, "autoRenewing"))) return false;
       if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, "betaProduct"))) return false;
       if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "cancelDate"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 // Forward declaration of `NitroPurchase` to properly resolve imports.
 namespace margelo::nitro::iap { struct NitroPurchase; }
@@ -71,6 +76,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, "isValid"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "receiptData"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "jwsRepresentation"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 
 
@@ -90,6 +95,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, "willAutoRenew"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "autoRenewPreference"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "pendingUpgradeProductId"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 // Forward declaration of `AndroidSubscriptionOfferInput` to properly resolve imports.
 namespace margelo::nitro::iap { struct AndroidSubscriptionOfferInput; }
@@ -81,6 +86,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::vector<std::string>>::canConvert(runtime, obj.getProperty(runtime, "skus"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "obfuscatedAccountIdAndroid"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "obfuscatedProfileIdAndroid"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 
 
@@ -73,6 +78,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "sku"))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "andDangerouslyFinishTransactionAutomatically"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "appAccountToken"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 
 
@@ -75,6 +80,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, "autoRenewStatus"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "autoRenewPreference"))) return false;
       if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "expirationReason"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#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; }
@@ -68,6 +73,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "state"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "platform"))) return false;
       if (!JSIConverter<std::optional<margelo::nitro::iap::NitroSubscriptionRenewalInfo>>::canConvert(runtime, obj.getProperty(runtime, "renewalInfo"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 // Forward declaration of `IapPlatform` to properly resolve imports.
 namespace margelo::nitro::iap { enum class IapPlatform; }
@@ -120,6 +125,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, "autoRenewingAndroid"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "currentPlanId"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "dataAndroid"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 // Forward declaration of `PurchaseOfferIOS` to properly resolve imports.
 namespace margelo::nitro::iap { struct PurchaseOfferIOS; }
@@ -168,6 +173,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "appAccountToken"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "appBundleIdIOS"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "countryCodeIOS"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 
 
@@ -65,6 +70,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "id"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "paymentMode"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "type"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 
 
@@ -90,6 +95,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "autoRenewPreference"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "expirationReason"))) return false;
       if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "gracePeriodExpirationDate"))) return false;

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

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 
 
@@ -63,6 +68,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "externalTransactionToken"))) return false;
       if (!JSIConverter<std::vector<std::string>>::canConvert(runtime, obj.getProperty(runtime, "products"))) return false;
       return true;

package/openiap-versions.json

@@ -1,5 +1,5 @@
 {
-  "apple": "1.2.28",
+  "apple": "1.2.30",
   "google": "1.3.2",
   "gql": "1.2.3"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "14.4.27",
+  "version": "14.4.29",
   "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",
@@ -108,19 +108,19 @@
     "husky": "^8.0.3",
     "jest": "^30.1.1",
     "lint-staged": "^15.2.0",
-    "nitrogen": "^0.29.6",
+    "nitrogen": "^0.31.1",
     "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.29.6",
+    "react-native-nitro-modules": "^0.31.1",
     "react-test-renderer": "^19.1.1",
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
     "react": "*",
     "react-native": "*",
-    "react-native-nitro-modules": "^0.29.6"
+    "react-native-nitro-modules": "^0.31.1"
   },
   "workspaces": [
     "example"

package/src/index.ts

@@ -827,6 +827,12 @@ export const getReceiptDataIOS: QueryField<'getReceiptDataIOS'> = async () => {
     throw new Error('getReceiptDataIOS is only available on iOS');
   }
 
+  RnIapConsole.warn(
+    '[getReceiptDataIOS] ⚠️ 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 {
     return await IAP.instance.getReceiptDataIOS();
   } catch (error) {
@@ -841,6 +847,12 @@ export const getReceiptIOS = async (): Promise<string> => {
     throw new Error('getReceiptIOS is only available on iOS');
   }
 
+  RnIapConsole.warn(
+    '[getReceiptIOS] ⚠️ 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();
@@ -858,6 +870,12 @@ export const requestReceiptRefreshIOS = async (): Promise<string> => {
     throw new Error('requestReceiptRefreshIOS is only available on iOS');
   }
 
+  RnIapConsole.warn(
+    '[requestReceiptRefreshIOS] ⚠️ 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.requestReceiptRefreshIOS === 'function') {
       return await IAP.instance.requestReceiptRefreshIOS();

package/src/specs/RnIap.nitro.ts

@@ -556,22 +556,49 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
 
   /**
    * Get receipt data (iOS only)
-   * @returns Promise<string> - Base64 encoded receipt data
+   *
+   * ⚠️ **IMPORTANT**: iOS receipts are cumulative and contain ALL transactions for the app,
+   * not just the most recent one. The receipt data does not change between purchases.
+   *
+   * **For individual purchase validation, use `getTransactionJwsIOS(productId)` instead.**
+   *
+   * This returns the App Store Receipt, which:
+   * - Contains all purchase history for the app
+   * - Does not update immediately after finishTransaction()
+   * - May be unavailable immediately after purchase (throws receipt-failed error)
+   * - Requires parsing to extract specific transactions
+   *
+   * @returns Promise<string> - Base64 encoded receipt data containing all app transactions
+   * @throws {Error} receipt-failed if receipt is not available (e.g., immediately after purchase)
    * @platform iOS
+   * @see getTransactionJwsIOS for validating individual transactions (recommended)
    */
   getReceiptDataIOS(): Promise<string>;
 
   /**
    * Alias for getReceiptDataIOS maintained for compatibility (iOS only)
-   * @returns Promise<string> - Base64 encoded receipt data
+   *
+   * ⚠️ **IMPORTANT**: iOS receipts are cumulative and contain ALL transactions.
+   * For individual purchase validation, use `getTransactionJwsIOS(productId)` instead.
+   *
+   * @returns Promise<string> - Base64 encoded receipt data containing all app transactions
    * @platform iOS
+   * @see getReceiptDataIOS for full documentation
+   * @see getTransactionJwsIOS for validating individual transactions (recommended)
    */
   getReceiptIOS(): Promise<string>;
 
   /**
    * Request a refreshed receipt from the App Store (iOS only)
-   * @returns Promise<string> - Updated Base64 encoded receipt data
+   *
+   * This calls syncIOS() to refresh the receipt from Apple's servers, then returns it.
+   *
+   * ⚠️ **IMPORTANT**: iOS receipts are cumulative and contain ALL transactions.
+   * For individual purchase validation, use `getTransactionJwsIOS(productId)` instead.
+   *
+   * @returns Promise<string> - Updated Base64 encoded receipt data containing all app transactions
    * @platform iOS
+   * @see getTransactionJwsIOS for validating individual transactions (recommended)
    */
   requestReceiptRefreshIOS(): Promise<string>;
 
@@ -584,10 +611,27 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
   isTransactionVerifiedIOS(sku: string): Promise<boolean>;
 
   /**
-   * Get transaction JWS representation (iOS only)
-   * @param sku - The product SKU
-   * @returns Promise<string | null> - JWS representation or null
+   * Get transaction JWS (JSON Web Signature) representation for a specific product (iOS only)
+   *
+   * ✅ **RECOMMENDED** for validating individual purchases with your backend.
+   *
+   * This returns a unique, cryptographically signed token for the specific transaction,
+   * unlike `getReceiptDataIOS()` which returns ALL transactions.
+   *
+   * Benefits:
+   * - Contains ONLY the requested transaction (not all historical purchases)
+   * - Cryptographically signed by Apple (can be verified)
+   * - Available immediately after purchase
+   * - Simpler to validate on your backend
+   *
+   * @param sku - The product SKU/ID to get the transaction JWS for
+   * @returns Promise<string | null> - JWS string for the transaction, or null if not found
    * @platform iOS
+   * @example
+   * ```typescript
+   * const jws = await getTransactionJwsIOS('com.example.product');
+   * // Send jws to your backend for validation
+   * ```
    */
   getTransactionJwsIOS(sku: string): Promise<string | null>;