react-native-iap 14.2.3 → 14.3.0

package/nitrogen/generated/ios/swift/NitroDeepLinkOptionsAndroid.swift

@@ -0,0 +1,84 @@
+///
+/// NitroDeepLinkOptionsAndroid.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Represents an instance of `NitroDeepLinkOptionsAndroid`, backed by a C++ struct.
+ */
+public typealias NitroDeepLinkOptionsAndroid = margelo.nitro.iap.NitroDeepLinkOptionsAndroid
+
+public extension NitroDeepLinkOptionsAndroid {
+  private typealias bridge = margelo.nitro.iap.bridge.swift
+
+  /**
+   * Create a new instance of `NitroDeepLinkOptionsAndroid`.
+   */
+  init(skuAndroid: String?, packageNameAndroid: String?) {
+    self.init({ () -> bridge.std__optional_std__string_ in
+      if let __unwrappedValue = skuAndroid {
+        return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_std__string_ in
+      if let __unwrappedValue = packageNameAndroid {
+        return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+      } else {
+        return .init()
+      }
+    }())
+  }
+
+  var skuAndroid: String? {
+    @inline(__always)
+    get {
+      return { () -> String? in
+        if bridge.has_value_std__optional_std__string_(self.__skuAndroid) {
+          let __unwrapped = bridge.get_std__optional_std__string_(self.__skuAndroid)
+          return String(__unwrapped)
+        } else {
+          return nil
+        }
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__skuAndroid = { () -> bridge.std__optional_std__string_ in
+        if let __unwrappedValue = newValue {
+          return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+        } else {
+          return .init()
+        }
+      }()
+    }
+  }
+  
+  var packageNameAndroid: String? {
+    @inline(__always)
+    get {
+      return { () -> String? in
+        if bridge.has_value_std__optional_std__string_(self.__packageNameAndroid) {
+          let __unwrapped = bridge.get_std__optional_std__string_(self.__packageNameAndroid)
+          return String(__unwrapped)
+        } else {
+          return nil
+        }
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__packageNameAndroid = { () -> bridge.std__optional_std__string_ in
+        if let __unwrappedValue = newValue {
+          return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+        } else {
+          return .init()
+        }
+      }()
+    }
+  }
+}

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

@@ -44,6 +44,8 @@ namespace margelo::nitro::iap {
       prototype.registerHybridMethod("isTransactionVerifiedIOS", &HybridRnIapSpec::isTransactionVerifiedIOS);
       prototype.registerHybridMethod("getTransactionJwsIOS", &HybridRnIapSpec::getTransactionJwsIOS);
       prototype.registerHybridMethod("validateReceipt", &HybridRnIapSpec::validateReceipt);
+      prototype.registerHybridMethod("getStorefrontAndroid", &HybridRnIapSpec::getStorefrontAndroid);
+      prototype.registerHybridMethod("deepLinkToSubscriptionsAndroid", &HybridRnIapSpec::deepLinkToSubscriptionsAndroid);
     });
   }
 

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

@@ -33,6 +33,8 @@ namespace margelo::nitro::iap { struct NitroReceiptValidationResultIOS; }
 namespace margelo::nitro::iap { struct NitroReceiptValidationResultAndroid; }
 // Forward declaration of `NitroReceiptValidationParams` to properly resolve imports.
 namespace margelo::nitro::iap { struct NitroReceiptValidationParams; }
+// Forward declaration of `NitroDeepLinkOptionsAndroid` to properly resolve imports.
+namespace margelo::nitro::iap { struct NitroDeepLinkOptionsAndroid; }
 
 #include <NitroModules/Promise.hpp>
 #include "NitroProduct.hpp"
@@ -50,6 +52,7 @@ namespace margelo::nitro::iap { struct NitroReceiptValidationParams; }
 #include "NitroReceiptValidationResultIOS.hpp"
 #include "NitroReceiptValidationResultAndroid.hpp"
 #include "NitroReceiptValidationParams.hpp"
+#include "NitroDeepLinkOptionsAndroid.hpp"
 
 namespace margelo::nitro::iap {
 
@@ -112,6 +115,8 @@ namespace margelo::nitro::iap {
       virtual std::shared_ptr<Promise<bool>> isTransactionVerifiedIOS(const std::string& sku) = 0;
       virtual std::shared_ptr<Promise<std::optional<std::string>>> getTransactionJwsIOS(const std::string& sku) = 0;
       virtual std::shared_ptr<Promise<std::variant<NitroReceiptValidationResultIOS, NitroReceiptValidationResultAndroid>>> validateReceipt(const NitroReceiptValidationParams& params) = 0;
+      virtual std::shared_ptr<Promise<std::string>> getStorefrontAndroid() = 0;
+      virtual std::shared_ptr<Promise<void>> deepLinkToSubscriptionsAndroid(const NitroDeepLinkOptionsAndroid& options) = 0;
 
     protected:
       // Hybrid Setup

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

@@ -0,0 +1,72 @@
+///
+/// NitroDeepLinkOptionsAndroid.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 <optional>
+
+namespace margelo::nitro::iap {
+
+  /**
+   * A struct which can be represented as a JavaScript object (NitroDeepLinkOptionsAndroid).
+   */
+  struct NitroDeepLinkOptionsAndroid {
+  public:
+    std::optional<std::string> skuAndroid     SWIFT_PRIVATE;
+    std::optional<std::string> packageNameAndroid     SWIFT_PRIVATE;
+
+  public:
+    NitroDeepLinkOptionsAndroid() = default;
+    explicit NitroDeepLinkOptionsAndroid(std::optional<std::string> skuAndroid, std::optional<std::string> packageNameAndroid): skuAndroid(skuAndroid), packageNameAndroid(packageNameAndroid) {}
+  };
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ NitroDeepLinkOptionsAndroid <> JS NitroDeepLinkOptionsAndroid (object)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::NitroDeepLinkOptionsAndroid> final {
+    static inline margelo::nitro::iap::NitroDeepLinkOptionsAndroid fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::iap::NitroDeepLinkOptionsAndroid(
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "skuAndroid")),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "packageNameAndroid"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::NitroDeepLinkOptionsAndroid& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "skuAndroid", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.skuAndroid));
+      obj.setProperty(runtime, "packageNameAndroid", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.packageNameAndroid));
+      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, "skuAndroid"))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "packageNameAndroid"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "14.2.3",
+  "version": "14.3.0",
   "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.js

