feat: add getStrongFront functionality on both ios and android (#3033)

## Description

This PR adds the `getStrongFront` functionality to the React Native IAP
library, implementing it on both iOS and Android platforms.

### Changes

- **iOS Implementation**: Added `getStrongFront` method in
`HybridRnIap.swift` using StoreKit 2
- **Android Implementation**: Added `getStrongFront` method in
`HybridRnIap.kt` using Google Play Billing
- **API Integration**: Exposed `getStrongFront` method in the main API
(`src/index.ts`)
- **Type Definitions**: Added TypeScript types for `getStrongFront` in
`src/types.ts`
- **Nitro Bridge**: Updated `src/specs/RnIap.nitro.ts` to include the
new method
- **Documentation**: Updated API documentation to include
`getStrongFront` method
- **Tests**: Added tests for the new `getStrongFront` functionality
- **Example Updates**: Updated example apps to demonstrate
`getStrongFront` usage

### Platform Details

**iOS (StoreKit 2)**:
- Returns storefront information including country code and identifier

**Android (Google Play Billing)**:
- Returns billing client region information

### Testing

- All existing tests pass
- New `getStrongFront` functionality tested on both platforms
- Example a- **Andated and verified

Co-authored-by: Myzynets <[email protected]>

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* New Features
* Unified, cross-platform storefront retrieval (replaces the previous
iOS-only approach).
* Example app now displays storefront and includes a “Refresh
storefront” action with loading state.

* Documentation
* Updated storefront docs to note cross-platform support and
empty-string behavior on unsupported platforms.
  * Consolidated notes in purchase request docs for clarity.
* Marked the iOS-only storefront method as deprecated in favor of the
unified API.

* Tests
  * Added coverage for unified storefront retrieval and fallbacks.

* Chores
  * Improved iOS example build path configuration.
  * Bumped an internal dependency version.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Co-authored-by: Myzynets <[email protected]>

Author: hyochan

android/src/main/java/com/margelo/nitro/iap/HybridRnIap.kt

@@ -490,7 +490,22 @@ class HybridRnIap : HybridRnIapSpec() {
             }
         }
     }
-    
+
+    override fun getStorefront(): Promise<String> {
+        return Promise.async {
+            try {
+                initConnection().await()
+                RnIapLog.payload("getStorefront", null)
+                val value = openIap.getStorefront()
+                RnIapLog.result("getStorefront", value)
+                value
+            } catch (e: Exception) {
+                RnIapLog.failure("getStorefront", e)
+                ""
+            }
+        }
+    }
+
     override val memorySize: Long
         get() = 0L
 
@@ -772,22 +787,6 @@ class HybridRnIap : HybridRnIapSpec() {
         }
     }
 
