expo-iap 4.2.2 → 4.2.4

package/build/modules/android.js

@@ -77,11 +77,36 @@ export const validateReceiptAndroid = async ({ packageName, productId, productTo
     }
     return response.json();
 };
+/**
+ * Consume a purchase token so the user can purchase the same product again
+ * (Android consumable products). Prefer using `finishTransaction` with
+ * `isConsumable: true`, which dispatches to this under the hood.
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/android/consume-purchase-android}
+ */
+export const consumePurchaseAndroid = async (purchaseToken) => {
+    const result = await ExpoIapModule.consumePurchaseAndroid(purchaseToken);
+    if (typeof result === 'boolean') {
+        return result;
+    }
+    if (result && typeof result === 'object') {
+        const record = result;
+        if (typeof record.success === 'boolean') {
+            return record.success;
+        }
+        if (typeof record.responseCode === 'number') {
+            return record.responseCode === 0;
+        }
+    }
+    throw new Error(`consumePurchaseAndroid returned an unexpected response payload: ${JSON.stringify(result)}`);
+};
 /**
  * Acknowledge a product (on Android.) No-op on iOS.
  * @param {Object} params - The parameters object
  * @param {string} params.token - The product's token (on Android)
  * @returns {Promise<VoidResult | void>}
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/android/acknowledge-purchase-android}
  */
 export const acknowledgePurchaseAndroid = async (purchaseToken) => {
     const result = await ExpoIapModule.acknowledgePurchaseAndroid(purchaseToken);
@@ -125,6 +150,8 @@ export const openRedeemOfferCodeAndroid = async () => {
  *   // Proceed with alternative billing flow
  * }
  * ```
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/android/check-alternative-billing-availability-android}
  */
 export const checkAlternativeBillingAvailabilityAndroid = async () => {
     return ExpoIapModule.checkAlternativeBillingAvailabilityAndroid();
@@ -152,6 +179,8 @@ export const checkAlternativeBillingAvailabilityAndroid = async () => {
  *   }
  * }
  * ```
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/android/show-alternative-billing-dialog-android}
  */
 export const showAlternativeBillingDialogAndroid = async () => {
     return ExpoIapModule.showAlternativeBillingDialogAndroid();
@@ -179,6 +208,8 @@ export const showAlternativeBillingDialogAndroid = async () => {
  *   });
  * }
  * ```
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/android/create-alternative-billing-token-android}
  */
 export const createAlternativeBillingTokenAndroid = async (sku) => {
     return ExpoIapModule.createAlternativeBillingTokenAndroid(sku);
@@ -200,6 +231,8 @@ export const createAlternativeBillingTokenAndroid = async (sku) => {
  *   // Proceed with billing program flow
  * }
  * ```
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/android/is-billing-program-available-android}
  */
 export const isBillingProgramAvailableAndroid = async (program) => {
     return ExpoIapModule.isBillingProgramAvailableAndroid(program);
@@ -220,6 +253,8 @@ export const isBillingProgramAvailableAndroid = async (program) => {
  *   linkUri: 'https://your-payment-site.com',
  * });
  * ```
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/android/launch-external-link-android}
  */
 export const launchExternalLinkAndroid = async (params) => {
     return ExpoIapModule.launchExternalLinkAndroid(params);
@@ -240,6 +275,8 @@ export const launchExternalLinkAndroid = async (params) => {
  * // Report details.externalTransactionToken to Google Play within 24 hours
  * await reportToGooglePlay(details.externalTransactionToken);
  * ```
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/android/create-billing-program-reporting-details-android}
  */
 export const createBillingProgramReportingDetailsAndroid = async (program) => {
     return ExpoIapModule.createBillingProgramReportingDetailsAndroid(program);

package/build/modules/android.js.map

@@ -1 +1 @@
-{"version":3,"file":"android.js","sourceRoot":"","sources":["../../src/modules/android.ts"],"names":[],"mappings":"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","sourcesContent":["// External dependencies\nimport {Linking} from 'react-native';\n\n// Internal modules\nimport ExpoIapModule from '../ExpoIapModule';\n\n// Types\nimport type {\n  DeepLinkOptions,\n  MutationField,\n  VerifyPurchaseResultAndroid,\n} from '../types';\n\ntype NativeAndroidModule = {\n  deepLinkToSubscriptionsAndroid?: (params: {\n    skuAndroid?: string;\n    packageNameAndroid?: string;\n  }) => Promise<void> | void;\n  getStorefront?: () => Promise<string> | string;\n};\n\nconst nativeAndroidModule = ExpoIapModule as NativeAndroidModule;\n\n// Type guards\nexport function isProductAndroid<T extends {platform?: string}>(\n  item: unknown,\n): item is T & {platform: 'android'} {\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() === 'android'\n  );\n}\n\n/**\n * Deep link to subscriptions screen on Android.\n * @param {Object} params - The parameters object\n * @param {string} params.skuAndroid - The product's SKU (on Android)\n * @param {string} params.packageNameAndroid - The package name of your Android app (e.g., 'com.example.app')\n * @returns {Promise<void>}\n *\n * @example\n * ```typescript\n * await deepLinkToSubscriptionsAndroid({\n *   skuAndroid: 'subscription_id',\n *   packageNameAndroid: 'com.example.app'\n * });\n * ```\n */\nexport const deepLinkToSubscriptionsAndroid = async (\n  options?: DeepLinkOptions | null,\n): Promise<void> => {\n  const sku = options?.skuAndroid ?? undefined;\n  const packageName = options?.packageNameAndroid ?? undefined;\n\n  // Prefer native deep link implementation via OpenIAP module\n  if (nativeAndroidModule?.deepLinkToSubscriptionsAndroid) {\n    return nativeAndroidModule.deepLinkToSubscriptionsAndroid({\n      skuAndroid: sku,\n      packageNameAndroid: packageName,\n    });\n  }\n\n  // Fallback to Linking if native method unavailable\n  if (!packageName) {\n    throw new Error(\n      'packageName is required for deepLinkToSubscriptionsAndroid',\n    );\n  }\n  const base = `https://play.google.com/store/account/subscriptions?package=${encodeURIComponent(\n    packageName,\n  )}`;\n  const url = sku ? `${base}&sku=${encodeURIComponent(sku)}` : base;\n  return Linking.openURL(url);\n};\n\n/**\n * Validate receipt for Android. NOTE: This method is here for debugging purposes only. Including\n * your access token in the binary you ship to users is potentially dangerous.\n * Use server side validation instead for your production builds\n *\n * @deprecated Use verifyPurchase instead\n * @param {Object} params - The parameters object\n * @param {string} params.packageName - package name of your app.\n * @param {string} params.productId - product id for your in app product.\n * @param {string} params.productToken - token for your purchase (called 'token' in the API documentation).\n * @param {string} params.accessToken - OAuth access token with androidpublisher scope. Required for authentication.\n * @param {boolean} params.isSub - whether this is subscription or in-app. `true` for subscription.\n * @returns {Promise<ReceiptAndroid>}\n */\nexport const validateReceiptAndroid = async ({\n  packageName,\n  productId,\n  productToken,\n  accessToken,\n  isSub,\n}: {\n  packageName: string;\n  productId: string;\n  productToken: string;\n  accessToken: string;\n  isSub?: boolean;\n}): Promise<VerifyPurchaseResultAndroid> => {\n  const type = isSub ? 'subscriptions' : 'products';\n\n  const url =\n    'https://androidpublisher.googleapis.com/androidpublisher/v3/applications' +\n    `/${packageName}/purchases/${type}/${productId}` +\n    `/tokens/${productToken}`;\n\n  const response = await fetch(url, {\n    method: 'GET',\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${accessToken}`,\n    },\n  });\n\n  if (!response.ok) {\n    throw Object.assign(new Error(response.statusText), {\n      statusCode: response.status,\n    });\n  }\n\n  return response.json();\n};\n\n/**\n * Acknowledge a product (on Android.) No-op on iOS.\n * @param {Object} params - The parameters object\n * @param {string} params.token - The product's token (on Android)\n * @returns {Promise<VoidResult | void>}\n */\nexport const acknowledgePurchaseAndroid: MutationField<\n  'acknowledgePurchaseAndroid'\n> = async (purchaseToken) => {\n  const result = await ExpoIapModule.acknowledgePurchaseAndroid(purchaseToken);\n\n  if (typeof result === 'boolean') {\n    return result;\n  }\n\n  if (result && typeof result === 'object') {\n    const record = result as Record<string, unknown>;\n    if (typeof record.success === 'boolean') {\n      return record.success;\n    }\n    if (typeof record.responseCode === 'number') {\n      return record.responseCode === 0;\n    }\n  }\n\n  return true;\n};\n\n/**\n * Open the Google Play Store to redeem offer codes (Android only).\n * Note: Google Play does not provide a direct API to redeem codes within the app.\n * This function opens the Play Store where users can manually enter their codes.\n *\n * @returns {Promise<void>}\n */\nexport const openRedeemOfferCodeAndroid = async (): Promise<void> => {\n  return Linking.openURL(`https://play.google.com/redeem?code=`);\n};\n\n/**\n * Check if alternative billing is available for this user/device (Android only).\n * Step 1 of alternative billing flow.\n *\n * Returns true if available, false otherwise.\n * Throws OpenIapError.NotPrepared if billing client not ready.\n *\n * @returns {Promise<boolean>}\n *\n * @example\n * ```typescript\n * const isAvailable = await checkAlternativeBillingAvailabilityAndroid();\n * if (isAvailable) {\n *   // Proceed with alternative billing flow\n * }\n * ```\n */\nexport const checkAlternativeBillingAvailabilityAndroid: MutationField<\n  'checkAlternativeBillingAvailabilityAndroid'\n> = async () => {\n  return ExpoIapModule.checkAlternativeBillingAvailabilityAndroid();\n};\n\n/**\n * Show alternative billing information dialog to user (Android only).\n * Step 2 of alternative billing flow.\n * Must be called BEFORE processing payment in your payment system.\n *\n * Returns true if user accepted, false if user canceled.\n * Throws OpenIapError.NotPrepared if billing client not ready.\n *\n * @returns {Promise<boolean>}\n *\n * @example\n * ```typescript\n * const userAccepted = await showAlternativeBillingDialogAndroid();\n * if (userAccepted) {\n *   // Process payment in your payment system\n *   const success = await processCustomPayment();\n *   if (success) {\n *     // Create reporting token\n *     const token = await createAlternativeBillingTokenAndroid();\n *     // Send token to your backend for Google Play reporting\n *   }\n * }\n * ```\n */\nexport const showAlternativeBillingDialogAndroid: MutationField<\n  'showAlternativeBillingDialogAndroid'\n> = async () => {\n  return ExpoIapModule.showAlternativeBillingDialogAndroid();\n};\n\n/**\n * Create external transaction token for Google Play reporting (Android only).\n * Step 3 of alternative billing flow.\n * Must be called AFTER successful payment in your payment system.\n * Token must be reported to Google Play backend within 24 hours.\n *\n * Returns token string, or null if creation failed.\n * Throws OpenIapError.NotPrepared if billing client not ready.\n *\n * @param {string} sku - The product SKU that was purchased\n * @returns {Promise<string | null>}\n *\n * @example\n * ```typescript\n * const token = await createAlternativeBillingTokenAndroid('premium_subscription');\n * if (token) {\n *   // Send token to your backend\n *   await fetch('/api/report-transaction', {\n *     method: 'POST',\n *     body: JSON.stringify({ token, sku: 'premium_subscription' })\n *   });\n * }\n * ```\n */\nexport const createAlternativeBillingTokenAndroid: MutationField<\n  'createAlternativeBillingTokenAndroid'\n> = async (sku?: string) => {\n  return ExpoIapModule.createAlternativeBillingTokenAndroid(sku);\n};\n\n// ============================================================================\n// Billing Programs API (Google Play Billing Library 8.2.0+)\n// ============================================================================\n\n/**\n * Check if a specific billing program is available for this user/device (Android only).\n * Available in Google Play Billing Library 8.2.0+.\n *\n * @param program - The billing program to check ('external-offer' or 'external-content-link')\n * @returns Promise resolving to availability result\n *\n * @example\n * ```typescript\n * const result = await isBillingProgramAvailableAndroid('external-offer');\n * if (result.isAvailable) {\n *   // Proceed with billing program flow\n * }\n * ```\n */\nexport const isBillingProgramAvailableAndroid: MutationField<\n  'isBillingProgramAvailableAndroid'\n> = async (program) => {\n  return ExpoIapModule.isBillingProgramAvailableAndroid(program);\n};\n\n/**\n * Launch an external link for the specified billing program (Android only).\n * Available in Google Play Billing Library 8.2.0+.\n *\n * @param params - The external link parameters\n * @returns Promise resolving to true if the link was launched successfully\n *\n * @example\n * ```typescript\n * await launchExternalLinkAndroid({\n *   billingProgram: 'external-offer',\n *   launchMode: 'launch-in-external-browser-or-app',\n *   linkType: 'link-to-digital-content-offer',\n *   linkUri: 'https://your-payment-site.com',\n * });\n * ```\n */\nexport const launchExternalLinkAndroid: MutationField<\n  'launchExternalLinkAndroid'\n> = async (params) => {\n  return ExpoIapModule.launchExternalLinkAndroid(params);\n};\n\n/**\n * Create billing program reporting details for Google Play reporting (Android only).\n * Available in Google Play Billing Library 8.2.0+.\n *\n * Must be called AFTER successful payment in your payment system.\n * Token must be reported to Google Play backend within 24 hours.\n *\n * @param program - The billing program type\n * @returns Promise resolving to reporting details including the external transaction token\n *\n * @example\n * ```typescript\n * const details = await createBillingProgramReportingDetailsAndroid('external-offer');\n * // Report details.externalTransactionToken to Google Play within 24 hours\n * await reportToGooglePlay(details.externalTransactionToken);\n * ```\n */\nexport const createBillingProgramReportingDetailsAndroid: MutationField<\n  'createBillingProgramReportingDetailsAndroid'\n> = async (program) => {\n  return ExpoIapModule.createBillingProgramReportingDetailsAndroid(program);\n};\n"]}
+{"version":3,"file":"android.js","sourceRoot":"","sources":["../../src/modules/android.ts"],"names":[],"mappings":"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","sourcesContent":["// External dependencies\nimport {Linking} from 'react-native';\n\n// Internal modules\nimport ExpoIapModule from '../ExpoIapModule';\n\n// Types\nimport type {\n  DeepLinkOptions,\n  MutationField,\n  VerifyPurchaseResultAndroid,\n} from '../types';\n\ntype NativeAndroidModule = {\n  deepLinkToSubscriptionsAndroid?: (params: {\n    skuAndroid?: string;\n    packageNameAndroid?: string;\n  }) => Promise<void> | void;\n  getStorefront?: () => Promise<string> | string;\n};\n\nconst nativeAndroidModule = ExpoIapModule as NativeAndroidModule;\n\n// Type guards\nexport function isProductAndroid<T extends {platform?: string}>(\n  item: unknown,\n): item is T & {platform: 'android'} {\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() === 'android'\n  );\n}\n\n/**\n * Deep link to subscriptions screen on Android.\n * @param {Object} params - The parameters object\n * @param {string} params.skuAndroid - The product's SKU (on Android)\n * @param {string} params.packageNameAndroid - The package name of your Android app (e.g., 'com.example.app')\n * @returns {Promise<void>}\n *\n * @example\n * ```typescript\n * await deepLinkToSubscriptionsAndroid({\n *   skuAndroid: 'subscription_id',\n *   packageNameAndroid: 'com.example.app'\n * });\n * ```\n */\nexport const deepLinkToSubscriptionsAndroid = async (\n  options?: DeepLinkOptions | null,\n): Promise<void> => {\n  const sku = options?.skuAndroid ?? undefined;\n  const packageName = options?.packageNameAndroid ?? undefined;\n\n  // Prefer native deep link implementation via OpenIAP module\n  if (nativeAndroidModule?.deepLinkToSubscriptionsAndroid) {\n    return nativeAndroidModule.deepLinkToSubscriptionsAndroid({\n      skuAndroid: sku,\n      packageNameAndroid: packageName,\n    });\n  }\n\n  // Fallback to Linking if native method unavailable\n  if (!packageName) {\n    throw new Error(\n      'packageName is required for deepLinkToSubscriptionsAndroid',\n    );\n  }\n  const base = `https://play.google.com/store/account/subscriptions?package=${encodeURIComponent(\n    packageName,\n  )}`;\n  const url = sku ? `${base}&sku=${encodeURIComponent(sku)}` : base;\n  return Linking.openURL(url);\n};\n\n/**\n * Validate receipt for Android. NOTE: This method is here for debugging purposes only. Including\n * your access token in the binary you ship to users is potentially dangerous.\n * Use server side validation instead for your production builds\n *\n * @deprecated Use verifyPurchase instead\n * @param {Object} params - The parameters object\n * @param {string} params.packageName - package name of your app.\n * @param {string} params.productId - product id for your in app product.\n * @param {string} params.productToken - token for your purchase (called 'token' in the API documentation).\n * @param {string} params.accessToken - OAuth access token with androidpublisher scope. Required for authentication.\n * @param {boolean} params.isSub - whether this is subscription or in-app. `true` for subscription.\n * @returns {Promise<ReceiptAndroid>}\n */\nexport const validateReceiptAndroid = async ({\n  packageName,\n  productId,\n  productToken,\n  accessToken,\n  isSub,\n}: {\n  packageName: string;\n  productId: string;\n  productToken: string;\n  accessToken: string;\n  isSub?: boolean;\n}): Promise<VerifyPurchaseResultAndroid> => {\n  const type = isSub ? 'subscriptions' : 'products';\n\n  const url =\n    'https://androidpublisher.googleapis.com/androidpublisher/v3/applications' +\n    `/${packageName}/purchases/${type}/${productId}` +\n    `/tokens/${productToken}`;\n\n  const response = await fetch(url, {\n    method: 'GET',\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${accessToken}`,\n    },\n  });\n\n  if (!response.ok) {\n    throw Object.assign(new Error(response.statusText), {\n      statusCode: response.status,\n    });\n  }\n\n  return response.json();\n};\n\n/**\n * Consume a purchase token so the user can purchase the same product again\n * (Android consumable products). Prefer using `finishTransaction` with\n * `isConsumable: true`, which dispatches to this under the hood.\n *\n * @see {@link https://www.openiap.dev/docs/apis/android/consume-purchase-android}\n */\nexport const consumePurchaseAndroid: MutationField<\n  'consumePurchaseAndroid'\n> = async (purchaseToken) => {\n  const result = await ExpoIapModule.consumePurchaseAndroid(purchaseToken);\n\n  if (typeof result === 'boolean') {\n    return result;\n  }\n\n  if (result && typeof result === 'object') {\n    const record = result as Record<string, unknown>;\n    if (typeof record.success === 'boolean') {\n      return record.success;\n    }\n    if (typeof record.responseCode === 'number') {\n      return record.responseCode === 0;\n    }\n  }\n\n  throw new Error(\n    `consumePurchaseAndroid returned an unexpected response payload: ${JSON.stringify(\n      result,\n    )}`,\n  );\n};\n\n/**\n * Acknowledge a product (on Android.) No-op on iOS.\n * @param {Object} params - The parameters object\n * @param {string} params.token - The product's token (on Android)\n * @returns {Promise<VoidResult | void>}\n *\n * @see {@link https://www.openiap.dev/docs/apis/android/acknowledge-purchase-android}\n */\nexport const acknowledgePurchaseAndroid: MutationField<\n  'acknowledgePurchaseAndroid'\n> = async (purchaseToken) => {\n  const result = await ExpoIapModule.acknowledgePurchaseAndroid(purchaseToken);\n\n  if (typeof result === 'boolean') {\n    return result;\n  }\n\n  if (result && typeof result === 'object') {\n    const record = result as Record<string, unknown>;\n    if (typeof record.success === 'boolean') {\n      return record.success;\n    }\n    if (typeof record.responseCode === 'number') {\n      return record.responseCode === 0;\n    }\n  }\n\n  return true;\n};\n\n/**\n * Open the Google Play Store to redeem offer codes (Android only).\n * Note: Google Play does not provide a direct API to redeem codes within the app.\n * This function opens the Play Store where users can manually enter their codes.\n *\n * @returns {Promise<void>}\n */\nexport const openRedeemOfferCodeAndroid = async (): Promise<void> => {\n  return Linking.openURL(`https://play.google.com/redeem?code=`);\n};\n\n/**\n * Check if alternative billing is available for this user/device (Android only).\n * Step 1 of alternative billing flow.\n *\n * Returns true if available, false otherwise.\n * Throws OpenIapError.NotPrepared if billing client not ready.\n *\n * @returns {Promise<boolean>}\n *\n * @example\n * ```typescript\n * const isAvailable = await checkAlternativeBillingAvailabilityAndroid();\n * if (isAvailable) {\n *   // Proceed with alternative billing flow\n * }\n * ```\n *\n * @see {@link https://www.openiap.dev/docs/apis/android/check-alternative-billing-availability-android}\n */\nexport const checkAlternativeBillingAvailabilityAndroid: MutationField<\n  'checkAlternativeBillingAvailabilityAndroid'\n> = async () => {\n  return ExpoIapModule.checkAlternativeBillingAvailabilityAndroid();\n};\n\n/**\n * Show alternative billing information dialog to user (Android only).\n * Step 2 of alternative billing flow.\n * Must be called BEFORE processing payment in your payment system.\n *\n * Returns true if user accepted, false if user canceled.\n * Throws OpenIapError.NotPrepared if billing client not ready.\n *\n * @returns {Promise<boolean>}\n *\n * @example\n * ```typescript\n * const userAccepted = await showAlternativeBillingDialogAndroid();\n * if (userAccepted) {\n *   // Process payment in your payment system\n *   const success = await processCustomPayment();\n *   if (success) {\n *     // Create reporting token\n *     const token = await createAlternativeBillingTokenAndroid();\n *     // Send token to your backend for Google Play reporting\n *   }\n * }\n * ```\n *\n * @see {@link https://www.openiap.dev/docs/apis/android/show-alternative-billing-dialog-android}\n */\nexport const showAlternativeBillingDialogAndroid: MutationField<\n  'showAlternativeBillingDialogAndroid'\n> = async () => {\n  return ExpoIapModule.showAlternativeBillingDialogAndroid();\n};\n\n/**\n * Create external transaction token for Google Play reporting (Android only).\n * Step 3 of alternative billing flow.\n * Must be called AFTER successful payment in your payment system.\n * Token must be reported to Google Play backend within 24 hours.\n *\n * Returns token string, or null if creation failed.\n * Throws OpenIapError.NotPrepared if billing client not ready.\n *\n * @param {string} sku - The product SKU that was purchased\n * @returns {Promise<string | null>}\n *\n * @example\n * ```typescript\n * const token = await createAlternativeBillingTokenAndroid('premium_subscription');\n * if (token) {\n *   // Send token to your backend\n *   await fetch('/api/report-transaction', {\n *     method: 'POST',\n *     body: JSON.stringify({ token, sku: 'premium_subscription' })\n *   });\n * }\n * ```\n *\n * @see {@link https://www.openiap.dev/docs/apis/android/create-alternative-billing-token-android}\n */\nexport const createAlternativeBillingTokenAndroid: MutationField<\n  'createAlternativeBillingTokenAndroid'\n> = async (sku?: string) => {\n  return ExpoIapModule.createAlternativeBillingTokenAndroid(sku);\n};\n\n// ============================================================================\n// Billing Programs API (Google Play Billing Library 8.2.0+)\n// ============================================================================\n\n/**\n * Check if a specific billing program is available for this user/device (Android only).\n * Available in Google Play Billing Library 8.2.0+.\n *\n * @param program - The billing program to check ('external-offer' or 'external-content-link')\n * @returns Promise resolving to availability result\n *\n * @example\n * ```typescript\n * const result = await isBillingProgramAvailableAndroid('external-offer');\n * if (result.isAvailable) {\n *   // Proceed with billing program flow\n * }\n * ```\n *\n * @see {@link https://www.openiap.dev/docs/apis/android/is-billing-program-available-android}\n */\nexport const isBillingProgramAvailableAndroid: MutationField<\n  'isBillingProgramAvailableAndroid'\n> = async (program) => {\n  return ExpoIapModule.isBillingProgramAvailableAndroid(program);\n};\n\n/**\n * Launch an external link for the specified billing program (Android only).\n * Available in Google Play Billing Library 8.2.0+.\n *\n * @param params - The external link parameters\n * @returns Promise resolving to true if the link was launched successfully\n *\n * @example\n * ```typescript\n * await launchExternalLinkAndroid({\n *   billingProgram: 'external-offer',\n *   launchMode: 'launch-in-external-browser-or-app',\n *   linkType: 'link-to-digital-content-offer',\n *   linkUri: 'https://your-payment-site.com',\n * });\n * ```\n *\n * @see {@link https://www.openiap.dev/docs/apis/android/launch-external-link-android}\n */\nexport const launchExternalLinkAndroid: MutationField<\n  'launchExternalLinkAndroid'\n> = async (params) => {\n  return ExpoIapModule.launchExternalLinkAndroid(params);\n};\n\n/**\n * Create billing program reporting details for Google Play reporting (Android only).\n * Available in Google Play Billing Library 8.2.0+.\n *\n * Must be called AFTER successful payment in your payment system.\n * Token must be reported to Google Play backend within 24 hours.\n *\n * @param program - The billing program type\n * @returns Promise resolving to reporting details including the external transaction token\n *\n * @example\n * ```typescript\n * const details = await createBillingProgramReportingDetailsAndroid('external-offer');\n * // Report details.externalTransactionToken to Google Play within 24 hours\n * await reportToGooglePlay(details.externalTransactionToken);\n * ```\n *\n * @see {@link https://www.openiap.dev/docs/apis/android/create-billing-program-reporting-details-android}\n */\nexport const createBillingProgramReportingDetailsAndroid: MutationField<\n  'createBillingProgramReportingDetailsAndroid'\n> = async (program) => {\n  return ExpoIapModule.createBillingProgramReportingDetailsAndroid(program);\n};\n"]}

package/build/modules/ios.d.ts

@@ -17,6 +17,8 @@ export declare function isProductIOS<T extends {
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/sync-ios}
  */
 export declare const syncIOS: MutationField<'syncIOS'>;
 /**
@@ -27,6 +29,8 @@ export declare const syncIOS: MutationField<'syncIOS'>;
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/is-eligible-for-intro-offer-ios}
  */
 export declare const isEligibleForIntroOfferIOS: QueryField<'isEligibleForIntroOfferIOS'>;
 /**
@@ -37,6 +41,8 @@ export declare const isEligibleForIntroOfferIOS: QueryField<'isEligibleForIntroO
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/subscription-status-ios}
  */
 export declare const subscriptionStatusIOS: QueryField<'subscriptionStatusIOS'>;
 /**
@@ -47,6 +53,8 @@ export declare const subscriptionStatusIOS: QueryField<'subscriptionStatusIOS'>;
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/current-entitlement-ios}
  */
 export declare const currentEntitlementIOS: QueryField<'currentEntitlementIOS'>;
 /**
@@ -57,6 +65,8 @@ export declare const currentEntitlementIOS: QueryField<'currentEntitlementIOS'>;
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/latest-transaction-ios}
  */
 export declare const latestTransactionIOS: QueryField<'latestTransactionIOS'>;
 /**
@@ -67,6 +77,8 @@ export declare const latestTransactionIOS: QueryField<'latestTransactionIOS'>;
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/begin-refund-request-ios}
  */
 export declare const beginRefundRequestIOS: MutationField<'beginRefundRequestIOS'>;
 /**
@@ -77,6 +89,8 @@ export declare const beginRefundRequestIOS: MutationField<'beginRefundRequestIOS
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/show-manage-subscriptions-ios}
  */
 export declare const showManageSubscriptionsIOS: MutationField<'showManageSubscriptionsIOS'>;
 /**
@@ -88,9 +102,26 @@ export declare const showManageSubscriptionsIOS: MutationField<'showManageSubscr
  * Apple's verifyReceipt endpoint, not directly from the app.
  *
  * @returns {Promise<string>} Base64 encoded receipt data
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-receipt-data-ios}
  */
 export declare const getReceiptDataIOS: QueryField<'getReceiptDataIOS'>;
 export declare const getReceiptIOS: () => Promise<string | null>;
+/**
+ * Get the current App Store storefront country code on iOS.
+ *
+ * @deprecated Use cross-platform `getStorefront` from the main index instead.
+ *   The native module exposes a single `getStorefront` AsyncFunction that already
+ *   resolves to the iOS storefront on iOS. This helper is kept as an iOS-only
+ *   alias so consumers who previously imported `getStorefrontIOS` do not break.
+ *
+ * @returns {Promise<string>} ISO 3166-1 alpha-2 country code (e.g. "US")
+ *
+ * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-storefront-ios}
+ */
+export declare const getStorefrontIOS: QueryField<'getStorefrontIOS'>;
 /**
  * Refresh the receipt data from Apple's servers and return the updated receipt.
  * This calls AppStore.sync() before reading the receipt, ensuring the latest
@@ -112,6 +143,8 @@ export declare const requestReceiptRefreshIOS: () => Promise<string>;
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/is-transaction-verified-ios}
  */
 export declare const isTransactionVerifiedIOS: QueryField<'isTransactionVerifiedIOS'>;
 /**
@@ -123,6 +156,8 @@ export declare const isTransactionVerifiedIOS: QueryField<'isTransactionVerified
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-transaction-jws-ios}
  */
 export declare const getTransactionJwsIOS: QueryField<'getTransactionJwsIOS'>;
 export declare const validateReceiptIOS: QueryField<"validateReceiptIOS">;
@@ -136,6 +171,8 @@ export declare const validateReceiptIOS: QueryField<"validateReceiptIOS">;
  * @throws Error if called on non-iOS platform or tvOS
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/present-code-redemption-sheet-ios}
  */
 export declare const presentCodeRedemptionSheetIOS: MutationField<'presentCodeRedemptionSheetIOS'>;
 /**
@@ -151,6 +188,8 @@ export declare const presentCodeRedemptionSheetIOS: MutationField<'presentCodeRe
  *
  * @platform iOS
  * @since iOS 16.0
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-app-transaction-ios}
  */
 export declare const getAppTransactionIOS: QueryField<'getAppTransactionIOS'>;
 /**
@@ -162,6 +201,8 @@ export declare const getAppTransactionIOS: QueryField<'getAppTransactionIOS'>;
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-promoted-product-ios}
  */
 export declare const getPromotedProductIOS: QueryField<'getPromotedProductIOS'>;
 /**
@@ -175,6 +216,8 @@ export declare const getPromotedProductIOS: QueryField<'getPromotedProductIOS'>;
  * @throws Error if called on non-iOS platform or no promoted product is available
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/request-purchase-on-promoted-product-ios}
  */
 export declare const requestPurchaseOnPromotedProductIOS: () => Promise<boolean>;
 /**
@@ -182,14 +225,23 @@ export declare const requestPurchaseOnPromotedProductIOS: () => Promise<boolean>
  *
  * @returns Promise resolving to array of pending transactions
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-pending-transactions-ios}
  */
 export declare const getPendingTransactionsIOS: QueryField<'getPendingTransactionsIOS'>;
