react-native-iap 14.2.3 → 14.3.1

package/src/index.ts

@@ -363,8 +363,7 @@ export const finishTransaction = async ({
       };
     } else if (Platform.OS === 'android') {
       const androidPurchase = purchase as PurchaseAndroid;
-      const token =
-        androidPurchase.purchaseToken || androidPurchase.purchaseTokenAndroid;
+      const token = androidPurchase.purchaseToken;
 
       if (!token) {
         throw new Error('purchaseToken required to finish Android transaction');
@@ -1181,6 +1180,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>;
 }

package/src/types.ts

@@ -69,8 +69,6 @@ export type PurchaseCommon = {
   transactionId?: string;
   /** Transaction timestamp in milliseconds */
   transactionDate: number;
-  /** Transaction receipt for validation */
-  transactionReceipt: string;
   /** Unified purchase token (jwsRepresentation for iOS, purchaseToken for Android) */
   purchaseToken?: string;
   /** Platform identifier ('ios' or 'android') */

package/src/utils/type-bridge.ts

@@ -167,7 +167,7 @@ export function convertNitroPurchaseToPurchase(
     id: nitroPurchase.id,
     productId: nitroPurchase.productId,
     transactionDate: nitroPurchase.transactionDate,
-    transactionReceipt: '', // Will be set by native layer
+    // Unified token (iOS JWS, Android purchaseToken)
     purchaseToken: nitroPurchase.purchaseToken,
     platform: nitroPurchase.platform as 'ios' | 'android',
     // Common fields from NitroPurchase