expo-iap 3.0.7 → 3.1.0

package/src/modules/android.ts

@@ -5,7 +5,11 @@ import {Linking} from 'react-native';
 import ExpoIapModule from '../ExpoIapModule';
 
 // Types
-import type {ReceiptValidationResultAndroid, VoidResult} from '../types';
+import type {
+  DeepLinkOptions,
+  MutationField,
+  ReceiptValidationResultAndroid,
+} from '../types';
 
 // Type guards
 export function isProductAndroid<T extends {platform?: string}>(
@@ -15,32 +19,32 @@ export function isProductAndroid<T extends {platform?: string}>(
     item != null &&
     typeof item === 'object' &&
     'platform' in item &&
-    (item as any).platform === 'android'
+    typeof (item as any).platform === 'string' &&
+    (item as any).platform.toLowerCase() === 'android'
   );
 }
 
 /**
  * Deep link to subscriptions screen 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')
+ * @param {string} params.skuAndroid - The product's SKU (on Android)
+ * @param {string} params.packageNameAndroid - 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'
+ *   skuAndroid: 'subscription_id',
+ *   packageNameAndroid: 'com.example.app'
  * });
  * ```
  */
-export const deepLinkToSubscriptionsAndroid = async ({
-  sku,
-  packageName,
-}: {
-  sku?: string;
-  packageName?: string;
-}): Promise<void> => {
+export const deepLinkToSubscriptionsAndroid = async (
+  options?: DeepLinkOptions | null,
+): Promise<void> => {
+  const sku = options?.skuAndroid ?? undefined;
+  const packageName = options?.packageNameAndroid ?? undefined;
+
   // Prefer native deep link implementation via OpenIAP module
   if (ExpoIapModule?.deepLinkToSubscriptionsAndroid) {
     return (ExpoIapModule as any).deepLinkToSubscriptionsAndroid({
@@ -117,28 +121,26 @@ export const validateReceiptAndroid = async ({
  * @param {string} params.token - The product's token (on Android)
  * @returns {Promise<VoidResult | void>}
  */
-export const acknowledgePurchaseAndroid = async ({
-  token,
-}: {
-  token: string;
-}): Promise<VoidResult | boolean | void> => {
-  const result = await ExpoIapModule.acknowledgePurchaseAndroid(token);
+export const acknowledgePurchaseAndroid: MutationField<
+  'acknowledgePurchaseAndroid'
+> = async (purchaseToken) => {
+  const result = await ExpoIapModule.acknowledgePurchaseAndroid(purchaseToken);
 
-  if (typeof result === 'boolean' || typeof result === 'undefined') {
+  if (typeof result === 'boolean') {
     return result;
   }
 
   if (result && typeof result === 'object') {
     const record = result as Record<string, unknown>;
     if (typeof record.success === 'boolean') {
-      return {success: record.success};
+      return record.success;
     }
     if (typeof record.responseCode === 'number') {
-      return {success: record.responseCode === 0};
+      return record.responseCode === 0;
     }
   }
 
-  return {success: true};
+  return true;
 };
 
 /**

package/src/modules/ios.ts

@@ -6,14 +6,17 @@ import ExpoIapModule from '../ExpoIapModule';
 
 // Types
 import type {
-  Product,
+  MutationField,
+  ProductIOS,
   Purchase,
-  SubscriptionStatusIOS,
-  AppTransaction,
+  PurchaseIOS,
+  QueryField,
+  ReceiptValidationProps,
   ReceiptValidationResultIOS,
+  SubscriptionStatusIOS,
 } from '../types';
-import type {PurchaseError} from '../purchase-error';
-import {Linking} from 'react-native';
+import type {PurchaseError} from '../utils/errorMapping';
+import {Linking, Platform} from 'react-native';
 
 export type TransactionEvent = {
   transaction?: Purchase;
@@ -30,7 +33,8 @@ export function isProductIOS<T extends {platform?: string}>(
     item != null &&
     typeof item === 'object' &&
     'platform' in item &&
-    (item as any).platform === 'ios'
+    typeof (item as any).platform === 'string' &&
+    (item as any).platform.toLowerCase() === 'ios'
   );
 }
 
@@ -44,8 +48,8 @@ export function isProductIOS<T extends {platform?: string}>(
  *
  * @platform iOS
  */
-export const syncIOS = (): Promise<null> => {
-  return ExpoIapModule.syncIOS();
+export const syncIOS: MutationField<'syncIOS'> = async () => {
+  return Boolean(await ExpoIapModule.syncIOS());
 };
 
 /**
@@ -57,10 +61,13 @@ export const syncIOS = (): Promise<null> => {
  *
  * @platform iOS
  */
-export const isEligibleForIntroOfferIOS = (
-  groupId: string,
-): Promise<boolean> => {
-  return ExpoIapModule.isEligibleForIntroOfferIOS(groupId);
+export const isEligibleForIntroOfferIOS: QueryField<
+  'isEligibleForIntroOfferIOS'
+> = async (groupID) => {
+  if (!groupID) {
+    throw new Error('isEligibleForIntroOfferIOS requires a groupID');
+  }
+  return ExpoIapModule.isEligibleForIntroOfferIOS(groupID);
 };
 
 /**
@@ -72,10 +79,14 @@ export const isEligibleForIntroOfferIOS = (
  *
  * @platform iOS
  */
-export const subscriptionStatusIOS = (
-  sku: string,
-): Promise<SubscriptionStatusIOS[]> => {
-  return ExpoIapModule.subscriptionStatusIOS(sku);
+export const subscriptionStatusIOS: QueryField<
+  'subscriptionStatusIOS'
+> = async (sku) => {
+  if (!sku) {
+    throw new Error('subscriptionStatusIOS requires a SKU');
+  }
+  const status = await ExpoIapModule.subscriptionStatusIOS(sku);
+  return (status ?? []) as SubscriptionStatusIOS[];
 };
 
 /**
@@ -87,8 +98,14 @@ export const subscriptionStatusIOS = (
  *
  * @platform iOS
  */
-export const currentEntitlementIOS = (sku: string): Promise<Purchase> => {
-  return ExpoIapModule.currentEntitlementIOS(sku);
+export const currentEntitlementIOS: QueryField<
+  'currentEntitlementIOS'
+> = async (sku) => {
+  if (!sku) {
+    throw new Error('currentEntitlementIOS requires a SKU');
+  }
+  const purchase = await ExpoIapModule.currentEntitlementIOS(sku);
+  return (purchase ?? null) as PurchaseIOS | null;
 };
 
 /**
@@ -100,8 +117,14 @@ export const currentEntitlementIOS = (sku: string): Promise<Purchase> => {
  *
  * @platform iOS
  */
-export const latestTransactionIOS = (sku: string): Promise<Purchase> => {
-  return ExpoIapModule.latestTransactionIOS(sku);
+export const latestTransactionIOS: QueryField<'latestTransactionIOS'> = async (
+  sku,
+) => {
+  if (!sku) {
+    throw new Error('latestTransactionIOS requires a SKU');
+  }
+  const transaction = await ExpoIapModule.latestTransactionIOS(sku);
+  return (transaction ?? null) as PurchaseIOS | null;
 };
 
 /**
@@ -113,11 +136,14 @@ export const latestTransactionIOS = (sku: string): Promise<Purchase> => {
  *
  * @platform iOS
  */
-type RefundRequestStatus = 'success' | 'userCancelled';
-export const beginRefundRequestIOS = (
-  sku: string,
-): Promise<RefundRequestStatus> => {
-  return ExpoIapModule.beginRefundRequestIOS(sku);
+export const beginRefundRequestIOS: MutationField<
+  'beginRefundRequestIOS'
+> = async (sku) => {
+  if (!sku) {
+    throw new Error('beginRefundRequestIOS requires a SKU');
+  }
+  const status = await ExpoIapModule.beginRefundRequestIOS(sku);
+  return status ?? null;
 };
 
 /**
@@ -129,8 +155,11 @@ export const beginRefundRequestIOS = (
  *
  * @platform iOS
  */
-export const showManageSubscriptionsIOS = (): Promise<Purchase[]> => {
-  return ExpoIapModule.showManageSubscriptionsIOS();
+export const showManageSubscriptionsIOS: MutationField<
+  'showManageSubscriptionsIOS'
+> = async () => {
+  const purchases = await ExpoIapModule.showManageSubscriptionsIOS();
+  return (purchases ?? []) as PurchaseIOS[];
 };
 
 /**
@@ -143,10 +172,34 @@ export const showManageSubscriptionsIOS = (): Promise<Purchase[]> => {
  *
  * @returns {Promise<string>} Base64 encoded receipt data
  */
-export const getReceiptIOS = (): Promise<string> => {
+export const getReceiptDataIOS: QueryField<'getReceiptDataIOS'> = async () => {
   return ExpoIapModule.getReceiptDataIOS();
 };
 
+export const getReceiptIOS = getReceiptDataIOS;
+
+/**
+ * Retrieves the current storefront information from the iOS App Store.
+ *
+ * @returns Promise resolving to the storefront country code
+ * @throws Error if called on non-iOS platform
+ *
+ * @example
+ * ```typescript
+ * const storefront = await getStorefrontIOS();
+ * console.log(storefront); // 'US'
+ * ```
+ *
+ * @platform iOS
+ */
+export const getStorefrontIOS: QueryField<'getStorefrontIOS'> = async () => {
+  if (Platform.OS !== 'ios') {
+    console.warn('getStorefrontIOS: This method is only available on iOS');
+    return '';
+  }
+  return ExpoIapModule.getStorefrontIOS();
+};
+
 /**
  * Check if a transaction is verified through StoreKit 2.
  * StoreKit 2 performs local verification of transaction JWS signatures.
@@ -157,7 +210,12 @@ export const getReceiptIOS = (): Promise<string> => {
  *
  * @platform iOS
  */
-export const isTransactionVerifiedIOS = (sku: string): Promise<boolean> => {
+export const isTransactionVerifiedIOS: QueryField<
+  'isTransactionVerifiedIOS'
+> = async (sku) => {
+  if (!sku) {
+    throw new Error('isTransactionVerifiedIOS requires a SKU');
+  }
   return ExpoIapModule.isTransactionVerifiedIOS(sku);
 };
 
@@ -171,8 +229,14 @@ export const isTransactionVerifiedIOS = (sku: string): Promise<boolean> => {
  *
  * @platform iOS
  */
-export const getTransactionJwsIOS = (sku: string): Promise<string> => {
-  return ExpoIapModule.getTransactionJwsIOS(sku);
+export const getTransactionJwsIOS: QueryField<'getTransactionJwsIOS'> = async (
+  sku,
+) => {
+  if (!sku) {
+    throw new Error('getTransactionJwsIOS requires a SKU');
+  }
+  const jws = await ExpoIapModule.getTransactionJwsIOS(sku);
+  return jws ?? '';
 };
 
 /**
@@ -190,13 +254,24 @@ export const getTransactionJwsIOS = (sku: string): Promise<string> => {
  *   latestTransaction?: Purchase;
  * }>}
  */
-export const validateReceiptIOS = async (
-  sku: string,
-): Promise<ReceiptValidationResultIOS> => {
-  const result = await ExpoIapModule.validateReceiptIOS(sku);
-  return result;
+const validateReceiptIOSImpl = async (
+  props: ReceiptValidationProps | string,
+) => {
+  const sku =
+    typeof props === 'string' ? props : (props as ReceiptValidationProps)?.sku;
+
+  if (!sku) {
+    throw new Error('validateReceiptIOS requires a SKU');
+  }
+
+  return (await ExpoIapModule.validateReceiptIOS(
+    sku,
+  )) as ReceiptValidationResultIOS;
 };
 
+export const validateReceiptIOS =
+  validateReceiptIOSImpl as QueryField<'validateReceiptIOS'>;
+
 /**
  * Present the code redemption sheet for offer codes (iOS only).
  * This allows users to redeem promotional codes for in-app purchases and subscriptions.
@@ -208,8 +283,10 @@ export const validateReceiptIOS = async (
  *
  * @platform iOS
  */
-export const presentCodeRedemptionSheetIOS = (): Promise<boolean> => {
-  return ExpoIapModule.presentCodeRedemptionSheetIOS();
+export const presentCodeRedemptionSheetIOS: MutationField<
+  'presentCodeRedemptionSheetIOS'
+> = async () => {
+  return Boolean(await ExpoIapModule.presentCodeRedemptionSheetIOS());
 };
 
 /**
@@ -226,8 +303,10 @@ export const presentCodeRedemptionSheetIOS = (): Promise<boolean> => {
  * @platform iOS
  * @since iOS 16.0
  */
-export const getAppTransactionIOS = (): Promise<AppTransaction | null> => {
-  return ExpoIapModule.getAppTransactionIOS();
+export const getAppTransactionIOS: QueryField<
+  'getAppTransactionIOS'
+> = async () => {
+  return (await ExpoIapModule.getAppTransactionIOS()) ?? null;
 };
 
 /**
@@ -240,8 +319,11 @@ export const getAppTransactionIOS = (): Promise<AppTransaction | null> => {
  *
  * @platform iOS
  */
-export const getPromotedProductIOS = (): Promise<Product | null> => {
-  return ExpoIapModule.getPromotedProductIOS();
+export const getPromotedProductIOS: QueryField<
+  'getPromotedProductIOS'
+> = async () => {
+  const product = await ExpoIapModule.getPromotedProductIOS();
+  return (product ?? null) as ProductIOS | null;
 };
 
 /**
@@ -253,8 +335,11 @@ export const getPromotedProductIOS = (): Promise<Product | null> => {
  *
  * @platform iOS
  */
-export const requestPurchaseOnPromotedProductIOS = (): Promise<void> => {
-  return ExpoIapModule.requestPurchaseOnPromotedProductIOS();
+export const requestPurchaseOnPromotedProductIOS: MutationField<
+  'requestPurchaseOnPromotedProductIOS'
+> = async () => {
+  await ExpoIapModule.requestPurchaseOnPromotedProductIOS();
+  return true;
 };
 
 /**
@@ -263,8 +348,11 @@ export const requestPurchaseOnPromotedProductIOS = (): Promise<void> => {
  * @returns Promise resolving to array of pending transactions
  * @platform iOS
  */
-export const getPendingTransactionsIOS = (): Promise<any[]> => {
-  return ExpoIapModule.getPendingTransactionsIOS();
+export const getPendingTransactionsIOS: QueryField<
+  'getPendingTransactionsIOS'
+> = async () => {
+  const transactions = await ExpoIapModule.getPendingTransactionsIOS();
+  return (transactions ?? []) as PurchaseIOS[];
 };
 
 /**
@@ -273,8 +361,10 @@ export const getPendingTransactionsIOS = (): Promise<any[]> => {
  * @returns Promise resolving when transaction is cleared
  * @platform iOS
  */
-export const clearTransactionIOS = (): Promise<void> => {
-  return ExpoIapModule.clearTransactionIOS();
+export const clearTransactionIOS: MutationField<
+  'clearTransactionIOS'
+> = async () => {
+  return Boolean(await ExpoIapModule.clearTransactionIOS());
 };
 
 /**