+/**
+ * List every StoreKit transaction (finished + unfinished) for the current user.
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-all-transactions-ios}
+ */
 export declare const getAllTransactionsIOS: QueryField<'getAllTransactionsIOS'>;
 /**
  * Clear a specific transaction (iOS only).
  *
  * @returns Promise resolving when transaction is cleared
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/clear-transaction-ios}
  */
 export declare const clearTransactionIOS: MutationField<'clearTransactionIOS'>;
 /**
@@ -200,10 +252,16 @@ export declare const clearTransactionIOS: MutationField<'clearTransactionIOS'>;
  */
 export declare const deepLinkToSubscriptionsIOS: () => Promise<void>;
 /**
- * Check if the device can present an external purchase notice sheet (iOS 18.2+).
+ * Check if the device can present an external purchase notice sheet (iOS 17.4+).
+ *
+ * Wraps `ExternalPurchase.canPresent`, which Apple introduced in iOS 17.4.
+ * Note: the notice sheet itself (`presentExternalPurchaseNoticeSheetIOS`)
+ * still requires iOS 18.2+; only the eligibility check is available earlier.
  *
  * @returns Promise resolving to true if the notice sheet can be presented
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/can-present-external-purchase-notice-ios}
  */
 export declare const canPresentExternalPurchaseNoticeIOS: QueryField<'canPresentExternalPurchaseNoticeIOS'>;
 /**
@@ -213,6 +271,8 @@ export declare const canPresentExternalPurchaseNoticeIOS: QueryField<'canPresent
  *
  * @returns Promise resolving to the result with action, token, and error if any
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/present-external-purchase-notice-sheet-ios}
  */
 export declare const presentExternalPurchaseNoticeSheetIOS: () => Promise<ExternalPurchaseNoticeResultIOS>;
 /**
@@ -221,6 +281,8 @@ export declare const presentExternalPurchaseNoticeSheetIOS: () => Promise<Extern
  * @param url - The external purchase URL to open
  * @returns Promise resolving to the result with success status and error if any
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/present-external-purchase-link-ios}
  */
 export declare const presentExternalPurchaseLinkIOS: MutationField<'presentExternalPurchaseLinkIOS'>;
 /**
@@ -230,6 +292,8 @@ export declare const presentExternalPurchaseLinkIOS: MutationField<'presentExter
  * @returns Promise resolving to true if eligible
  * @platform iOS
  * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/iseligible
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/is-eligible-for-external-purchase-custom-link-ios}
  */
 export declare const isEligibleForExternalPurchaseCustomLinkIOS: () => Promise<boolean>;
 /**
@@ -240,6 +304,8 @@ export declare const isEligibleForExternalPurchaseCustomLinkIOS: () => Promise<b
  * @returns Promise resolving to the token result with token string or error
  * @platform iOS
  * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/token(for:)
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-external-purchase-custom-link-token-ios}
  */
 export declare const getExternalPurchaseCustomLinkTokenIOS: (tokenType: ExternalPurchaseCustomLinkTokenTypeIOS) => Promise<ExternalPurchaseCustomLinkTokenResultIOS>;
 /**
@@ -251,6 +317,8 @@ export declare const getExternalPurchaseCustomLinkTokenIOS: (tokenType: External
  * @returns Promise resolving to the result with continued status and error if any
  * @platform iOS
  * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/shownotice(type:)
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/show-external-purchase-custom-link-notice-ios}
  */
 export declare const showExternalPurchaseCustomLinkNoticeIOS: (noticeType: ExternalPurchaseCustomLinkNoticeTypeIOS) => Promise<ExternalPurchaseCustomLinkNoticeResultIOS>;
 //# sourceMappingURL=ios.d.ts.map