@@ -18,12 +18,11 @@ const addLineToGradle = (content, anchor, lineToAdd, offset = 1) => {
     return lines.join('\n');
 };
 const modifyProjectBuildGradle = (gradle) => {
-    // Add supportLibVersion to project build.gradle if not present
+    // Keep backward-compatible behavior: add supportLibVersion inside ext { } if missing
     if (!gradle.includes('supportLibVersion')) {
         const lines = gradle.split('\n');
         const extIndex = lines.findIndex((line) => line.trim() === 'ext {');
         if (extIndex !== -1) {
-            // Insert supportLibVersion right after 'ext {' with proper indentation
             lines.splice(extIndex + 1, 0, 'supportLibVersion = "28.0.0"');
             return lines.join('\n');
         }
@@ -31,28 +30,32 @@ const modifyProjectBuildGradle = (gradle) => {
     return gradle;
 };
 exports.modifyProjectBuildGradle = modifyProjectBuildGradle;
+const OPENIAP_COORD = 'io.github.hyochan.openiap:openiap-google';
+const OPENIAP_VERSION = '1.1.0';
 const modifyAppBuildGradle = (gradle) => {
     let modified = gradle;
-    // Add billing library dependencies to app-level build.gradle
-    const billingDep = `    implementation "com.android.billingclient:billing-ktx:8.0.0"`;
-    const gmsDep = `    implementation "com.google.android.gms:play-services-base:18.1.0"`;
-    let hasAddedDependency = false;
-    if (!modified.includes(billingDep)) {
-        modified = addLineToGradle(modified, /dependencies\s*{/, billingDep);
-        hasAddedDependency = true;
-    }
-    if (!modified.includes(gmsDep)) {
-        modified = addLineToGradle(modified, /dependencies\s*{/, gmsDep, 1);
-        hasAddedDependency = true;
-    }
-    // Log only once and only if we actually added dependencies
-    if (hasAddedDependency && !hasLoggedPluginExecution) {
-        console.log('🛠️ react-native-iap: Added billing dependencies to build.gradle');
+    // Replace legacy Billing/GMS instructions with OpenIAP Google library
+    // Remove any old billingclient or play-services-base lines we may have added previously
+    modified = modified
+        .replace(/^[ \t]*(implementation|api)[ \t]+["']com\.android\.billingclient:billing-ktx:[^"']+["'][ \t]*$/gim, '')
+        .replace(/^[ \t]*(implementation|api)[ \t]+["']com\.google\.android\.gms:play-services-base:[^"']+["'][ \t]*$/gim, '')
+        .replace(/\n{3,}/g, '\n\n');
+    const openiapDep = `    implementation "${OPENIAP_COORD}:${OPENIAP_VERSION}"`;
+    if (!modified.includes(OPENIAP_COORD)) {
+        if (!/dependencies\s*{/.test(modified)) {
+            modified += `\n\ndependencies {\n${openiapDep}\n}\n`;
+        }
+        else {
+            modified = addLineToGradle(modified, /dependencies\s*{/, openiapDep);
+        }
+        if (!hasLoggedPluginExecution) {
+            console.log(`🛠️ react-native-iap: Added OpenIAP (${OPENIAP_VERSION}) to build.gradle`);
+        }
     }
     return modified;
 };
 const withIapAndroid = (config) => {
-    // Add IAP dependencies to app build.gradle
+    // Add OpenIAP dependency to app build.gradle
     config = (0, config_plugins_1.withAppBuildGradle)(config, (config) => {
         config.modResults.contents = modifyAppBuildGradle(config.modResults.contents);
         return config;

package/plugin/src/withIAP.ts

@@ -31,12 +31,11 @@ const addLineToGradle = (
 };
 
 export const modifyProjectBuildGradle = (gradle: string): string => {
-  // Add supportLibVersion to project build.gradle if not present
+  // Keep backward-compatible behavior: add supportLibVersion inside ext { } if missing
   if (!gradle.includes('supportLibVersion')) {
     const lines = gradle.split('\n');
     const extIndex = lines.findIndex((line) => line.trim() === 'ext {');
     if (extIndex !== -1) {
-      // Insert supportLibVersion right after 'ext {' with proper indentation
       lines.splice(extIndex + 1, 0, 'supportLibVersion = "28.0.0"');
       return lines.join('\n');
     }
@@ -44,36 +43,45 @@ export const modifyProjectBuildGradle = (gradle: string): string => {
   return gradle;
 };
 
+const OPENIAP_COORD = 'io.github.hyochan.openiap:openiap-google';
+const OPENIAP_VERSION = '1.1.0';
+
 const modifyAppBuildGradle = (gradle: string): string => {
   let modified = gradle;
 
-  // Add billing library dependencies to app-level build.gradle
-  const billingDep = `    implementation "com.android.billingclient:billing-ktx:8.0.0"`;
-  const gmsDep = `    implementation "com.google.android.gms:play-services-base:18.1.0"`;
-
-  let hasAddedDependency = false;
-
-  if (!modified.includes(billingDep)) {
-    modified = addLineToGradle(modified, /dependencies\s*{/, billingDep);
-    hasAddedDependency = true;
-  }
-  if (!modified.includes(gmsDep)) {
-    modified = addLineToGradle(modified, /dependencies\s*{/, gmsDep, 1);
-    hasAddedDependency = true;
-  }
-
-  // Log only once and only if we actually added dependencies
-  if (hasAddedDependency && !hasLoggedPluginExecution) {
-    console.log(
-      '🛠️ react-native-iap: Added billing dependencies to build.gradle',
-    );
+  // Replace legacy Billing/GMS instructions with OpenIAP Google library
+  // Remove any old billingclient or play-services-base lines we may have added previously
+  modified = modified
+    .replace(
+      /^[ \t]*(implementation|api)[ \t]+["']com\.android\.billingclient:billing-ktx:[^"']+["'][ \t]*$/gim,
+      '',
+    )
+    .replace(
+      /^[ \t]*(implementation|api)[ \t]+["']com\.google\.android\.gms:play-services-base:[^"']+["'][ \t]*$/gim,
+      '',
+    )
+    .replace(/\n{3,}/g, '\n\n');
+
+  const openiapDep = `    implementation "${OPENIAP_COORD}:${OPENIAP_VERSION}"`;
+
+  if (!modified.includes(OPENIAP_COORD)) {
+    if (!/dependencies\s*{/.test(modified)) {
+      modified += `\n\ndependencies {\n${openiapDep}\n}\n`;
+    } else {
+      modified = addLineToGradle(modified, /dependencies\s*{/, openiapDep);
+    }
+    if (!hasLoggedPluginExecution) {
+      console.log(
+        `🛠️ react-native-iap: Added OpenIAP (${OPENIAP_VERSION}) to build.gradle`,
+      );
+    }
   }
 
   return modified;
 };
 
 const withIapAndroid: ConfigPlugin = (config) => {
-  // Add IAP dependencies to app build.gradle
+  // Add OpenIAP dependency to app build.gradle
   config = withAppBuildGradle(config, (config) => {
     config.modResults.contents = modifyAppBuildGradle(
       config.modResults.contents,

package/src/index.ts

@@ -1181,6 +1181,54 @@ export const getStorefrontIOS = async (): Promise<string> => {
   }
 };
 
+/**
+ * Gets the storefront country code from the underlying native store.
+ * Returns a two-letter country code such as 'US', 'KR', or empty string on failure.
+ *
+ * Cross-platform alias aligning with expo-iap.
+ */
+export const getStorefront = async (): Promise<string> => {
+  if (Platform.OS === 'android') {
+    try {
+      // Optional since older builds may not have the method
+      const result = await iap.getStorefrontAndroid?.();
+      return result ?? '';
+    } catch {
+      return '';
+    }
+  }
+  return getStorefrontIOS();
+};
+
+/**
+ * Deeplinks to native interface that allows users to manage their subscriptions
+ * Cross-platform alias aligning with expo-iap
+ */
+export const deepLinkToSubscriptions = async (
+  options: {
+    skuAndroid?: string;
+    packageNameAndroid?: string;
+  } = {},
+): Promise<void> => {
+  if (Platform.OS === 'android') {
+    await iap.deepLinkToSubscriptionsAndroid?.({
+      skuAndroid: options.skuAndroid,
+      packageNameAndroid: options.packageNameAndroid,
+    });
+    return;
+  }
+  // iOS: Use manage subscriptions sheet (ignore returned purchases for deeplink parity)
+  if (Platform.OS === 'ios') {
+    try {
+      await iap.showManageSubscriptionsIOS();
+    } catch {
+      // no-op
+    }
+    return;
+  }
+  return;
+};
+
 /**
  * iOS only - Gets the original app transaction ID if the app was purchased from the App Store
  * @platform iOS

package/src/specs/RnIap.nitro.ts

@@ -118,6 +118,14 @@ interface NitroFinishTransactionParams {
   android?: NitroFinishTransactionAndroidParams;
 }
 
+/**
+ * Android deep link options for subscription management
+ */
+interface NitroDeepLinkOptionsAndroid {
+  skuAndroid?: string;
+  packageNameAndroid?: string;
+}
+
 // ╔══════════════════════════════════════════════════════════════════════════╗
 // ║                                  TYPES                                   ║
 // ╚══════════════════════════════════════════════════════════════════════════╝
@@ -505,4 +513,18 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
   ): Promise<
     NitroReceiptValidationResultIOS | NitroReceiptValidationResultAndroid
   >;
+
+  /**
+   * Get Google Play storefront country code (Android)
+   * @platform Android
+   */
+  getStorefrontAndroid?(): Promise<string>;
+
+  /**
+   * Deep link to Play Store subscription management (Android)
+   * @platform Android
+   */
+  deepLinkToSubscriptionsAndroid?(
+    options: NitroDeepLinkOptionsAndroid,
+  ): Promise<void>;
 }