react-native-iap 14.4.11 → 14.4.12

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

@@ -0,0 +1,76 @@
+///
+/// ExternalPurchaseNoticeAction.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 (ExternalPurchaseNoticeAction).
+   */
+  enum class ExternalPurchaseNoticeAction {
+    CONTINUE      SWIFT_NAME(continue) = 0,
+    DISMISSED      SWIFT_NAME(dismissed) = 1,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ ExternalPurchaseNoticeAction <> JS ExternalPurchaseNoticeAction (union)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::ExternalPurchaseNoticeAction> final {
+    static inline margelo::nitro::iap::ExternalPurchaseNoticeAction 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("continue"): return margelo::nitro::iap::ExternalPurchaseNoticeAction::CONTINUE;
+        case hashString("dismissed"): return margelo::nitro::iap::ExternalPurchaseNoticeAction::DISMISSED;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum ExternalPurchaseNoticeAction - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::iap::ExternalPurchaseNoticeAction arg) {
+      switch (arg) {
+        case margelo::nitro::iap::ExternalPurchaseNoticeAction::CONTINUE: return JSIConverter<std::string>::toJSI(runtime, "continue");
+        case margelo::nitro::iap::ExternalPurchaseNoticeAction::DISMISSED: return JSIConverter<std::string>::toJSI(runtime, "dismissed");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert ExternalPurchaseNoticeAction 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("continue"):
+        case hashString("dismissed"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,74 @@
+///
+/// ExternalPurchaseNoticeResultIOS.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/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
+
+// Forward declaration of `ExternalPurchaseNoticeAction` to properly resolve imports.
+namespace margelo::nitro::iap { enum class ExternalPurchaseNoticeAction; }
+
+#include <string>
+#include <optional>
+#include "ExternalPurchaseNoticeAction.hpp"
+
+namespace margelo::nitro::iap {
+
+  /**
+   * A struct which can be represented as a JavaScript object (ExternalPurchaseNoticeResultIOS).
+   */
+  struct ExternalPurchaseNoticeResultIOS {
+  public:
+    std::optional<std::string> error     SWIFT_PRIVATE;
+    ExternalPurchaseNoticeAction result     SWIFT_PRIVATE;
+
+  public:
+    ExternalPurchaseNoticeResultIOS() = default;
+    explicit ExternalPurchaseNoticeResultIOS(std::optional<std::string> error, ExternalPurchaseNoticeAction result): error(error), result(result) {}
+  };
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ ExternalPurchaseNoticeResultIOS <> JS ExternalPurchaseNoticeResultIOS (object)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::ExternalPurchaseNoticeResultIOS> final {
+    static inline margelo::nitro::iap::ExternalPurchaseNoticeResultIOS fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::iap::ExternalPurchaseNoticeResultIOS(
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "error")),
+        JSIConverter<margelo::nitro::iap::ExternalPurchaseNoticeAction>::fromJSI(runtime, obj.getProperty(runtime, "result"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::ExternalPurchaseNoticeResultIOS& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "error", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.error));
+      obj.setProperty(runtime, "result", JSIConverter<margelo::nitro::iap::ExternalPurchaseNoticeAction>::toJSI(runtime, arg.result));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "error"))) return false;
+      if (!JSIConverter<margelo::nitro::iap::ExternalPurchaseNoticeAction>::canConvert(runtime, obj.getProperty(runtime, "result"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/HybridRnIapSpec.cpp

@@ -50,6 +50,14 @@ namespace margelo::nitro::iap {
       prototype.registerHybridMethod("validateReceipt", &HybridRnIapSpec::validateReceipt);
       prototype.registerHybridMethod("getStorefront", &HybridRnIapSpec::getStorefront);
       prototype.registerHybridMethod("deepLinkToSubscriptionsAndroid", &HybridRnIapSpec::deepLinkToSubscriptionsAndroid);
+      prototype.registerHybridMethod("checkAlternativeBillingAvailabilityAndroid", &HybridRnIapSpec::checkAlternativeBillingAvailabilityAndroid);
+      prototype.registerHybridMethod("showAlternativeBillingDialogAndroid", &HybridRnIapSpec::showAlternativeBillingDialogAndroid);
+      prototype.registerHybridMethod("createAlternativeBillingTokenAndroid", &HybridRnIapSpec::createAlternativeBillingTokenAndroid);
+      prototype.registerHybridMethod("addUserChoiceBillingListenerAndroid", &HybridRnIapSpec::addUserChoiceBillingListenerAndroid);
+      prototype.registerHybridMethod("removeUserChoiceBillingListenerAndroid", &HybridRnIapSpec::removeUserChoiceBillingListenerAndroid);
+      prototype.registerHybridMethod("canPresentExternalPurchaseNoticeIOS", &HybridRnIapSpec::canPresentExternalPurchaseNoticeIOS);
+      prototype.registerHybridMethod("presentExternalPurchaseNoticeSheetIOS", &HybridRnIapSpec::presentExternalPurchaseNoticeSheetIOS);
+      prototype.registerHybridMethod("presentExternalPurchaseLinkIOS", &HybridRnIapSpec::presentExternalPurchaseLinkIOS);
     });
   }
 

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

@@ -13,6 +13,8 @@
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
 
+// Forward declaration of `InitConnectionConfig` to properly resolve imports.
+namespace margelo::nitro::iap { struct InitConnectionConfig; }
 // Forward declaration of `NitroProduct` to properly resolve imports.
 namespace margelo::nitro::iap { struct NitroProduct; }
 // Forward declaration of `PurchaseAndroid` to properly resolve imports.
@@ -39,15 +41,22 @@ namespace margelo::nitro::iap { struct NitroReceiptValidationResultAndroid; }
 namespace margelo::nitro::iap { struct NitroReceiptValidationParams; }
 // Forward declaration of `NitroDeepLinkOptionsAndroid` to properly resolve imports.
 namespace margelo::nitro::iap { struct NitroDeepLinkOptionsAndroid; }
+// Forward declaration of `UserChoiceBillingDetails` to properly resolve imports.
+namespace margelo::nitro::iap { struct UserChoiceBillingDetails; }
+// Forward declaration of `ExternalPurchaseNoticeResultIOS` to properly resolve imports.
+namespace margelo::nitro::iap { struct ExternalPurchaseNoticeResultIOS; }
+// Forward declaration of `ExternalPurchaseLinkResultIOS` to properly resolve imports.
+namespace margelo::nitro::iap { struct ExternalPurchaseLinkResultIOS; }
 
 #include <NitroModules/Promise.hpp>
+#include "InitConnectionConfig.hpp"
+#include <optional>
 #include "NitroProduct.hpp"
 #include <vector>
 #include <string>
 #include "PurchaseAndroid.hpp"
 #include "PurchaseIOS.hpp"
 #include <variant>
-#include <optional>
 #include "NitroPurchaseRequest.hpp"
 #include "NitroPurchase.hpp"
 #include "NitroAvailablePurchasesOptions.hpp"
@@ -59,6 +68,9 @@ namespace margelo::nitro::iap { struct NitroDeepLinkOptionsAndroid; }
 #include "NitroReceiptValidationResultAndroid.hpp"
 #include "NitroReceiptValidationParams.hpp"
 #include "NitroDeepLinkOptionsAndroid.hpp"
+#include "UserChoiceBillingDetails.hpp"
+#include "ExternalPurchaseNoticeResultIOS.hpp"
+#include "ExternalPurchaseLinkResultIOS.hpp"
 
 namespace margelo::nitro::iap {
 
@@ -91,7 +103,7 @@ namespace margelo::nitro::iap {
 
     public:
       // Methods
-      virtual std::shared_ptr<Promise<bool>> initConnection() = 0;
+      virtual std::shared_ptr<Promise<bool>> initConnection(const std::optional<InitConnectionConfig>& config) = 0;
       virtual std::shared_ptr<Promise<bool>> endConnection() = 0;
       virtual std::shared_ptr<Promise<std::vector<NitroProduct>>> fetchProducts(const std::vector<std::string>& skus, const std::string& type) = 0;
       virtual std::shared_ptr<Promise<std::optional<std::variant<PurchaseAndroid, PurchaseIOS, std::vector<std::variant<PurchaseAndroid, PurchaseIOS>>>>>> requestPurchase(const NitroPurchaseRequest& request) = 0;
@@ -127,6 +139,14 @@ namespace margelo::nitro::iap {
       virtual std::shared_ptr<Promise<std::variant<NitroReceiptValidationResultIOS, NitroReceiptValidationResultAndroid>>> validateReceipt(const NitroReceiptValidationParams& params) = 0;
       virtual std::shared_ptr<Promise<std::string>> getStorefront() = 0;
       virtual std::shared_ptr<Promise<void>> deepLinkToSubscriptionsAndroid(const NitroDeepLinkOptionsAndroid& options) = 0;
+      virtual std::shared_ptr<Promise<bool>> checkAlternativeBillingAvailabilityAndroid() = 0;
+      virtual std::shared_ptr<Promise<bool>> showAlternativeBillingDialogAndroid() = 0;
+      virtual std::shared_ptr<Promise<std::optional<std::string>>> createAlternativeBillingTokenAndroid(const std::optional<std::string>& sku) = 0;
+      virtual void addUserChoiceBillingListenerAndroid(const std::function<void(const UserChoiceBillingDetails& /* details */)>& listener) = 0;
+      virtual void removeUserChoiceBillingListenerAndroid(const std::function<void(const UserChoiceBillingDetails& /* details */)>& listener) = 0;
+      virtual std::shared_ptr<Promise<bool>> canPresentExternalPurchaseNoticeIOS() = 0;
+      virtual std::shared_ptr<Promise<ExternalPurchaseNoticeResultIOS>> presentExternalPurchaseNoticeSheetIOS() = 0;
+      virtual std::shared_ptr<Promise<ExternalPurchaseLinkResultIOS>> presentExternalPurchaseLinkIOS(const std::string& url) = 0;
 
     protected:
       // Hybrid Setup

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

@@ -0,0 +1,69 @@
+///
+/// InitConnectionConfig.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/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
+
+// Forward declaration of `AlternativeBillingModeAndroid` to properly resolve imports.
+namespace margelo::nitro::iap { enum class AlternativeBillingModeAndroid; }
+
+#include "AlternativeBillingModeAndroid.hpp"
+#include <optional>
+
+namespace margelo::nitro::iap {
+
+  /**
+   * A struct which can be represented as a JavaScript object (InitConnectionConfig).
+   */
+  struct InitConnectionConfig {
+  public:
+    std::optional<AlternativeBillingModeAndroid> alternativeBillingModeAndroid     SWIFT_PRIVATE;
+
+  public:
+    InitConnectionConfig() = default;
+    explicit InitConnectionConfig(std::optional<AlternativeBillingModeAndroid> alternativeBillingModeAndroid): alternativeBillingModeAndroid(alternativeBillingModeAndroid) {}
+  };
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ InitConnectionConfig <> JS InitConnectionConfig (object)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::InitConnectionConfig> final {
+    static inline margelo::nitro::iap::InitConnectionConfig fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::iap::InitConnectionConfig(
+        JSIConverter<std::optional<margelo::nitro::iap::AlternativeBillingModeAndroid>>::fromJSI(runtime, obj.getProperty(runtime, "alternativeBillingModeAndroid"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::InitConnectionConfig& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "alternativeBillingModeAndroid", JSIConverter<std::optional<margelo::nitro::iap::AlternativeBillingModeAndroid>>::toJSI(runtime, arg.alternativeBillingModeAndroid));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!JSIConverter<std::optional<margelo::nitro::iap::AlternativeBillingModeAndroid>>::canConvert(runtime, obj.getProperty(runtime, "alternativeBillingModeAndroid"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -37,6 +37,7 @@ namespace margelo::nitro::iap {
   struct PurchaseAndroid {
   public:
     std::optional<bool> autoRenewingAndroid     SWIFT_PRIVATE;
+    std::optional<std::string> currentPlanId     SWIFT_PRIVATE;
     std::optional<std::string> dataAndroid     SWIFT_PRIVATE;
     std::optional<std::string> developerPayloadAndroid     SWIFT_PRIVATE;
     std::string id     SWIFT_PRIVATE;
@@ -57,7 +58,7 @@ namespace margelo::nitro::iap {
 
   public:
     PurchaseAndroid() = default;
-    explicit PurchaseAndroid(std::optional<bool> autoRenewingAndroid, std::optional<std::string> dataAndroid, std::optional<std::string> developerPayloadAndroid, std::string id, std::optional<std::vector<std::string>> ids, std::optional<bool> isAcknowledgedAndroid, bool isAutoRenewing, std::optional<std::string> obfuscatedAccountIdAndroid, std::optional<std::string> obfuscatedProfileIdAndroid, std::optional<std::string> packageNameAndroid, IapPlatform platform, std::string productId, PurchaseState purchaseState, std::optional<std::string> purchaseToken, double quantity, std::optional<std::string> signatureAndroid, double transactionDate, std::optional<std::string> transactionId): autoRenewingAndroid(autoRenewingAndroid), dataAndroid(dataAndroid), developerPayloadAndroid(developerPayloadAndroid), id(id), ids(ids), isAcknowledgedAndroid(isAcknowledgedAndroid), isAutoRenewing(isAutoRenewing), obfuscatedAccountIdAndroid(obfuscatedAccountIdAndroid), obfuscatedProfileIdAndroid(obfuscatedProfileIdAndroid), packageNameAndroid(packageNameAndroid), platform(platform), productId(productId), purchaseState(purchaseState), purchaseToken(purchaseToken), quantity(quantity), signatureAndroid(signatureAndroid), transactionDate(transactionDate), transactionId(transactionId) {}
+    explicit PurchaseAndroid(std::optional<bool> autoRenewingAndroid, std::optional<std::string> currentPlanId, std::optional<std::string> dataAndroid, std::optional<std::string> developerPayloadAndroid, std::string id, std::optional<std::vector<std::string>> ids, std::optional<bool> isAcknowledgedAndroid, bool isAutoRenewing, std::optional<std::string> obfuscatedAccountIdAndroid, std::optional<std::string> obfuscatedProfileIdAndroid, std::optional<std::string> packageNameAndroid, IapPlatform platform, std::string productId, PurchaseState purchaseState, std::optional<std::string> purchaseToken, double quantity, std::optional<std::string> signatureAndroid, double transactionDate, std::optional<std::string> transactionId): autoRenewingAndroid(autoRenewingAndroid), currentPlanId(currentPlanId), dataAndroid(dataAndroid), developerPayloadAndroid(developerPayloadAndroid), id(id), ids(ids), isAcknowledgedAndroid(isAcknowledgedAndroid), isAutoRenewing(isAutoRenewing), obfuscatedAccountIdAndroid(obfuscatedAccountIdAndroid), obfuscatedProfileIdAndroid(obfuscatedProfileIdAndroid), packageNameAndroid(packageNameAndroid), platform(platform), productId(productId), purchaseState(purchaseState), purchaseToken(purchaseToken), quantity(quantity), signatureAndroid(signatureAndroid), transactionDate(transactionDate), transactionId(transactionId) {}
   };
 
 } // namespace margelo::nitro::iap
@@ -71,6 +72,7 @@ namespace margelo::nitro {
       jsi::Object obj = arg.asObject(runtime);
       return margelo::nitro::iap::PurchaseAndroid(
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, "autoRenewingAndroid")),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "currentPlanId")),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "dataAndroid")),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "developerPayloadAndroid")),
         JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "id")),
@@ -93,6 +95,7 @@ namespace margelo::nitro {
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::PurchaseAndroid& arg) {
       jsi::Object obj(runtime);
       obj.setProperty(runtime, "autoRenewingAndroid", JSIConverter<std::optional<bool>>::toJSI(runtime, arg.autoRenewingAndroid));
+      obj.setProperty(runtime, "currentPlanId", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.currentPlanId));
       obj.setProperty(runtime, "dataAndroid", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.dataAndroid));
       obj.setProperty(runtime, "developerPayloadAndroid", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.developerPayloadAndroid));
       obj.setProperty(runtime, "id", JSIConverter<std::string>::toJSI(runtime, arg.id));
@@ -118,6 +121,7 @@ namespace margelo::nitro {
       }
       jsi::Object obj = value.getObject(runtime);
       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;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "developerPayloadAndroid"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "id"))) return false;

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

