expo-iap 2.7.9 → 2.7.11

package/src/ExpoIap.types.ts

@@ -1,15 +1,11 @@
 import {
   ProductAndroid,
   ProductPurchaseAndroid,
-  RequestPurchaseAndroidProps,
-  RequestSubscriptionAndroidProps,
   SubscriptionProductAndroid,
 } from './types/ExpoIapAndroid.types';
 import {
   ProductIos,
   ProductPurchaseIos,
-  RequestPurchaseIosProps,
-  RequestSubscriptionIosProps,
   SubscriptionProductIos,
 } from './types/ExpoIapIos.types';
 import {NATIVE_ERROR_CODES} from './ExpoIapModule';
@@ -51,15 +47,6 @@ export type SubscriptionProduct =
   | (SubscriptionProductAndroid & AndroidPlatform)
   | (SubscriptionProductIos & IosPlatform);
 
-// Legacy internal platform-specific types (kept for backward compatibility)
-export type LegacyRequestPurchaseProps =
-  | RequestPurchaseIosProps
-  | RequestPurchaseAndroidProps;
-
-export type LegacyRequestSubscriptionProps =
-  | RequestSubscriptionAndroidProps
-  | RequestSubscriptionIosProps;
-
 // ============================================================================
 // Legacy Types (For backward compatibility with useIap hook)
 // ============================================================================
@@ -323,20 +310,6 @@ export interface UnifiedRequestPurchaseProps {
   readonly isOfferPersonalized?: boolean;
 }
 
-/**
- * Unified subscription request props
- */
-export interface UnifiedRequestSubscriptionProps
-  extends UnifiedRequestPurchaseProps {
-  // Android subscription-specific properties
-  readonly purchaseTokenAndroid?: string;
-  readonly replacementModeAndroid?: number;
-  readonly subscriptionOffers?: {
-    sku: string;
-    offerToken: string;
-  }[];
-}
-
 // ============================================================================
 // New Platform-Specific Request Types (v2.7.0+)
 // ============================================================================
@@ -344,7 +317,7 @@ export interface UnifiedRequestSubscriptionProps
 /**
  * iOS-specific purchase request parameters
  */