package/build/modules/ios.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ios.d.ts","sourceRoot":"","sources":["../../src/modules/ios.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ios.d.ts","sourceRoot":"","sources":["../../src/modules/ios.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,yCAAyC,EACzC,wCAAwC,EACxC,sCAAsC,EACtC,uCAAuC,EAEvC,+BAA+B,EAC/B,aAAa,EAEb,QAAQ,EAER,UAAU,EAIX,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAC;AAGzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAKF,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAC,EACxD,IAAI,EAAE,OAAO,GACZ,IAAI,IAAI,CAAC,GAAG;IAAC,QAAQ,EAAE,KAAK,CAAA;CAAC,CAQ/B;AAGD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,EAAE,aAAa,CAAC,SAAS,CAE5C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,EAAE,UAAU,CACjD,4BAA4B,CAM7B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAE,UAAU,CAC5C,uBAAuB,CAOxB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAE,UAAU,CAC5C,uBAAuB,CAOxB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAAU,CAAC,sBAAsB,CAQnE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,uBAAuB,CAOxB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,EAAE,aAAa,CACpD,4BAA4B,CAI7B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAAU,CAAC,mBAAmB,CAE7D,CAAC;AAEF,eAAO,MAAM,aAAa,8BAAoB,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAU,CAAC,kBAAkB,CAE3D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,QAAa,OAAO,CAAC,MAAM,CAE/D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,EAAE,UAAU,CAC/C,0BAA0B,CAM3B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAAU,CAAC,sBAAsB,CAQnE,CAAC;AAmCF,eAAO,MAAM,kBAAkB,EACH,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAE7D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,6BAA6B,EAAE,aAAa,CACvD,+BAA+B,CAGhC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAAU,CAC3C,sBAAsB,CAGvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,UAAU,CAC5C,uBAAuB,CAIxB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mCAAmC,QACpC,OAAO,CAAC,OAAO,CAGxB,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,EAAE,UAAU,CAChD,2BAA2B,CAI5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,UAAU,CAC5C,uBAAuB,CAIxB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAC7C,qBAAqB,CAGtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAO,OAAO,CAAC,IAAI,CACO,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mCAAmC,EAAE,UAAU,CAC1D,qCAAqC,CAGtC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,qCAAqC,QACtC,OAAO,CAAC,+BAA+B,CAGhD,CAAC;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,EAAE,aAAa,CACxD,gCAAgC,CAIjC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,0CAA0C,QAC3C,OAAO,CAAC,OAAO,CAExB,CAAC;AAEJ;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qCAAqC,GAChD,WAAW,sCAAsC,KAChD,OAAO,CAAC,wCAAwC,CAUlD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uCAAuC,GAClD,YAAY,uCAAuC,KAClD,OAAO,CAAC,yCAAyC,CAUnD,CAAC"}