@@ -44,6 +44,7 @@ namespace margelo::nitro::iap {
     std::optional<std::string> countryCodeIOS     SWIFT_PRIVATE;
     std::optional<std::string> currencyCodeIOS     SWIFT_PRIVATE;
     std::optional<std::string> currencySymbolIOS     SWIFT_PRIVATE;
+    std::optional<std::string> currentPlanId     SWIFT_PRIVATE;
     std::optional<std::string> environmentIOS     SWIFT_PRIVATE;
     std::optional<double> expirationDateIOS     SWIFT_PRIVATE;
     std::string id     SWIFT_PRIVATE;
@@ -73,7 +74,7 @@ namespace margelo::nitro::iap {
 
   public:
     PurchaseIOS() = default;
-    explicit PurchaseIOS(std::optional<std::string> appAccountToken, std::optional<std::string> appBundleIdIOS, std::optional<std::string> countryCodeIOS, std::optional<std::string> currencyCodeIOS, std::optional<std::string> currencySymbolIOS, std::optional<std::string> environmentIOS, std::optional<double> expirationDateIOS, std::string id, std::optional<std::vector<std::string>> ids, bool isAutoRenewing, std::optional<bool> isUpgradedIOS, std::optional<PurchaseOfferIOS> offerIOS, std::optional<double> originalTransactionDateIOS, std::optional<std::string> originalTransactionIdentifierIOS, std::optional<std::string> ownershipTypeIOS, IapPlatform platform, std::string productId, PurchaseState purchaseState, std::optional<std::string> purchaseToken, double quantity, std::optional<double> quantityIOS, std::optional<std::string> reasonIOS, std::optional<std::string> reasonStringRepresentationIOS, std::optional<double> revocationDateIOS, std::optional<std::string> revocationReasonIOS, std::optional<std::string> storefrontCountryCodeIOS, std::optional<std::string> subscriptionGroupIdIOS, double transactionDate, std::string transactionId, std::optional<std::string> transactionReasonIOS, std::optional<std::string> webOrderLineItemIdIOS): appAccountToken(appAccountToken), appBundleIdIOS(appBundleIdIOS), countryCodeIOS(countryCodeIOS), currencyCodeIOS(currencyCodeIOS), currencySymbolIOS(currencySymbolIOS), 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), revocationDateIOS(revocationDateIOS), revocationReasonIOS(revocationReasonIOS), storefrontCountryCodeIOS(storefrontCountryCodeIOS), subscriptionGroupIdIOS(subscriptionGroupIdIOS), transactionDate(transactionDate), transactionId(transactionId), transactionReasonIOS(transactionReasonIOS), webOrderLineItemIdIOS(webOrderLineItemIdIOS) {}
+    explicit PurchaseIOS(std::optional<std::string> appAccountToken, std::optional<std::string> appBundleIdIOS, std::optional<std::string> countryCodeIOS, std::optional<std::string> currencyCodeIOS, std::optional<std::string> currencySymbolIOS, std::optional<std::string> currentPlanId, std::optional<std::string> environmentIOS, std::optional<double> expirationDateIOS, std::string id, std::optional<std::vector<std::string>> ids, bool isAutoRenewing, std::optional<bool> isUpgradedIOS, std::optional<PurchaseOfferIOS> offerIOS, std::optional<double> originalTransactionDateIOS, std::optional<std::string> originalTransactionIdentifierIOS, std::optional<std::string> ownershipTypeIOS, IapPlatform platform, std::string productId, PurchaseState purchaseState, std::optional<std::string> purchaseToken, double quantity, std::optional<double> quantityIOS, std::optional<std::string> reasonIOS, std::optional<std::string> reasonStringRepresentationIOS, std::optional<double> revocationDateIOS, std::optional<std::string> revocationReasonIOS, std::optional<std::string> storefrontCountryCodeIOS, std::optional<std::string> subscriptionGroupIdIOS, double transactionDate, std::string transactionId, std::optional<std::string> transactionReasonIOS, std::optional<std::string> webOrderLineItemIdIOS): appAccountToken(appAccountToken), appBundleIdIOS(appBundleIdIOS), 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), revocationDateIOS(revocationDateIOS), revocationReasonIOS(revocationReasonIOS), storefrontCountryCodeIOS(storefrontCountryCodeIOS), subscriptionGroupIdIOS(subscriptionGroupIdIOS), transactionDate(transactionDate), transactionId(transactionId), transactionReasonIOS(transactionReasonIOS), webOrderLineItemIdIOS(webOrderLineItemIdIOS) {}
   };
 
 } // namespace margelo::nitro::iap