-export interface IosRequestPurchaseProps {
+export interface RequestPurchaseIosProps {
   readonly sku: string;
   readonly andDangerouslyFinishTransactionAutomaticallyIOS?: boolean;
   readonly appAccountToken?: string;
@@ -355,7 +328,7 @@ export interface IosRequestPurchaseProps {
 /**
  * Android-specific purchase request parameters
  */
-export interface AndroidRequestPurchaseProps {
+export interface RequestPurchaseAndroidProps {
   readonly skus: string[];
   readonly obfuscatedAccountIdAndroid?: string;
   readonly obfuscatedProfileIdAndroid?: string;
@@ -365,8 +338,8 @@ export interface AndroidRequestPurchaseProps {
 /**
  * Android-specific subscription request parameters
  */
-export interface AndroidRequestSubscriptionProps
-  extends AndroidRequestPurchaseProps {
+export interface RequestSubscriptionAndroidProps
+  extends RequestPurchaseAndroidProps {
   readonly purchaseTokenAndroid?: string;
   readonly replacementModeAndroid?: number;
   readonly subscriptionOffers: {
@@ -379,88 +352,29 @@ export interface AndroidRequestSubscriptionProps
  * Modern platform-specific request structure (v2.7.0+)
  * Allows clear separation of iOS and Android parameters
  */
-export interface PlatformRequestPurchaseProps {
-  readonly ios?: IosRequestPurchaseProps;
-  readonly android?: AndroidRequestPurchaseProps;
+export interface RequestPurchasePropsByPlatforms {
+  readonly ios?: RequestPurchaseIosProps;
+  readonly android?: RequestPurchaseAndroidProps;
 }
 
 /**
  * Modern platform-specific subscription request structure (v2.7.0+)
  */
-export interface PlatformRequestSubscriptionProps {
-  readonly ios?: IosRequestPurchaseProps;
-  readonly android?: AndroidRequestSubscriptionProps;
+export interface RequestSubscriptionPropsByPlatforms {
+  readonly ios?: RequestPurchaseIosProps;
+  readonly android?: RequestSubscriptionAndroidProps;
 }
 
 /**
  * Modern request purchase parameters (v2.7.0+)
  * This is the recommended API moving forward
  */
-export type RequestPurchaseProps = PlatformRequestPurchaseProps;
+export type RequestPurchaseProps = RequestPurchasePropsByPlatforms;
 
 /**
  * Modern request subscription parameters (v2.7.0+)
  * This is the recommended API moving forward
  */
-export type RequestSubscriptionProps = PlatformRequestSubscriptionProps;
-
-/**
- * Legacy request purchase parameters (deprecated)
- * Includes both unified and old platform-specific formats
- * @deprecated Use RequestPurchaseProps with platform-specific structure instead
- */
-export type LegacyRequestPurchasePropsAll =
-  | UnifiedRequestPurchaseProps
-  | LegacyRequestPurchaseProps;
-
-/**
- * Legacy request subscription parameters (deprecated)
- * Includes both unified and old platform-specific formats
- * @deprecated Use RequestSubscriptionProps with platform-specific structure instead
- */
-export type LegacyRequestSubscriptionPropsAll =
-  | UnifiedRequestSubscriptionProps
-  | LegacyRequestSubscriptionProps;
-
-/**
- * All supported request purchase parameters
- * Used internally for backward compatibility
- * @internal
- */
-export type RequestPurchasePropsWithLegacy =
-  | RequestPurchaseProps
-  | LegacyRequestPurchasePropsAll;
-
-/**
- * All supported request subscription parameters
- * Used internally for backward compatibility
- * @internal
- */
-export type RequestSubscriptionPropsWithLegacy =
-  | RequestSubscriptionProps
-  | LegacyRequestSubscriptionPropsAll;
-
-// ============================================================================
-// Type Guards and Utility Functions
-// ============================================================================
-
-// Type guards to check which API style is being used
-export function isPlatformRequestProps(
-  props: RequestPurchasePropsWithLegacy | RequestSubscriptionPropsWithLegacy,
-): props is PlatformRequestPurchaseProps | PlatformRequestSubscriptionProps {
-  return 'ios' in props || 'android' in props;
-}
-
-export function isUnifiedRequestProps(
-  props: RequestPurchasePropsWithLegacy | RequestSubscriptionPropsWithLegacy,
-): props is UnifiedRequestPurchaseProps | UnifiedRequestSubscriptionProps {
-  return 'sku' in props || 'skus' in props;
-}
-
-export function isLegacyRequestProps(
-  props: RequestPurchasePropsWithLegacy | RequestSubscriptionPropsWithLegacy,
-): props is LegacyRequestPurchaseProps | LegacyRequestSubscriptionProps {
-  return 'productId' in props || 'productIds' in props;
-}
+export type RequestSubscriptionProps = RequestSubscriptionPropsByPlatforms;
 
-// Note: Other type guard functions are exported from index.ts to avoid conflicts
+// Note: Type guard functions are exported from index.ts to avoid conflicts

package/src/index.ts

@@ -4,8 +4,16 @@ import {Platform} from 'react-native';
 
 // Internal modules
 import ExpoIapModule from './ExpoIapModule';
-import {isProductIos, validateReceiptIOS} from './modules/ios';
-import {isProductAndroid, validateReceiptAndroid} from './modules/android';
+import {
+  isProductIos,
+  validateReceiptIOS,
+  deepLinkToSubscriptionsIos,
+} from './modules/ios';
+import {
+  isProductAndroid,
+  validateReceiptAndroid,
+  deepLinkToSubscriptionsAndroid,
+} from './modules/android';
 
 // Types
 import {
@@ -14,12 +22,10 @@ import {
   Purchase,
   PurchaseError,
   PurchaseResult,
-  RequestSubscriptionPropsWithLegacy,
-  RequestPurchasePropsWithLegacy,
+  RequestSubscriptionProps,
+  RequestPurchaseProps,
   SubscriptionProduct,
   SubscriptionPurchase,
-  isPlatformRequestProps,
-  isUnifiedRequestProps,
 } from './ExpoIap.types';
 import {ProductPurchaseAndroid} from './types/ExpoIapAndroid.types';
 import {PaymentDiscount} from './types/ExpoIapIos.types';
@@ -341,14 +347,13 @@ const offerToRecordIos = (
 };
 
 // Define discriminated union with explicit type parameter
-// Using legacy types internally for backward compatibility
 type PurchaseRequest =
   | {
-      request: RequestPurchasePropsWithLegacy;
+      request: RequestPurchaseProps;
       type?: 'inapp';
     }
   | {
-      request: RequestSubscriptionPropsWithLegacy;
+      request: RequestSubscriptionProps;
       type: 'subs';
     };
 
@@ -356,50 +361,11 @@ type PurchaseRequest =
  * Helper to normalize request props to platform-specific format
  */
 const normalizeRequestProps = (
-  request: RequestPurchasePropsWithLegacy | RequestSubscriptionPropsWithLegacy,
+  request: RequestPurchaseProps | RequestSubscriptionProps,
   platform: 'ios' | 'android',
 ): any => {
-  // If it's already platform-specific format
-  if (isPlatformRequestProps(request)) {
-    return platform === 'ios' ? request.ios : request.android;
-  }
-
-  // If it's unified format, convert to platform-specific
-  if (isUnifiedRequestProps(request)) {
-    if (platform === 'ios') {
-      return {
-        sku: request.sku || (request.skus?.[0] ?? ''),
-        andDangerouslyFinishTransactionAutomaticallyIOS:
-          request.andDangerouslyFinishTransactionAutomaticallyIOS,
-        appAccountToken: request.appAccountToken,
-        quantity: request.quantity,
-        withOffer: request.withOffer,
-      };
-    } else {
-      const androidRequest: any = {
-        skus: request.skus || (request.sku ? [request.sku] : []),
-        obfuscatedAccountIdAndroid: request.obfuscatedAccountIdAndroid,
-        obfuscatedProfileIdAndroid: request.obfuscatedProfileIdAndroid,
-        isOfferPersonalized: request.isOfferPersonalized,
-      };
-
-      // Add subscription-specific fields if present
-      if ('subscriptionOffers' in request && request.subscriptionOffers) {
-        androidRequest.subscriptionOffers = request.subscriptionOffers;
-      }
-      if ('purchaseTokenAndroid' in request) {
-        androidRequest.purchaseTokenAndroid = request.purchaseTokenAndroid;
-      }
-      if ('replacementModeAndroid' in request) {
-        androidRequest.replacementModeAndroid = request.replacementModeAndroid;
-      }
-
-      return androidRequest;
-    }
-  }
-
-  // Legacy format handling
-  return request;
+  // Platform-specific format - directly return the appropriate platform data
+  return platform === 'ios' ? request.ios : request.android;
 };
 
 /**
@@ -567,7 +533,7 @@ export const requestPurchase = (
  * ```
  */
 export const requestSubscription = async (
-  request: RequestSubscriptionPropsWithLegacy,
+  request: RequestSubscriptionProps,
 ): Promise<SubscriptionPurchase | SubscriptionPurchase[] | null | void> => {
   console.warn(
     "`requestSubscription` is deprecated and will be removed in version 3.0.0. Use `requestPurchase({ request, type: 'subs' })` instead.",
@@ -694,5 +660,55 @@ export const validateReceipt = async (
   }
 };
 
+/**
+ * Deeplinks to native interface that allows users to manage their subscriptions
+ * @param options.skuAndroid - Required for Android to locate specific subscription (ignored on iOS)
+ * @param options.packageNameAndroid - Required for Android to identify your app (ignored on iOS)
+ *
+ * @returns Promise that resolves when the deep link is successfully opened
+ *
+ * @throws {Error} When called on unsupported platform or when required Android parameters are missing
+ *
+ * @example
+ * import { deepLinkToSubscriptions } from 'expo-iap';
+ *
+ * // Works on both iOS and Android
+ * await deepLinkToSubscriptions({
+ *   skuAndroid: 'your_subscription_sku',
+ *   packageNameAndroid: 'com.example.app'
+ * });
+ */
+export const deepLinkToSubscriptions = (options: {
+  skuAndroid?: string;
+  packageNameAndroid?: string;
+}): Promise<void> => {
+  if (Platform.OS === 'ios') {
+    return deepLinkToSubscriptionsIos();
+  }
+
+  if (Platform.OS === 'android') {
+    if (!options.skuAndroid) {
+      return Promise.reject(
+        new Error(
+          'skuAndroid is required to locate subscription in Android Store',
+        ),
+      );
+    }
+    if (!options.packageNameAndroid) {
+      return Promise.reject(
+        new Error(
+          'packageNameAndroid is required to identify your app in Android Store',
+        ),
+      );
+    }
+    return deepLinkToSubscriptionsAndroid({
+      sku: options.skuAndroid,
+      packageName: options.packageNameAndroid,
+    });
+  }
+
+  return Promise.reject(new Error(`Unsupported platform: ${Platform.OS}`));
+};
+
 export * from './useIap';
 export * from './utils/errorMapping';

package/src/modules/android.ts

@@ -22,16 +22,34 @@ export function isProductAndroid<T extends {platform?: string}>(
 
 /**
  * Deep link to subscriptions screen on Android.
- * @param {string} sku The product's SKU (on Android)
+ * @param {Object} params - The parameters object
+ * @param {string} params.sku - The product's SKU (on Android)
+ * @param {string} params.packageName - The package name of your Android app (e.g., 'com.example.app')
  * @returns {Promise<void>}
+ *
+ * @example
+ * ```typescript
+ * await deepLinkToSubscriptionsAndroid({
+ *   sku: 'subscription_id',
+ *   packageName: 'com.example.app'
+ * });
+ * ```
  */
 export const deepLinkToSubscriptionsAndroid = async ({
   sku,
+  packageName,
 }: {
   sku: string;
+  packageName: string;
 }): Promise<void> => {
+  if (!packageName) {
+    throw new Error(
+      'packageName is required for deepLinkToSubscriptionsAndroid',
+    );
+  }
+
   return Linking.openURL(
-    `https://play.google.com/store/account/subscriptions?package=${await ExpoIapModule.getPackageName()}&sku=${sku}`,
+    `https://play.google.com/store/account/subscriptions?package=${packageName}&sku=${sku}`,
   );
 };
 
@@ -39,11 +57,12 @@ export const deepLinkToSubscriptionsAndroid = async ({
  * Validate receipt for Android. NOTE: This method is here for debugging purposes only. Including
  * your access token in the binary you ship to users is potentially dangerous.
  * Use server side validation instead for your production builds
- * @param {string} packageName package name of your app.
- * @param {string} productId product id for your in app product.
- * @param {string} productToken token for your purchase (called 'token' in the API documentation).
- * @param {string} accessToken OAuth access token with androidpublisher scope. Required for authentication.
- * @param {boolean} isSub whether this is subscription or inapp. `true` for subscription.
+ * @param {Object} params - The parameters object
+ * @param {string} params.packageName - package name of your app.
+ * @param {string} params.productId - product id for your in app product.
+ * @param {string} params.productToken - token for your purchase (called 'token' in the API documentation).
+ * @param {string} params.accessToken - OAuth access token with androidpublisher scope. Required for authentication.
+ * @param {boolean} params.isSub - whether this is subscription or inapp. `true` for subscription.
  * @returns {Promise<ReceiptAndroid>}
  */
 export const validateReceiptAndroid = async ({
@@ -85,7 +104,8 @@ export const validateReceiptAndroid = async ({
 
 /**
  * Acknowledge a product (on Android.) No-op on iOS.
- * @param {string} token The product's token (on Android)
+ * @param {Object} params - The parameters object
+ * @param {string} params.token - The product's token (on Android)
  * @returns {Promise<PurchaseResult | void>}
  */
 export const acknowledgePurchaseAndroid = ({

package/src/modules/ios.ts

@@ -15,6 +15,7 @@ import type {
   ProductStatusIos,
   AppTransactionIOS,
 } from '../types/ExpoIapIos.types';
+import {Linking} from 'react-native';
 
 export type TransactionEvent = {
   transaction?: ProductPurchase;
@@ -314,6 +315,15 @@ export const buyPromotedProductIOS = (): Promise<void> => {
   return ExpoIapModule.buyPromotedProduct();
 };
 
+/**
+ * Deep link to subscriptions screen on iOS.
+ * @returns {Promise<void>}
+ *
+ * @platform iOS
+ */
+export const deepLinkToSubscriptionsIos = (): Promise<void> =>
+  Linking.openURL('https://apps.apple.com/account/subscriptions');
+
 // ============= DEPRECATED FUNCTIONS =============
 // These will be removed in version 3.0.0