package/build/modules/ios.js

@@ -21,6 +21,8 @@ export function isProductIOS(item) {
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/sync-ios}
  */
 export const syncIOS = async () => {
     return !!(await ExpoIapModule.syncIOS());
@@ -33,6 +35,8 @@ export const syncIOS = async () => {
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/is-eligible-for-intro-offer-ios}
  */
 export const isEligibleForIntroOfferIOS = async (groupId) => {
     if (!groupId) {
@@ -48,6 +52,8 @@ export const isEligibleForIntroOfferIOS = async (groupId) => {
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/subscription-status-ios}
  */
 export const subscriptionStatusIOS = async (sku) => {
     if (!sku) {
@@ -64,6 +70,8 @@ export const subscriptionStatusIOS = async (sku) => {
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/current-entitlement-ios}
  */
 export const currentEntitlementIOS = async (sku) => {
     if (!sku) {
@@ -80,6 +88,8 @@ export const currentEntitlementIOS = async (sku) => {
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/latest-transaction-ios}
  */
 export const latestTransactionIOS = async (sku) => {
     if (!sku) {
@@ -96,6 +106,8 @@ export const latestTransactionIOS = async (sku) => {
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/begin-refund-request-ios}
  */
 export const beginRefundRequestIOS = async (sku) => {
     if (!sku) {
@@ -112,6 +124,8 @@ export const beginRefundRequestIOS = async (sku) => {
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/show-manage-subscriptions-ios}
  */
 export const showManageSubscriptionsIOS = async () => {
     const purchases = await ExpoIapModule.showManageSubscriptionsIOS();
@@ -126,11 +140,30 @@ export const showManageSubscriptionsIOS = async () => {
  * Apple's verifyReceipt endpoint, not directly from the app.
  *
  * @returns {Promise<string>} Base64 encoded receipt data
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-receipt-data-ios}
  */
 export const getReceiptDataIOS = async () => {
     return ExpoIapModule.getReceiptDataIOS();
 };
 export const getReceiptIOS = getReceiptDataIOS;
+/**
+ * Get the current App Store storefront country code on iOS.
+ *
+ * @deprecated Use cross-platform `getStorefront` from the main index instead.
+ *   The native module exposes a single `getStorefront` AsyncFunction that already
+ *   resolves to the iOS storefront on iOS. This helper is kept as an iOS-only
+ *   alias so consumers who previously imported `getStorefrontIOS` do not break.
+ *
+ * @returns {Promise<string>} ISO 3166-1 alpha-2 country code (e.g. "US")
+ *
+ * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-storefront-ios}
+ */
+export const getStorefrontIOS = async () => {
+    return ExpoIapModule.getStorefront();
+};
 /**
  * Refresh the receipt data from Apple's servers and return the updated receipt.
  * This calls AppStore.sync() before reading the receipt, ensuring the latest
@@ -154,6 +187,8 @@ export const requestReceiptRefreshIOS = async () => {
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/is-transaction-verified-ios}
  */
 export const isTransactionVerifiedIOS = async (sku) => {
     if (!sku) {
@@ -170,6 +205,8 @@ export const isTransactionVerifiedIOS = async (sku) => {
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-transaction-jws-ios}
  */
 export const getTransactionJwsIOS = async (sku) => {
     if (!sku) {
@@ -193,6 +230,8 @@ export const getTransactionJwsIOS = async (sku) => {
  *   jwsRepresentation: string;
  *   latestTransaction?: Purchase;
  * }>}
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/validate-receipt-ios}
  */
 const validateReceiptIOSImpl = async (props) => {
     const sku = typeof props === 'string'
@@ -214,6 +253,8 @@ export const validateReceiptIOS = validateReceiptIOSImpl;
  * @throws Error if called on non-iOS platform or tvOS
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/present-code-redemption-sheet-ios}
  */
 export const presentCodeRedemptionSheetIOS = async () => {
     return !!(await ExpoIapModule.presentCodeRedemptionSheetIOS());
@@ -231,6 +272,8 @@ export const presentCodeRedemptionSheetIOS = async () => {
  *
  * @platform iOS
  * @since iOS 16.0
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-app-transaction-ios}
  */
 export const getAppTransactionIOS = async () => {
     return (await ExpoIapModule.getAppTransactionIOS()) ?? null;
@@ -244,6 +287,8 @@ export const getAppTransactionIOS = async () => {
  * @throws Error if called on non-iOS platform
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-promoted-product-ios}
  */
 export const getPromotedProductIOS = async () => {
     const product = await ExpoIapModule.getPromotedProductIOS();
@@ -260,6 +305,8 @@ export const getPromotedProductIOS = async () => {
  * @throws Error if called on non-iOS platform or no promoted product is available
  *
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/request-purchase-on-promoted-product-ios}
  */
 export const requestPurchaseOnPromotedProductIOS = async () => {
     const result = await ExpoIapModule.requestPurchaseOnPromotedProductIOS();
@@ -270,11 +317,18 @@ export const requestPurchaseOnPromotedProductIOS = async () => {
  *
  * @returns Promise resolving to array of pending transactions
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-pending-transactions-ios}
  */
 export const getPendingTransactionsIOS = async () => {
     const transactions = await ExpoIapModule.getPendingTransactionsIOS();
     return (transactions ?? []);
 };
+/**
+ * List every StoreKit transaction (finished + unfinished) for the current user.
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-all-transactions-ios}
+ */
 export const getAllTransactionsIOS = async () => {
     const transactions = await ExpoIapModule.getAllTransactionsIOS();
     return (transactions ?? []);
@@ -284,6 +338,8 @@ export const getAllTransactionsIOS = async () => {
  *
  * @returns Promise resolving when transaction is cleared
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/clear-transaction-ios}
  */
 export const clearTransactionIOS = async () => {
     return !!(await ExpoIapModule.clearTransactionIOS());
@@ -296,10 +352,16 @@ export const clearTransactionIOS = async () => {
  */
 export const deepLinkToSubscriptionsIOS = () => Linking.openURL('https://apps.apple.com/account/subscriptions');
 /**
- * Check if the device can present an external purchase notice sheet (iOS 18.2+).
+ * Check if the device can present an external purchase notice sheet (iOS 17.4+).
+ *
+ * Wraps `ExternalPurchase.canPresent`, which Apple introduced in iOS 17.4.
+ * Note: the notice sheet itself (`presentExternalPurchaseNoticeSheetIOS`)
+ * still requires iOS 18.2+; only the eligibility check is available earlier.
  *
  * @returns Promise resolving to true if the notice sheet can be presented
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/can-present-external-purchase-notice-ios}
  */
 export const canPresentExternalPurchaseNoticeIOS = async () => {
     return !!(await ExpoIapModule.canPresentExternalPurchaseNoticeIOS());
@@ -311,6 +373,8 @@ export const canPresentExternalPurchaseNoticeIOS = async () => {
  *
  * @returns Promise resolving to the result with action, token, and error if any
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/present-external-purchase-notice-sheet-ios}
  */
 export const presentExternalPurchaseNoticeSheetIOS = async () => {
     const result = await ExpoIapModule.presentExternalPurchaseNoticeSheetIOS();
@@ -322,6 +386,8 @@ export const presentExternalPurchaseNoticeSheetIOS = async () => {
  * @param url - The external purchase URL to open
  * @returns Promise resolving to the result with success status and error if any
  * @platform iOS
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/present-external-purchase-link-ios}
  */
 export const presentExternalPurchaseLinkIOS = async (url) => {
     const result = await ExpoIapModule.presentExternalPurchaseLinkIOS(url);
@@ -334,6 +400,8 @@ export const presentExternalPurchaseLinkIOS = async (url) => {
  * @returns Promise resolving to true if eligible
  * @platform iOS
  * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/iseligible
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/is-eligible-for-external-purchase-custom-link-ios}
  */
 export const isEligibleForExternalPurchaseCustomLinkIOS = async () => {
     return !!(await ExpoIapModule.isEligibleForExternalPurchaseCustomLinkIOS());
@@ -346,6 +414,8 @@ export const isEligibleForExternalPurchaseCustomLinkIOS = async () => {
  * @returns Promise resolving to the token result with token string or error
  * @platform iOS
  * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/token(for:)
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/get-external-purchase-custom-link-token-ios}
  */
 export const getExternalPurchaseCustomLinkTokenIOS = async (tokenType) => {
     if (!tokenType) {
@@ -363,6 +433,8 @@ export const getExternalPurchaseCustomLinkTokenIOS = async (tokenType) => {
  * @returns Promise resolving to the result with continued status and error if any
  * @platform iOS
  * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/shownotice(type:)
+ *
+ * @see {@link https://www.openiap.dev/docs/apis/ios/show-external-purchase-custom-link-notice-ios}
  */
 export const showExternalPurchaseCustomLinkNoticeIOS = async (noticeType) => {
     if (!noticeType) {