expo-iap 3.0.7 → 3.1.0

package/build/modules/ios.js

@@ -2,14 +2,15 @@
 // Internal modules
 // import removed: use purchaseUpdatedListener directly in app code
 import ExpoIapModule from '../ExpoIapModule';
-import { Linking } from 'react-native';
+import { Linking, Platform } from 'react-native';
 // Listeners
 // Type guards
 export function isProductIOS(item) {
     return (item != null &&
         typeof item === 'object' &&
         'platform' in item &&
-        item.platform === 'ios');
+        typeof item.platform === 'string' &&
+        item.platform.toLowerCase() === 'ios');
 }
 // Functions
 /**
@@ -21,8 +22,8 @@ export function isProductIOS(item) {
  *
  * @platform iOS
  */
-export const syncIOS = () => {
-    return ExpoIapModule.syncIOS();
+export const syncIOS = async () => {
+    return Boolean(await ExpoIapModule.syncIOS());
 };
 /**
  * Check if user is eligible for introductory offer
@@ -33,8 +34,11 @@ export const syncIOS = () => {
  *
  * @platform iOS
  */
-export const isEligibleForIntroOfferIOS = (groupId) => {
-    return ExpoIapModule.isEligibleForIntroOfferIOS(groupId);
+export const isEligibleForIntroOfferIOS = async (groupID) => {
+    if (!groupID) {
+        throw new Error('isEligibleForIntroOfferIOS requires a groupID');
+    }
+    return ExpoIapModule.isEligibleForIntroOfferIOS(groupID);
 };
 /**
  * Get subscription status for a specific SKU
@@ -45,8 +49,12 @@ export const isEligibleForIntroOfferIOS = (groupId) => {
  *
  * @platform iOS
  */
-export const subscriptionStatusIOS = (sku) => {
-    return ExpoIapModule.subscriptionStatusIOS(sku);
+export const subscriptionStatusIOS = async (sku) => {
+    if (!sku) {
+        throw new Error('subscriptionStatusIOS requires a SKU');
+    }
+    const status = await ExpoIapModule.subscriptionStatusIOS(sku);
+    return (status ?? []);
 };
 /**
  * Get current entitlement for a specific SKU
@@ -57,8 +65,12 @@ export const subscriptionStatusIOS = (sku) => {
  *
  * @platform iOS
  */
-export const currentEntitlementIOS = (sku) => {
-    return ExpoIapModule.currentEntitlementIOS(sku);
+export const currentEntitlementIOS = async (sku) => {
+    if (!sku) {
+        throw new Error('currentEntitlementIOS requires a SKU');
+    }
+    const purchase = await ExpoIapModule.currentEntitlementIOS(sku);
+    return (purchase ?? null);
 };
 /**
  * Get latest transaction for a specific SKU
@@ -69,11 +81,28 @@ export const currentEntitlementIOS = (sku) => {
  *
  * @platform iOS
  */
-export const latestTransactionIOS = (sku) => {
-    return ExpoIapModule.latestTransactionIOS(sku);
+export const latestTransactionIOS = async (sku) => {
+    if (!sku) {
+        throw new Error('latestTransactionIOS requires a SKU');
+    }
+    const transaction = await ExpoIapModule.latestTransactionIOS(sku);
+    return (transaction ?? null);
 };
-export const beginRefundRequestIOS = (sku) => {
-    return ExpoIapModule.beginRefundRequestIOS(sku);
+/**
+ * Begin refund request for a specific SKU
+ *
+ * @param sku The product SKU
+ * @returns Promise resolving to refund request status
+ * @throws Error if called on non-iOS platform
+ *
+ * @platform iOS
+ */
+export const beginRefundRequestIOS = async (sku) => {
+    if (!sku) {
+        throw new Error('beginRefundRequestIOS requires a SKU');
+    }
+    const status = await ExpoIapModule.beginRefundRequestIOS(sku);
+    return status ?? null;
 };
 /**
  * Shows the system UI for managing subscriptions.
@@ -84,8 +113,9 @@ export const beginRefundRequestIOS = (sku) => {
  *
  * @platform iOS
  */
-export const showManageSubscriptionsIOS = () => {
-    return ExpoIapModule.showManageSubscriptionsIOS();
+export const showManageSubscriptionsIOS = async () => {
+    const purchases = await ExpoIapModule.showManageSubscriptionsIOS();
+    return (purchases ?? []);
 };
 /**
  * Get the receipt data from the iOS device.
@@ -97,9 +127,31 @@ export const showManageSubscriptionsIOS = () => {
  *
  * @returns {Promise<string>} Base64 encoded receipt data
  */
-export const getReceiptIOS = () => {
+export const 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 = 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.
@@ -110,7 +162,10 @@ export const getReceiptIOS = () => {
  *
  * @platform iOS
  */
-export const isTransactionVerifiedIOS = (sku) => {
+export const isTransactionVerifiedIOS = async (sku) => {
+    if (!sku) {
+        throw new Error('isTransactionVerifiedIOS requires a SKU');
+    }
     return ExpoIapModule.isTransactionVerifiedIOS(sku);
 };
 /**
@@ -123,8 +178,12 @@ export const isTransactionVerifiedIOS = (sku) => {
  *
  * @platform iOS
  */
-export const getTransactionJwsIOS = (sku) => {
-    return ExpoIapModule.getTransactionJwsIOS(sku);
+export const getTransactionJwsIOS = async (sku) => {
+    if (!sku) {
+        throw new Error('getTransactionJwsIOS requires a SKU');
+    }
+    const jws = await ExpoIapModule.getTransactionJwsIOS(sku);
+    return jws ?? '';
 };
 /**
  * Validate receipt for iOS using StoreKit 2's built-in verification.
@@ -141,10 +200,14 @@ export const getTransactionJwsIOS = (sku) => {
  *   latestTransaction?: Purchase;
  * }>}
  */
-export const validateReceiptIOS = async (sku) => {
-    const result = await ExpoIapModule.validateReceiptIOS(sku);
-    return result;
+const validateReceiptIOSImpl = async (props) => {
+    const sku = typeof props === 'string' ? props : props?.sku;
+    if (!sku) {
+        throw new Error('validateReceiptIOS requires a SKU');
+    }
+    return (await ExpoIapModule.validateReceiptIOS(sku));
 };
+export const validateReceiptIOS = validateReceiptIOSImpl;
 /**
  * Present the code redemption sheet for offer codes (iOS only).
  * This allows users to redeem promotional codes for in-app purchases and subscriptions.
@@ -156,8 +219,8 @@ export const validateReceiptIOS = async (sku) => {
  *
  * @platform iOS
  */
-export const presentCodeRedemptionSheetIOS = () => {
-    return ExpoIapModule.presentCodeRedemptionSheetIOS();
+export const presentCodeRedemptionSheetIOS = async () => {
+    return Boolean(await ExpoIapModule.presentCodeRedemptionSheetIOS());
 };
 /**
  * Get app transaction information (iOS 16.0+).
@@ -173,8 +236,8 @@ export const presentCodeRedemptionSheetIOS = () => {
  * @platform iOS
  * @since iOS 16.0
  */
-export const getAppTransactionIOS = () => {
-    return ExpoIapModule.getAppTransactionIOS();
+export const getAppTransactionIOS = async () => {
+    return (await ExpoIapModule.getAppTransactionIOS()) ?? null;
 };
 /**
  * Get information about a promoted product if one is available (iOS only).
@@ -186,8 +249,9 @@ export const getAppTransactionIOS = () => {
  *
  * @platform iOS
  */
-export const getPromotedProductIOS = () => {
-    return ExpoIapModule.getPromotedProductIOS();
+export const getPromotedProductIOS = async () => {
+    const product = await ExpoIapModule.getPromotedProductIOS();
+    return (product ?? null);
 };
 /**
  * Complete the purchase of a promoted product (iOS only).
@@ -198,8 +262,9 @@ export const getPromotedProductIOS = () => {
  *
  * @platform iOS
  */
-export const requestPurchaseOnPromotedProductIOS = () => {
-    return ExpoIapModule.requestPurchaseOnPromotedProductIOS();
+export const requestPurchaseOnPromotedProductIOS = async () => {
+    await ExpoIapModule.requestPurchaseOnPromotedProductIOS();
+    return true;
 };
 /**
  * Get pending transactions that haven't been finished yet (iOS only).
@@ -207,8 +272,9 @@ export const requestPurchaseOnPromotedProductIOS = () => {
  * @returns Promise resolving to array of pending transactions
  * @platform iOS
  */
-export const getPendingTransactionsIOS = () => {
-    return ExpoIapModule.getPendingTransactionsIOS();
+export const getPendingTransactionsIOS = async () => {
+    const transactions = await ExpoIapModule.getPendingTransactionsIOS();
+    return (transactions ?? []);
 };
 /**
  * Clear a specific transaction (iOS only).
@@ -216,8 +282,8 @@ export const getPendingTransactionsIOS = () => {
  * @returns Promise resolving when transaction is cleared
  * @platform iOS
  */
-export const clearTransactionIOS = () => {
-    return ExpoIapModule.clearTransactionIOS();
+export const clearTransactionIOS = async () => {
+    return Boolean(await ExpoIapModule.clearTransactionIOS());
 };
 /**
  * Deep link to subscriptions screen on iOS.

package/build/modules/ios.js.map

@@ -1 +1 @@
-{"version":3,"file":"ios.js","sourceRoot":"","sources":["../../src/modules/ios.ts"],"names":[],"mappings":"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","sourcesContent":["// External dependencies\n\n// Internal modules\n// import removed: use purchaseUpdatedListener directly in app code\nimport ExpoIapModule from '../ExpoIapModule';\n\n// Types\nimport type {\n  Product,\n  Purchase,\n  SubscriptionStatusIOS,\n  AppTransaction,\n  ReceiptValidationResultIOS,\n} from '../types';\nimport type {PurchaseError} from '../purchase-error';\nimport {Linking} from 'react-native';\n\nexport type TransactionEvent = {\n  transaction?: Purchase;\n  error?: PurchaseError;\n};\n\n// Listeners\n\n// Type guards\nexport function isProductIOS<T extends {platform?: string}>(\n  item: unknown,\n): item is T & {platform: 'ios'} {\n  return (\n    item != null &&\n    typeof item === 'object' &&\n    'platform' in item &&\n    (item as any).platform === 'ios'\n  );\n}\n\n// Functions\n/**\n * Sync state with Appstore (iOS only)\n * https://developer.apple.com/documentation/storekit/appstore/3791906-sync\n *\n * @returns Promise resolving to null on success\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const syncIOS = (): Promise<null> => {\n  return ExpoIapModule.syncIOS();\n};\n\n/**\n * Check if user is eligible for introductory offer\n *\n * @param groupId The subscription group ID\n * @returns Promise resolving to true if eligible\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const isEligibleForIntroOfferIOS = (\n  groupId: string,\n): Promise<boolean> => {\n  return ExpoIapModule.isEligibleForIntroOfferIOS(groupId);\n};\n\n/**\n * Get subscription status for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to array of subscription status\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const subscriptionStatusIOS = (\n  sku: string,\n): Promise<SubscriptionStatusIOS[]> => {\n  return ExpoIapModule.subscriptionStatusIOS(sku);\n};\n\n/**\n * Get current entitlement for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to current entitlement\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const currentEntitlementIOS = (sku: string): Promise<Purchase> => {\n  return ExpoIapModule.currentEntitlementIOS(sku);\n};\n\n/**\n * Get latest transaction for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to latest transaction\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const latestTransactionIOS = (sku: string): Promise<Purchase> => {\n  return ExpoIapModule.latestTransactionIOS(sku);\n};\n\n/**\n * Begin refund request for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to refund request status\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\ntype RefundRequestStatus = 'success' | 'userCancelled';\nexport const beginRefundRequestIOS = (\n  sku: string,\n): Promise<RefundRequestStatus> => {\n  return ExpoIapModule.beginRefundRequestIOS(sku);\n};\n\n/**\n * Shows the system UI for managing subscriptions.\n * Returns an array of subscriptions that had status changes after the UI is closed.\n *\n * @returns Promise<Purchase[]> - Array of subscriptions with status changes (e.g., auto-renewal toggled)\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const showManageSubscriptionsIOS = (): Promise<Purchase[]> => {\n  return ExpoIapModule.showManageSubscriptionsIOS();\n};\n\n/**\n * Get the receipt data from the iOS device.\n * This returns the base64 encoded receipt data which can be sent to your server\n * for verification with Apple's server.\n *\n * NOTE: For proper security, always verify receipts on your server using\n * Apple's verifyReceipt endpoint, not directly from the app.\n *\n * @returns {Promise<string>} Base64 encoded receipt data\n */\nexport const getReceiptIOS = (): Promise<string> => {\n  return ExpoIapModule.getReceiptDataIOS();\n};\n\n/**\n * Check if a transaction is verified through StoreKit 2.\n * StoreKit 2 performs local verification of transaction JWS signatures.\n *\n * @param sku The product's SKU (on iOS)\n * @returns Promise resolving to true if the transaction is verified\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const isTransactionVerifiedIOS = (sku: string): Promise<boolean> => {\n  return ExpoIapModule.isTransactionVerifiedIOS(sku);\n};\n\n/**\n * Get the JWS representation of a purchase for server-side verification.\n * The JWS (JSON Web Signature) can be verified on your server using Apple's public keys.\n *\n * @param sku The product's SKU (on iOS)\n * @returns Promise resolving to JWS representation of the transaction\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const getTransactionJwsIOS = (sku: string): Promise<string> => {\n  return ExpoIapModule.getTransactionJwsIOS(sku);\n};\n\n/**\n * Validate receipt for iOS using StoreKit 2's built-in verification.\n * Returns receipt data and verification information to help with server-side validation.\n *\n * NOTE: For proper security, Apple recommends verifying receipts on your server using\n * the verifyReceipt endpoint rather than relying solely on client-side verification.\n *\n * @param {string} sku The product's SKU (on iOS)\n * @returns {Promise<{\n *   isValid: boolean;\n *   receiptData: string;\n *   jwsRepresentation: string;\n *   latestTransaction?: Purchase;\n * }>}\n */\nexport const validateReceiptIOS = async (\n  sku: string,\n): Promise<ReceiptValidationResultIOS> => {\n  const result = await ExpoIapModule.validateReceiptIOS(sku);\n  return result;\n};\n\n/**\n * Present the code redemption sheet for offer codes (iOS only).\n * This allows users to redeem promotional codes for in-app purchases and subscriptions.\n *\n * Note: This only works on real devices, not simulators.\n *\n * @returns Promise resolving to true if the sheet was presented successfully\n * @throws Error if called on non-iOS platform or tvOS\n *\n * @platform iOS\n */\nexport const presentCodeRedemptionSheetIOS = (): Promise<boolean> => {\n  return ExpoIapModule.presentCodeRedemptionSheetIOS();\n};\n\n/**\n * Get app transaction information (iOS 16.0+).\n * AppTransaction represents the initial purchase that unlocked the app.\n *\n * NOTE: This function requires:\n * - iOS 16.0 or later at runtime\n * - Xcode 15.0+ with iOS 16.0 SDK for compilation\n *\n * @returns Promise resolving to the app transaction information or null if not available\n * @throws Error if called on non-iOS platform, iOS version < 16.0, or compiled with older SDK\n *\n * @platform iOS\n * @since iOS 16.0\n */\nexport const getAppTransactionIOS = (): Promise<AppTransaction | null> => {\n  return ExpoIapModule.getAppTransactionIOS();\n};\n\n/**\n * Get information about a promoted product if one is available (iOS only).\n * Promoted products are products that the App Store promotes on your behalf.\n * This is called after a promoted product event is received from the App Store.\n *\n * @returns Promise resolving to the promoted product information or null if none available\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const getPromotedProductIOS = (): Promise<Product | null> => {\n  return ExpoIapModule.getPromotedProductIOS();\n};\n\n/**\n * Complete the purchase of a promoted product (iOS only).\n * This should be called after showing your purchase UI for a promoted product.\n *\n * @returns Promise resolving when the purchase is initiated\n * @throws Error if called on non-iOS platform or no promoted product is available\n *\n * @platform iOS\n */\nexport const requestPurchaseOnPromotedProductIOS = (): Promise<void> => {\n  return ExpoIapModule.requestPurchaseOnPromotedProductIOS();\n};\n\n/**\n * Get pending transactions that haven't been finished yet (iOS only).\n *\n * @returns Promise resolving to array of pending transactions\n * @platform iOS\n */\nexport const getPendingTransactionsIOS = (): Promise<any[]> => {\n  return ExpoIapModule.getPendingTransactionsIOS();\n};\n\n/**\n * Clear a specific transaction (iOS only).\n *\n * @returns Promise resolving when transaction is cleared\n * @platform iOS\n */\nexport const clearTransactionIOS = (): Promise<void> => {\n  return ExpoIapModule.clearTransactionIOS();\n};\n\n/**\n * Deep link to subscriptions screen on iOS.\n * @returns {Promise<void>}\n *\n * @platform iOS\n */\nexport const deepLinkToSubscriptionsIOS = (): Promise<void> =>\n  Linking.openURL('https://apps.apple.com/account/subscriptions');\n\n// iOS-specific APIs only; cross-platform wrappers live in src/index.ts\n"]}
+{"version":3,"file":"ios.js","sourceRoot":"","sources":["../../src/modules/ios.ts"],"names":[],"mappings":"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","sourcesContent":["// External dependencies\n\n// Internal modules\n// import removed: use purchaseUpdatedListener directly in app code\nimport ExpoIapModule from '../ExpoIapModule';\n\n// Types\nimport type {\n  MutationField,\n  ProductIOS,\n  Purchase,\n  PurchaseIOS,\n  QueryField,\n  ReceiptValidationProps,\n  ReceiptValidationResultIOS,\n  SubscriptionStatusIOS,\n} from '../types';\nimport type {PurchaseError} from '../utils/errorMapping';\nimport {Linking, Platform} from 'react-native';\n\nexport type TransactionEvent = {\n  transaction?: Purchase;\n  error?: PurchaseError;\n};\n\n// Listeners\n\n// Type guards\nexport function isProductIOS<T extends {platform?: string}>(\n  item: unknown,\n): item is T & {platform: 'ios'} {\n  return (\n    item != null &&\n    typeof item === 'object' &&\n    'platform' in item &&\n    typeof (item as any).platform === 'string' &&\n    (item as any).platform.toLowerCase() === 'ios'\n  );\n}\n\n// Functions\n/**\n * Sync state with Appstore (iOS only)\n * https://developer.apple.com/documentation/storekit/appstore/3791906-sync\n *\n * @returns Promise resolving to null on success\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const syncIOS: MutationField<'syncIOS'> = async () => {\n  return Boolean(await ExpoIapModule.syncIOS());\n};\n\n/**\n * Check if user is eligible for introductory offer\n *\n * @param groupId The subscription group ID\n * @returns Promise resolving to true if eligible\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const isEligibleForIntroOfferIOS: QueryField<\n  'isEligibleForIntroOfferIOS'\n> = async (groupID) => {\n  if (!groupID) {\n    throw new Error('isEligibleForIntroOfferIOS requires a groupID');\n  }\n  return ExpoIapModule.isEligibleForIntroOfferIOS(groupID);\n};\n\n/**\n * Get subscription status for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to array of subscription status\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const subscriptionStatusIOS: QueryField<\n  'subscriptionStatusIOS'\n> = async (sku) => {\n  if (!sku) {\n    throw new Error('subscriptionStatusIOS requires a SKU');\n  }\n  const status = await ExpoIapModule.subscriptionStatusIOS(sku);\n  return (status ?? []) as SubscriptionStatusIOS[];\n};\n\n/**\n * Get current entitlement for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to current entitlement\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const currentEntitlementIOS: QueryField<\n  'currentEntitlementIOS'\n> = async (sku) => {\n  if (!sku) {\n    throw new Error('currentEntitlementIOS requires a SKU');\n  }\n  const purchase = await ExpoIapModule.currentEntitlementIOS(sku);\n  return (purchase ?? null) as PurchaseIOS | null;\n};\n\n/**\n * Get latest transaction for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to latest transaction\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const latestTransactionIOS: QueryField<'latestTransactionIOS'> = async (\n  sku,\n) => {\n  if (!sku) {\n    throw new Error('latestTransactionIOS requires a SKU');\n  }\n  const transaction = await ExpoIapModule.latestTransactionIOS(sku);\n  return (transaction ?? null) as PurchaseIOS | null;\n};\n\n/**\n * Begin refund request for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to refund request status\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const beginRefundRequestIOS: MutationField<\n  'beginRefundRequestIOS'\n> = async (sku) => {\n  if (!sku) {\n    throw new Error('beginRefundRequestIOS requires a SKU');\n  }\n  const status = await ExpoIapModule.beginRefundRequestIOS(sku);\n  return status ?? null;\n};\n\n/**\n * Shows the system UI for managing subscriptions.\n * Returns an array of subscriptions that had status changes after the UI is closed.\n *\n * @returns Promise<Purchase[]> - Array of subscriptions with status changes (e.g., auto-renewal toggled)\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const showManageSubscriptionsIOS: MutationField<\n  'showManageSubscriptionsIOS'\n> = async () => {\n  const purchases = await ExpoIapModule.showManageSubscriptionsIOS();\n  return (purchases ?? []) as PurchaseIOS[];\n};\n\n/**\n * Get the receipt data from the iOS device.\n * This returns the base64 encoded receipt data which can be sent to your server\n * for verification with Apple's server.\n *\n * NOTE: For proper security, always verify receipts on your server using\n * Apple's verifyReceipt endpoint, not directly from the app.\n *\n * @returns {Promise<string>} Base64 encoded receipt data\n */\nexport const getReceiptDataIOS: QueryField<'getReceiptDataIOS'> = async () => {\n  return ExpoIapModule.getReceiptDataIOS();\n};\n\nexport const getReceiptIOS = getReceiptDataIOS;\n\n/**\n * Retrieves the current storefront information from the iOS App Store.\n *\n * @returns Promise resolving to the storefront country code\n * @throws Error if called on non-iOS platform\n *\n * @example\n * ```typescript\n * const storefront = await getStorefrontIOS();\n * console.log(storefront); // 'US'\n * ```\n *\n * @platform iOS\n */\nexport const getStorefrontIOS: QueryField<'getStorefrontIOS'> = async () => {\n  if (Platform.OS !== 'ios') {\n    console.warn('getStorefrontIOS: This method is only available on iOS');\n    return '';\n  }\n  return ExpoIapModule.getStorefrontIOS();\n};\n\n/**\n * Check if a transaction is verified through StoreKit 2.\n * StoreKit 2 performs local verification of transaction JWS signatures.\n *\n * @param sku The product's SKU (on iOS)\n * @returns Promise resolving to true if the transaction is verified\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const isTransactionVerifiedIOS: QueryField<\n  'isTransactionVerifiedIOS'\n> = async (sku) => {\n  if (!sku) {\n    throw new Error('isTransactionVerifiedIOS requires a SKU');\n  }\n  return ExpoIapModule.isTransactionVerifiedIOS(sku);\n};\n\n/**\n * Get the JWS representation of a purchase for server-side verification.\n * The JWS (JSON Web Signature) can be verified on your server using Apple's public keys.\n *\n * @param sku The product's SKU (on iOS)\n * @returns Promise resolving to JWS representation of the transaction\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const getTransactionJwsIOS: QueryField<'getTransactionJwsIOS'> = async (\n  sku,\n) => {\n  if (!sku) {\n    throw new Error('getTransactionJwsIOS requires a SKU');\n  }\n  const jws = await ExpoIapModule.getTransactionJwsIOS(sku);\n  return jws ?? '';\n};\n\n/**\n * Validate receipt for iOS using StoreKit 2's built-in verification.\n * Returns receipt data and verification information to help with server-side validation.\n *\n * NOTE: For proper security, Apple recommends verifying receipts on your server using\n * the verifyReceipt endpoint rather than relying solely on client-side verification.\n *\n * @param {string} sku The product's SKU (on iOS)\n * @returns {Promise<{\n *   isValid: boolean;\n *   receiptData: string;\n *   jwsRepresentation: string;\n *   latestTransaction?: Purchase;\n * }>}\n */\nconst validateReceiptIOSImpl = async (\n  props: ReceiptValidationProps | string,\n) => {\n  const sku =\n    typeof props === 'string' ? props : (props as ReceiptValidationProps)?.sku;\n\n  if (!sku) {\n    throw new Error('validateReceiptIOS requires a SKU');\n  }\n\n  return (await ExpoIapModule.validateReceiptIOS(\n    sku,\n  )) as ReceiptValidationResultIOS;\n};\n\nexport const validateReceiptIOS =\n  validateReceiptIOSImpl as QueryField<'validateReceiptIOS'>;\n\n/**\n * Present the code redemption sheet for offer codes (iOS only).\n * This allows users to redeem promotional codes for in-app purchases and subscriptions.\n *\n * Note: This only works on real devices, not simulators.\n *\n * @returns Promise resolving to true if the sheet was presented successfully\n * @throws Error if called on non-iOS platform or tvOS\n *\n * @platform iOS\n */\nexport const presentCodeRedemptionSheetIOS: MutationField<\n  'presentCodeRedemptionSheetIOS'\n> = async () => {\n  return Boolean(await ExpoIapModule.presentCodeRedemptionSheetIOS());\n};\n\n/**\n * Get app transaction information (iOS 16.0+).\n * AppTransaction represents the initial purchase that unlocked the app.\n *\n * NOTE: This function requires:\n * - iOS 16.0 or later at runtime\n * - Xcode 15.0+ with iOS 16.0 SDK for compilation\n *\n * @returns Promise resolving to the app transaction information or null if not available\n * @throws Error if called on non-iOS platform, iOS version < 16.0, or compiled with older SDK\n *\n * @platform iOS\n * @since iOS 16.0\n */\nexport const getAppTransactionIOS: QueryField<\n  'getAppTransactionIOS'\n> = async () => {\n  return (await ExpoIapModule.getAppTransactionIOS()) ?? null;\n};\n\n/**\n * Get information about a promoted product if one is available (iOS only).\n * Promoted products are products that the App Store promotes on your behalf.\n * This is called after a promoted product event is received from the App Store.\n *\n * @returns Promise resolving to the promoted product information or null if none available\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const getPromotedProductIOS: QueryField<\n  'getPromotedProductIOS'\n> = async () => {\n  const product = await ExpoIapModule.getPromotedProductIOS();\n  return (product ?? null) as ProductIOS | null;\n};\n\n/**\n * Complete the purchase of a promoted product (iOS only).\n * This should be called after showing your purchase UI for a promoted product.\n *\n * @returns Promise resolving when the purchase is initiated\n * @throws Error if called on non-iOS platform or no promoted product is available\n *\n * @platform iOS\n */\nexport const requestPurchaseOnPromotedProductIOS: MutationField<\n  'requestPurchaseOnPromotedProductIOS'\n> = async () => {\n  await ExpoIapModule.requestPurchaseOnPromotedProductIOS();\n  return true;\n};\n\n/**\n * Get pending transactions that haven't been finished yet (iOS only).\n *\n * @returns Promise resolving to array of pending transactions\n * @platform iOS\n */\nexport const getPendingTransactionsIOS: QueryField<\n  'getPendingTransactionsIOS'\n> = async () => {\n  const transactions = await ExpoIapModule.getPendingTransactionsIOS();\n  return (transactions ?? []) as PurchaseIOS[];\n};\n\n/**\n * Clear a specific transaction (iOS only).\n *\n * @returns Promise resolving when transaction is cleared\n * @platform iOS\n */\nexport const clearTransactionIOS: MutationField<\n  'clearTransactionIOS'\n> = async () => {\n  return Boolean(await ExpoIapModule.clearTransactionIOS());\n};\n\n/**\n * Deep link to subscriptions screen on iOS.\n * @returns {Promise<void>}\n *\n * @platform iOS\n */\nexport const deepLinkToSubscriptionsIOS = (): Promise<void> =>\n  Linking.openURL('https://apps.apple.com/account/subscriptions');\n\n// iOS-specific APIs only; cross-platform wrappers live in src/index.ts\n"]}

package/build/types.d.ts

@@ -112,66 +112,59 @@ export declare enum ErrorCode {
     UserCancelled = "USER_CANCELLED",
     UserError = "USER_ERROR"
 }
-export interface FetchProductsResult {
-    products?: (Product[] | null);
-    subscriptions?: (ProductSubscription[] | null);
-}
-export type IapEvent = 'promoted-product-ios' | 'purchase-error' | 'purchase-updated';
-export type IapPlatform = 'android' | 'ios';
+export type FetchProductsResult = Product[] | ProductSubscription[] | null;
+export type IapEvent = 'purchase-updated' | 'purchase-error' | 'promoted-product-ios';
+export type IapPlatform = 'ios' | 'android';
 export interface Mutation {
     /** Acknowledge a non-consumable purchase or subscription */
-    acknowledgePurchaseAndroid: Promise<VoidResult>;
+    acknowledgePurchaseAndroid: Promise<boolean>;
     /** Initiate a refund request for a product (iOS 15+) */
-    beginRefundRequestIOS: Promise<RefundResultIOS>;
+    beginRefundRequestIOS?: Promise<(string | null)>;
     /** Clear pending transactions from the StoreKit payment queue */
-    clearTransactionIOS: Promise<VoidResult>;
+    clearTransactionIOS: Promise<boolean>;
     /** Consume a purchase token so it can be repurchased */
-    consumePurchaseAndroid: Promise<VoidResult>;
+    consumePurchaseAndroid: Promise<boolean>;
     /** Open the native subscription management surface */
-    deepLinkToSubscriptions: Promise<VoidResult>;
+    deepLinkToSubscriptions: Promise<void>;
     /** Close the platform billing connection */
     endConnection: Promise<boolean>;
     /** Finish a transaction after validating receipts */
-    finishTransaction: Promise<VoidResult>;
+    finishTransaction: Promise<void>;
     /** Establish the platform billing connection */
     initConnection: Promise<boolean>;
     /** Present the App Store code redemption sheet */
-    presentCodeRedemptionSheetIOS: Promise<VoidResult>;
+    presentCodeRedemptionSheetIOS: Promise<boolean>;
     /** Initiate a purchase flow; rely on events for final state */
-    requestPurchase?: Promise<(RequestPurchaseResult | null)>;
+    requestPurchase?: Promise<(Purchase | Purchase[] | null)>;
     /** Purchase the promoted product surfaced by the App Store */
-    requestPurchaseOnPromotedProductIOS: Promise<PurchaseIOS>;
+    requestPurchaseOnPromotedProductIOS: Promise<boolean>;
     /** Restore completed purchases across platforms */
-    restorePurchases: Promise<VoidResult>;
+    restorePurchases: Promise<void>;
     /** Open subscription management UI and return changed purchases (iOS 15+) */
     showManageSubscriptionsIOS: Promise<PurchaseIOS[]>;
     /** Force a StoreKit sync for transactions (iOS 15+) */
-    syncIOS: Promise<VoidResult>;
+    syncIOS: Promise<boolean>;
     /** Validate purchase receipts with the configured providers */
     validateReceipt: Promise<ReceiptValidationResult>;
 }
-export interface MutationAcknowledgePurchaseAndroidArgs {
-    purchaseToken: string;
-}
-export interface MutationBeginRefundRequestIosArgs {
-    sku: string;
-}
-export interface MutationConsumePurchaseAndroidArgs {
-    purchaseToken: string;
-}
-export interface MutationDeepLinkToSubscriptionsArgs {
-    options?: (DeepLinkOptions | null);
-}
+export type MutationAcknowledgePurchaseAndroidArgs = string;
+export type MutationBeginRefundRequestIosArgs = string;
+export type MutationConsumePurchaseAndroidArgs = string;
+export type MutationDeepLinkToSubscriptionsArgs = (DeepLinkOptions | null) | undefined;
 export interface MutationFinishTransactionArgs {
     isConsumable?: (boolean | null);
     purchase: PurchaseInput;
 }
-export interface MutationRequestPurchaseArgs {
-    params: RequestPurchaseProps;
-}
-export interface MutationValidateReceiptArgs {
-    options: ReceiptValidationProps;
-}
+export type MutationRequestPurchaseArgs = {
+    /** Per-platform purchase request props */
+    request: RequestPurchasePropsByPlatforms;
+    type: 'in-app';
+} | {
+    /** Per-platform subscription request props */
+    request: RequestSubscriptionPropsByPlatforms;
+    type: 'subs';
+};
+export type MutationValidateReceiptArgs = ReceiptValidationProps;
 export type PaymentModeIOS = 'empty' | 'free-trial' | 'pay-as-you-go' | 'pay-up-front';
 export interface PricingPhaseAndroid {
     billingCycleCount: number;
@@ -234,7 +227,7 @@ export interface ProductIOS extends ProductCommon {
     type: ProductType;
     typeIOS: ProductTypeIOS;
 }
-export type ProductQueryType = 'all' | 'in-app' | 'subs';
+export type ProductQueryType = 'in-app' | 'subs' | 'all';
 export interface ProductRequest {
     skus: string[];
     type?: (ProductQueryType | null);
@@ -288,7 +281,7 @@ export interface ProductSubscriptionIOS extends ProductCommon {
     typeIOS: ProductTypeIOS;
 }
 export type ProductType = 'in-app' | 'subs';
-export type ProductTypeIOS = 'auto-renewable-subscription' | 'consumable' | 'non-consumable' | 'non-renewing-subscription';
+export type ProductTypeIOS = 'consumable' | 'non-consumable' | 'auto-renewable-subscription' | 'non-renewing-subscription';
 export type Purchase = PurchaseAndroid | PurchaseIOS;
 export interface PurchaseAndroid extends PurchaseCommon {
     autoRenewingAndroid?: (boolean | null);
@@ -308,6 +301,7 @@ export interface PurchaseAndroid extends PurchaseCommon {
     quantity: number;
     signatureAndroid?: (string | null);
     transactionDate: number;
+    transactionId?: (string | null);
 }
 export interface PurchaseCommon {
     id: string;
@@ -355,6 +349,7 @@ export interface PurchaseIOS extends PurchaseCommon {
     storefrontCountryCodeIOS?: (string | null);
     subscriptionGroupIdIOS?: (string | null);
     transactionDate: number;
+    transactionId: string;
     transactionReasonIOS?: (string | null);
     webOrderLineItemIdIOS?: (string | null);
 }
@@ -380,12 +375,12 @@ export interface PurchaseOptions {
     /** Limit to currently active items on iOS */
     onlyIncludeActiveItemsIOS?: (boolean | null);
 }
-export type PurchaseState = 'deferred' | 'failed' | 'pending' | 'purchased' | 'restored' | 'unknown';
+export type PurchaseState = 'pending' | 'purchased' | 'failed' | 'restored' | 'deferred' | 'unknown';
 export interface Query {
     /** Get current StoreKit 2 entitlements (iOS 15+) */
-    currentEntitlementIOS: Promise<EntitlementIOS[]>;
+    currentEntitlementIOS?: Promise<(PurchaseIOS | null)>;
     /** Retrieve products or subscriptions from the store */
-    fetchProducts: Promise<FetchProductsResult>;
+    fetchProducts: Promise<(Product[] | ProductSubscription[] | null)>;
     /** Get active subscriptions (filters by subscriptionIds when provided) */
     getActiveSubscriptions: Promise<ActiveSubscription[]>;
     /** Fetch the current app transaction (iOS 16+) */
@@ -397,14 +392,14 @@ export interface Query {
     /** Get the currently promoted product (iOS 11+) */
     getPromotedProductIOS?: Promise<(ProductIOS | null)>;
     /** Get base64-encoded receipt data for validation */
-    getReceiptDataIOS: Promise<string>;
+    getReceiptDataIOS?: Promise<(string | null)>;
     /** Get the current App Store storefront country code */
     getStorefrontIOS: Promise<string>;
     /** Get the transaction JWS (StoreKit 2) */
-    getTransactionJwsIOS: Promise<string>;
+    getTransactionJwsIOS?: Promise<(string | null)>;
     /** Check whether the user has active subscriptions */
     hasActiveSubscriptions: Promise<boolean>;
-    /** Check introductory offer eligibility for specific products */
+    /** Check introductory offer eligibility for a subscription group */
     isEligibleForIntroOfferIOS: Promise<boolean>;
     /** Verify a StoreKit 2 transaction signature */
     isTransactionVerifiedIOS: Promise<boolean>;
@@ -412,37 +407,20 @@ export interface Query {
     latestTransactionIOS?: Promise<(PurchaseIOS | null)>;
     /** Get StoreKit 2 subscription status details (iOS 15+) */
     subscriptionStatusIOS: Promise<SubscriptionStatusIOS[]>;
-}
-export interface QueryCurrentEntitlementIosArgs {
-    skus?: (string[] | null);
-}
-export interface QueryFetchProductsArgs {
-    params: ProductRequest;
-}
-export interface QueryGetActiveSubscriptionsArgs {
-    subscriptionIds?: (string[] | null);
-}
-export interface QueryGetAvailablePurchasesArgs {
-    options?: (PurchaseOptions | null);
-}
-export interface QueryGetTransactionJwsIosArgs {
-    transactionId: string;
-}
-export interface QueryHasActiveSubscriptionsArgs {
-    subscriptionIds?: (string[] | null);
-}
-export interface QueryIsEligibleForIntroOfferIosArgs {
-    productIds: string[];
-}
-export interface QueryIsTransactionVerifiedIosArgs {
-    transactionId: string;
-}
-export interface QueryLatestTransactionIosArgs {
-    sku: string;
-}
-export interface QuerySubscriptionStatusIosArgs {
-    skus?: (string[] | null);
-}
+    /** Validate a receipt for a specific product */
+    validateReceiptIOS: Promise<ReceiptValidationResultIOS>;
+}
+export type QueryCurrentEntitlementIosArgs = string;
+export type QueryFetchProductsArgs = ProductRequest;
+export type QueryGetActiveSubscriptionsArgs = (string[] | null) | undefined;
+export type QueryGetAvailablePurchasesArgs = (PurchaseOptions | null) | undefined;
+export type QueryGetTransactionJwsIosArgs = string;
+export type QueryHasActiveSubscriptionsArgs = (string[] | null) | undefined;
+export type QueryIsEligibleForIntroOfferIosArgs = string;
+export type QueryIsTransactionVerifiedIosArgs = string;
+export type QueryLatestTransactionIosArgs = string;
+export type QuerySubscriptionStatusIosArgs = string;
+export type QueryValidateReceiptIosArgs = ReceiptValidationProps;
 export interface ReceiptValidationAndroidOptions {
     accessToken: string;
     isSub?: (boolean | null);
@@ -532,10 +510,7 @@ export interface RequestPurchasePropsByPlatforms {
     /** iOS-specific purchase parameters */
     ios?: (RequestPurchaseIosProps | null);
 }
-export interface RequestPurchaseResult {
-    purchase?: (Purchase | null);
-    purchases?: (Purchase[] | null);
-}
+export type RequestPurchaseResult = Purchase | Purchase[] | null;
 export interface RequestSubscriptionAndroidProps {
     /** Personalized offer flag */
     isOfferPersonalized?: (boolean | null);
@@ -589,7 +564,7 @@ export interface SubscriptionOfferIOS {
     type: SubscriptionOfferTypeIOS;
 }
 export type SubscriptionOfferTypeIOS = 'introductory' | 'promotional';
-export type SubscriptionPeriodIOS = 'day' | 'empty' | 'month' | 'week' | 'year';
+export type SubscriptionPeriodIOS = 'day' | 'week' | 'month' | 'year' | 'empty';
 export interface SubscriptionPeriodValueIOS {
     unit: SubscriptionPeriodIOS;
     value: number;
@@ -598,7 +573,57 @@ export interface SubscriptionStatusIOS {
     renewalInfo?: (RenewalInfoIOS | null);
     state: string;
 }
-export interface VoidResult {
-    success: boolean;
-}
+export type VoidResult = void;
+export type QueryArgsMap = {
+    currentEntitlementIOS: QueryCurrentEntitlementIosArgs;
+    fetchProducts: QueryFetchProductsArgs;
+    getActiveSubscriptions: QueryGetActiveSubscriptionsArgs;
+    getAppTransactionIOS: never;
+    getAvailablePurchases: QueryGetAvailablePurchasesArgs;
+    getPendingTransactionsIOS: never;
+    getPromotedProductIOS: never;
+    getReceiptDataIOS: never;
+    getStorefrontIOS: never;
+    getTransactionJwsIOS: QueryGetTransactionJwsIosArgs;
+    hasActiveSubscriptions: QueryHasActiveSubscriptionsArgs;
+    isEligibleForIntroOfferIOS: QueryIsEligibleForIntroOfferIosArgs;
+    isTransactionVerifiedIOS: QueryIsTransactionVerifiedIosArgs;
+    latestTransactionIOS: QueryLatestTransactionIosArgs;
+    subscriptionStatusIOS: QuerySubscriptionStatusIosArgs;
+    validateReceiptIOS: QueryValidateReceiptIosArgs;
+};
+export type QueryField<K extends keyof Query> = QueryArgsMap[K] extends never ? () => NonNullable<Query[K]> : undefined extends QueryArgsMap[K] ? (args?: QueryArgsMap[K]) => NonNullable<Query[K]> : (args: QueryArgsMap[K]) => NonNullable<Query[K]>;
+export type QueryFieldMap = {
+    [K in keyof Query]?: QueryField<K>;
+};
+export type MutationArgsMap = {
+    acknowledgePurchaseAndroid: MutationAcknowledgePurchaseAndroidArgs;
+    beginRefundRequestIOS: MutationBeginRefundRequestIosArgs;
+    clearTransactionIOS: never;
+    consumePurchaseAndroid: MutationConsumePurchaseAndroidArgs;
+    deepLinkToSubscriptions: MutationDeepLinkToSubscriptionsArgs;
+    endConnection: never;
+    finishTransaction: MutationFinishTransactionArgs;
+    initConnection: never;
+    presentCodeRedemptionSheetIOS: never;
+    requestPurchase: MutationRequestPurchaseArgs;
+    requestPurchaseOnPromotedProductIOS: never;
+    restorePurchases: never;
+    showManageSubscriptionsIOS: never;
+    syncIOS: never;
+    validateReceipt: MutationValidateReceiptArgs;
+};
+export type MutationField<K extends keyof Mutation> = MutationArgsMap[K] extends never ? () => NonNullable<Mutation[K]> : undefined extends MutationArgsMap[K] ? (args?: MutationArgsMap[K]) => NonNullable<Mutation[K]> : (args: MutationArgsMap[K]) => NonNullable<Mutation[K]>;
+export type MutationFieldMap = {
+    [K in keyof Mutation]?: MutationField<K>;
+};
+export type SubscriptionArgsMap = {
+    promotedProductIOS: never;
+    purchaseError: never;
+    purchaseUpdated: never;
+};
+export type SubscriptionField<K extends keyof Subscription> = SubscriptionArgsMap[K] extends never ? () => NonNullable<Subscription[K]> : undefined extends SubscriptionArgsMap[K] ? (args?: SubscriptionArgsMap[K]) => NonNullable<Subscription[K]> : (args: SubscriptionArgsMap[K]) => NonNullable<Subscription[K]>;
+export type SubscriptionFieldMap = {
+    [K in keyof Subscription]?: SubscriptionField<K>;
+};
 //# sourceMappingURL=types.d.ts.map