@@ -91,6 +92,7 @@ namespace margelo::nitro {
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "countryCodeIOS")),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "currencyCodeIOS")),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "currencySymbolIOS")),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "currentPlanId")),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "environmentIOS")),
         JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, "expirationDateIOS")),
         JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "id")),
@@ -126,6 +128,7 @@ namespace margelo::nitro {
       obj.setProperty(runtime, "countryCodeIOS", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.countryCodeIOS));
       obj.setProperty(runtime, "currencyCodeIOS", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.currencyCodeIOS));
       obj.setProperty(runtime, "currencySymbolIOS", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.currencySymbolIOS));
+      obj.setProperty(runtime, "currentPlanId", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.currentPlanId));
       obj.setProperty(runtime, "environmentIOS", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.environmentIOS));
       obj.setProperty(runtime, "expirationDateIOS", JSIConverter<std::optional<double>>::toJSI(runtime, arg.expirationDateIOS));
       obj.setProperty(runtime, "id", JSIConverter<std::string>::toJSI(runtime, arg.id));
@@ -164,6 +167,7 @@ namespace margelo::nitro {
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "countryCodeIOS"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "currencyCodeIOS"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "currencySymbolIOS"))) 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, "environmentIOS"))) return false;
       if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "expirationDateIOS"))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "id"))) return false;

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

