react-native-iap 14.4.26 → 14.4.28

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++/PaymentModeIOS.hpp

@@ -0,0 +1,84 @@
+///
+/// PaymentModeIOS.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::iap {
+
+  /**
+   * An enum which can be represented as a JavaScript union (PaymentModeIOS).
+   */
+  enum class PaymentModeIOS {
+    EMPTY      SWIFT_NAME(empty) = 0,
+    FREE_TRIAL      SWIFT_NAME(freeTrial) = 1,
+    PAY_AS_YOU_GO      SWIFT_NAME(payAsYouGo) = 2,
+    PAY_UP_FRONT      SWIFT_NAME(payUpFront) = 3,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ PaymentModeIOS <> JS PaymentModeIOS (union)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::PaymentModeIOS> final {
+    static inline margelo::nitro::iap::PaymentModeIOS fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("empty"): return margelo::nitro::iap::PaymentModeIOS::EMPTY;
+        case hashString("free-trial"): return margelo::nitro::iap::PaymentModeIOS::FREE_TRIAL;
+        case hashString("pay-as-you-go"): return margelo::nitro::iap::PaymentModeIOS::PAY_AS_YOU_GO;
+        case hashString("pay-up-front"): return margelo::nitro::iap::PaymentModeIOS::PAY_UP_FRONT;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum PaymentModeIOS - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::iap::PaymentModeIOS arg) {
+      switch (arg) {
+        case margelo::nitro::iap::PaymentModeIOS::EMPTY: return JSIConverter<std::string>::toJSI(runtime, "empty");
+        case margelo::nitro::iap::PaymentModeIOS::FREE_TRIAL: return JSIConverter<std::string>::toJSI(runtime, "free-trial");
+        case margelo::nitro::iap::PaymentModeIOS::PAY_AS_YOU_GO: return JSIConverter<std::string>::toJSI(runtime, "pay-as-you-go");
+        case margelo::nitro::iap::PaymentModeIOS::PAY_UP_FRONT: return JSIConverter<std::string>::toJSI(runtime, "pay-up-front");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert PaymentModeIOS to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("empty"):
+        case hashString("free-trial"):
+        case hashString("pay-as-you-go"):
+        case hashString("pay-up-front"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

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.27",
+  "apple": "1.2.29",
   "google": "1.3.2",
-  "gql": "1.2.2"
+  "gql": "1.2.3"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "14.4.26",
+  "version": "14.4.28",
   "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

@@ -21,6 +21,7 @@ import type {
   RequestPurchaseResult,
   RequestSubscriptionAndroidProps,
   UserChoiceBillingDetails,
+  PaymentModeIOS,
 } from '../types';
 
 // ╔══════════════════════════════════════════════════════════════════════════╗
@@ -296,7 +297,7 @@ export interface NitroProduct {
   introductoryPriceIOS?: string | null;
   introductoryPriceAsAmountIOS?: number | null;
   introductoryPriceNumberOfPeriodsIOS?: number | null;
-  introductoryPricePaymentModeIOS?: string | null;
+  introductoryPricePaymentModeIOS: PaymentModeIOS;
   introductoryPriceSubscriptionPeriodIOS?: string | null;
   subscriptionPeriodNumberIOS?: number | null;
   subscriptionPeriodUnitIOS?: string | null;
@@ -555,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>;
 
@@ -583,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>;
 

package/src/types.ts

@@ -399,7 +399,7 @@ export interface ProductSubscriptionIOS extends ProductCommon {
   introductoryPriceAsAmountIOS?: (string | null);
   introductoryPriceIOS?: (string | null);
   introductoryPriceNumberOfPeriodsIOS?: (string | null);
-  introductoryPricePaymentModeIOS?: (PaymentModeIOS | null);
+  introductoryPricePaymentModeIOS: PaymentModeIOS;
   introductoryPriceSubscriptionPeriodIOS?: (SubscriptionPeriodIOS | null);
   isFamilyShareableIOS: boolean;
   jsonRepresentationIOS: string;

package/src/utils/type-bridge.ts

@@ -87,7 +87,7 @@ function normalizeProductTypeIOS(value?: Nullable<string>): ProductTypeIOS {
   }
 }
 
-function normalizePaymentMode(value?: Nullable<string>): PaymentModeIOS | null {
+function normalizePaymentMode(value?: Nullable<string>): PaymentModeIOS {
   switch ((value ?? '').toUpperCase()) {
     case 'FREE_TRIAL':
     case 'FREETRIAL':
@@ -552,6 +552,7 @@ export function checkTypeSynchronization(): {
       displayPrice: '$1.00',
       currency: 'USD',
       price: 1,
+      introductoryPricePaymentModeIOS: PAYMENT_MODE_EMPTY,
     };
 
     const converted = convertNitroProductToProduct(testNitroProduct);