-    // Android-specific storefront getter
-    override fun getStorefrontAndroid(): Promise<String> {
-        return Promise.async {
-            try {
-                initConnection().await()
-                RnIapLog.payload("getStorefrontAndroid", null)
-                val value = openIap.getStorefront()
-                RnIapLog.result("getStorefrontAndroid", value)
-                value
-            } catch (e: Exception) {
-                RnIapLog.failure("getStorefrontAndroid", e)
-                ""
-            }
-        }
-    }
-
     // Android-specific deep link to subscription management
     override fun deepLinkToSubscriptionsAndroid(options: NitroDeepLinkOptionsAndroid): Promise<Unit> {
         return Promise.async {

docs/docs/api/methods/core-methods.md

@@ -124,9 +124,7 @@ const loadSubscriptions = async () => {
 
 Initiates a purchase request for products or subscriptions.
 
-> **📖 Reference:** [OpenIAP Request APIs](https://www.openiap.dev/docs/apis#request-apis)
-
-> **⚠️ Platform Differences:**
+> **📖 Reference:** [OpenIAP Request APIs](https://www.openiap.dev/docs/apis#request-apis) **⚠️ Platform Differences:**
 >
 > - **iOS**: Can only purchase one product at a time (uses `sku: string`)
 > - **Android**: Can purchase multiple products at once (uses `skus: string[]`)
@@ -372,7 +370,7 @@ const openSubscriptionSettings = () => {
 
 ## getStorefront()
 
-Return the storefront in ISO 3166-1 alpha-2 or ISO 3166-1 alpha-3 format
+Return the storefront in ISO 3166-1 alpha-2 or ISO 3166-1 alpha-3 format. Works on both iOS and Android—on other platforms it returns an empty string.
 
 ```tsx
 import {getStorefront} from 'react-native-iap';

example-expo/app/index-original.tsx

@@ -1,7 +1,7 @@
 import {useEffect, useState} from 'react';
 import {View, Text, StyleSheet, TouchableOpacity} from 'react-native';
 import {Link} from 'expo-router';
-import {getStorefrontIOS} from 'react-native-iap';
+import {getStorefront} from 'react-native-iap';
 
 /**
  * Example App Landing Page
@@ -13,8 +13,8 @@ export default function Home() {
   const [storefront, setStorefront] = useState<string | null>(null);
 
   useEffect(() => {
-    // getStorefrontIOS already handles platform checks internally
-    getStorefrontIOS()
+    // getStorefront handles platform checks internally
+    getStorefront()
       .then((storefront: any) => {
         setStorefront(storefront);
       })

example-expo/app/index.tsx

@@ -30,10 +30,13 @@ prepare_react_native_project!
 target 'example' do
   config = use_native_modules!
 
+  # Force absolute app path to avoid overly nested relative paths in build scripts
+  app_path = File.expand_path('..', __dir__)
+
   use_react_native!(
     :path => config[:reactNativePath],
-    # An absolute path to your application root.
-    :app_path => "#{Pod::Config.instance.installation_root}/.."
+    # Absolute path to the application root prevents runaway ../../ segments
+    :app_path => app_path
   )
 
   # Work around CDN/trunk propagation delay by pulling OpenIAP directly from Git.

example/ios/Podfile

@@ -8,7 +8,7 @@ PODS:
   - hermes-engine (0.81.1):
     - hermes-engine/Pre-built (= 0.81.1)
   - hermes-engine/Pre-built (0.81.1)
-  - NitroIap (14.4.3):
+  - NitroIap (14.4.5):
     - boost
     - DoubleConversion
     - fast_float
@@ -2747,10 +2747,10 @@ SPEC CHECKSUMS:
   fmt: a40bb5bd0294ea969aaaba240a927bd33d878cdd
   glog: 5683914934d5b6e4240e497e0f4a3b42d1854183
   hermes-engine: 4f8246b1f6d79f625e0d99472d1f3a71da4d28ca
-  NitroIap: 0334bb6a2379907b20ba556d6ec49f0f94dc3e96
+  NitroIap: b3d39741d8528e63f258e4cccf14b3f04b5f1a02
   NitroModules: d9c969e83c30ec1e7efc95e0ae58c21db1585c14
   openiap: 92c66923a5aa128777da7dc6283a06b331eeab37
-  RCT-Folly: 846fda9475e61ec7bcbf8a3fe81edfcaeb090669
+  RCT-Folly: 59ec0ac1f2f39672a0c6e6cecdd39383b764646f
   RCTDeprecation: c4b9e2fd0ab200e3af72b013ed6113187c607077
   RCTRequired: e97dd5dafc1db8094e63bc5031e0371f092ae92a
   RCTTypeSafety: 720403058b7c1380c6a3ae5706981d6362962c89
@@ -2819,6 +2819,6 @@ SPEC CHECKSUMS:
   SocketRocket: d4aabe649be1e368d1318fdf28a022d714d65748
   Yoga: fa23995c18b65978347b096d0836f4f5093df545
 
-PODFILE CHECKSUM: 68a7c2afe0ade1366edc9327417ab94a1539b9b1
+PODFILE CHECKSUM: f03bb7813aed3d3c0b30414d3d99a1a8d5d800c5
 
 COCOAPODS: 1.15.2