@@ -0,0 +1,72 @@
+///
+/// UserChoiceBillingDetails.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/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
+
+
+
+#include <string>
+#include <vector>
+
+namespace margelo::nitro::iap {
+
+  /**
+   * A struct which can be represented as a JavaScript object (UserChoiceBillingDetails).
+   */
+  struct UserChoiceBillingDetails {
+  public:
+    std::string externalTransactionToken     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) {}
+  };
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ UserChoiceBillingDetails <> JS UserChoiceBillingDetails (object)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::UserChoiceBillingDetails> final {
+    static inline margelo::nitro::iap::UserChoiceBillingDetails fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::iap::UserChoiceBillingDetails(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "externalTransactionToken")),
+        JSIConverter<std::vector<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "products"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::UserChoiceBillingDetails& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "externalTransactionToken", JSIConverter<std::string>::toJSI(runtime, arg.externalTransactionToken));
+      obj.setProperty(runtime, "products", JSIConverter<std::vector<std::string>>::toJSI(runtime, arg.products));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      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;
+    }
+  };
+
+} // namespace margelo::nitro

package/openiap-versions.json

@@ -1,5 +1,5 @@
 {
-  "apple": "1.2.6",
-  "google": "1.2.10",
-  "gql": "1.0.9"
+  "apple": "1.2.10",
+  "google": "1.2.12",
+  "gql": "1.0.12"
 }

package/package.json

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

package/plugin/build/withIAP.d.ts

@@ -1,14 +1,41 @@
+import type { ConfigPlugin } from 'expo/config-plugins';
 import type { ExpoConfig } from '@expo/config-types';
 export declare const modifyProjectBuildGradle: (gradle: string) => string;
+export interface IosAlternativeBillingConfig {
+    /** Country codes where external purchases are supported (ISO 3166-1 alpha-2) */
+    countries?: string[];
+    /** External purchase URLs per country (iOS 15.4+) */
+    links?: Record<string, string>;
+    /** Multiple external purchase URLs per country (iOS 17.5+, up to 5 per country) */
+    multiLinks?: Record<string, string[]>;
+    /** Custom link regions (iOS 18.1+) */
+    customLinkRegions?: string[];
+    /** Streaming link regions for music apps (iOS 18.2+) */
+    streamingLinkRegions?: string[];
+    /** Enable external purchase link entitlement */
+    enableExternalPurchaseLink?: boolean;
+    /** Enable external purchase link streaming entitlement (music apps only) */
+    enableExternalPurchaseLinkStreaming?: boolean;
+}
+/** Add external purchase entitlements and Info.plist configuration */
+declare const withIosAlternativeBilling: ConfigPlugin<IosAlternativeBillingConfig | undefined>;
 type IapPluginProps = {
     ios?: {
         'with-folly-no-coroutines'?: boolean;
         'with-folly-no-couroutines'?: boolean;
     };
+    /**
+     * iOS Alternative Billing configuration.
+     * Configure external purchase countries, links, and entitlements.
+     * Requires approval from Apple.
+     * @platform ios
+     */
+    iosAlternativeBilling?: IosAlternativeBillingConfig;
 };
 type IapPluginCallable = {
     (config: ExpoConfig): ExpoConfig;
     (config: ExpoConfig, props?: IapPluginProps): ExpoConfig;
 };
 declare const pluginExport: IapPluginCallable;
+export { withIosAlternativeBilling };
 export { pluginExport as default };

package/plugin/build/withIAP.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = exports.modifyProjectBuildGradle = void 0;
+exports.default = exports.withIosAlternativeBilling = exports.modifyProjectBuildGradle = void 0;
 const config_plugins_1 = require("expo/config-plugins");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
@@ -115,6 +115,92 @@ const withIapAndroid = (config) => {
     });
     return config;
 };
+/** Add external purchase entitlements and Info.plist configuration */
+const withIosAlternativeBilling = (config, options) => {
+    if (!options || !options.countries || options.countries.length === 0) {
+        return config;
+    }
+    // Add entitlements
+    config = (0, config_plugins_1.withEntitlementsPlist)(config, (config) => {
+        // Always add basic external purchase entitlement when countries are specified
+        config.modResults['com.apple.developer.storekit.external-purchase'] = true;
+        if (!hasLoggedPluginExecution) {
+            console.log('✅ Added com.apple.developer.storekit.external-purchase to entitlements');
+        }
+        // Add external purchase link entitlement if enabled
+        if (options.enableExternalPurchaseLink) {
+            config.modResults['com.apple.developer.storekit.external-purchase-link'] =
+                true;
+            if (!hasLoggedPluginExecution) {
+                console.log('✅ Added com.apple.developer.storekit.external-purchase-link to entitlements');
+            }
+        }
+        // Add streaming entitlement if enabled
+        if (options.enableExternalPurchaseLinkStreaming) {
+            config.modResults['com.apple.developer.storekit.external-purchase-link-streaming'] = true;
+            if (!hasLoggedPluginExecution) {
+                console.log('✅ Added com.apple.developer.storekit.external-purchase-link-streaming to entitlements');
+            }
+        }
+        return config;
+    });
+    // Add Info.plist configuration
+    config = (0, config_plugins_1.withInfoPlist)(config, (config) => {
+        const plist = config.modResults;
+        // Helper function to normalize country codes to uppercase
+        const normalize = (code) => code.trim().toUpperCase();
+        // 1. SKExternalPurchase (Required)
+        const normalizedCountries = options.countries?.map(normalize);
+        plist.SKExternalPurchase = normalizedCountries;
+        if (!hasLoggedPluginExecution) {
+            console.log(`✅ Added SKExternalPurchase with countries: ${normalizedCountries?.join(', ')}`);
+        }
+        // 2. SKExternalPurchaseLink (Optional - iOS 15.4+)
+        if (options.links && Object.keys(options.links).length > 0) {
+            plist.SKExternalPurchaseLink = Object.fromEntries(Object.entries(options.links).map(([code, url]) => [
+                normalize(code),
+                url,
+            ]));
+            if (!hasLoggedPluginExecution) {
+                console.log(`✅ Added SKExternalPurchaseLink for ${Object.keys(options.links).length} countries`);
+            }
+        }
+        // 3. SKExternalPurchaseMultiLink (iOS 17.5+)
+        if (options.multiLinks && Object.keys(options.multiLinks).length > 0) {
+            plist.SKExternalPurchaseMultiLink = Object.fromEntries(Object.entries(options.multiLinks).map(([code, urls]) => [
+                normalize(code),
+                urls,
+            ]));
+            if (!hasLoggedPluginExecution) {
+                console.log(`✅ Added SKExternalPurchaseMultiLink for ${Object.keys(options.multiLinks).length} countries`);
+            }
+        }
+        // 4. SKExternalPurchaseCustomLinkRegions (iOS 18.1+)
+        if (options.customLinkRegions && options.customLinkRegions.length > 0) {
+            plist.SKExternalPurchaseCustomLinkRegions =
+                options.customLinkRegions.map(normalize);
+            if (!hasLoggedPluginExecution) {
+                console.log(`✅ Added SKExternalPurchaseCustomLinkRegions: ${options.customLinkRegions
+                    .map(normalize)
+                    .join(', ')}`);
+            }
+        }
+        // 5. SKExternalPurchaseLinkStreamingRegions (iOS 18.2+)
+        if (options.streamingLinkRegions &&
+            options.streamingLinkRegions.length > 0) {
+            plist.SKExternalPurchaseLinkStreamingRegions =
+                options.streamingLinkRegions.map(normalize);
+            if (!hasLoggedPluginExecution) {
+                console.log(`✅ Added SKExternalPurchaseLinkStreamingRegions: ${options.streamingLinkRegions
+                    .map(normalize)
+                    .join(', ')}`);
+            }
+        }
+        return config;
+    });
+    return config;
+};
+exports.withIosAlternativeBilling = withIosAlternativeBilling;
 const withIapIosFollyWorkaround = (config, props) => {
     const newKey = props?.ios?.['with-folly-no-coroutines'];
     const oldKey = props?.ios?.['with-folly-no-couroutines'];
@@ -165,6 +251,10 @@ const withIAP = (config, props) => {
     try {
         let result = withIapAndroid(config);
         result = withIapIosFollyWorkaround(result, props);
+        // Add iOS alternative billing configuration if provided
+        if (props?.iosAlternativeBilling) {
+            result = withIosAlternativeBilling(result, props.iosAlternativeBilling);
+        }
         // Set flag after first execution to prevent duplicate logs
         hasLoggedPluginExecution = true;
         return result;