react-native-iap 15.2.4 → 15.3.1

package/lib/module/index.js

@@ -28,13 +28,14 @@ import { parseAppTransactionPayload } from "./utils.js";
 
 export * from "./types.js";
 export * from "./utils/error.js";
-const LEGACY_INAPP_WARNING = "[react-native-iap] `type: 'inapp'` is deprecated and will be removed in v14.4.0. Use 'in-app' instead.";
+const LEGACY_INAPP_WARNING = "[react-native-iap] `type: 'inapp'` is deprecated and will be removed in a future major version. Use 'in-app' instead.";
 const toErrorMessage = error => {
   if (typeof error === 'object' && error !== null && 'message' in error && error.message != null) {
     return String(error.message);
   }
   return String(error ?? '');
 };
+const unsupportedPlatformError = () => new Error(`Unsupported platform: ${Platform.OS}`);
 // ActiveSubscription and PurchaseError types are already exported via 'export * from ./types'
 
 // Export hooks
@@ -330,7 +331,7 @@ export const promotedProductListenerIOS = listener => {
  * const subscription = userChoiceBillingListenerAndroid((details) => {
  *   console.log('User chose alternative billing');
  *   console.log('Products:', details.products);
- *   console.log('Token:', details.externalTransactionToken);
+ *   console.log('External transaction token received; send it to your backend without logging it.');
  *
  *   // Send token to backend for Google Play reporting
  *   await reportToGooglePlay(details.externalTransactionToken);
@@ -397,7 +398,7 @@ export const userChoiceBillingListenerAndroid = listener => {
  * ```typescript
  * const subscription = developerProvidedBillingListenerAndroid((details) => {
  *   console.log('User chose developer billing');
- *   console.log('Token:', details.externalTransactionToken);
+ *   console.log('External transaction token received; send it to your backend without logging it.');
  *
  *   // Process payment through your external payment system
  *   await processExternalPayment();
@@ -548,7 +549,7 @@ export const subscriptionBillingIssueListener = listener => {
  * @remarks This is a regular promise-based call. Don't confuse with `request*` APIs
  *   (`requestPurchase`), which are event-based.
  *
- * @see {@link https://www.openiap.dev/docs/apis/fetch-products}
+ * @see {@link https://openiap.dev/docs/apis/fetch-products}
  */
 export const fetchProducts = async request => {
   const {
@@ -655,7 +656,7 @@ export const fetchProducts = async request => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/get-available-purchases}
+ * @see {@link https://openiap.dev/docs/apis/get-available-purchases}
  */
 export const getAvailablePurchases = async options => {
   const alsoPublishToEventListenerIOS = Boolean(options?.alsoPublishToEventListenerIOS ?? false);
@@ -700,7 +701,7 @@ export const getAvailablePurchases = async options => {
       }
       return validPurchases.map(convertNitroPurchaseToPurchase);
     } else {
-      throw new Error('Unsupported platform');
+      throw unsupportedPlatformError();
     }
   } catch (error) {
     RnIapConsole.error('Failed to get available purchases:', error);
@@ -713,7 +714,7 @@ export const getAvailablePurchases = async options => {
  * @returns Promise<Product | null> - The promoted product or null if none available
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/get-promoted-product-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/get-promoted-product-ios}
  */
 export const getPromotedProductIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -750,7 +751,7 @@ export const requestPromotedProductIOS = getPromotedProductIOS;
  * console.log('User storefront:', storefront); // e.g., 'USA', 'GBR', 'KOR'
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/get-storefront-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/get-storefront-ios}
  */
 export const getStorefrontIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -768,7 +769,7 @@ export const getStorefrontIOS = async () => {
 /**
  * Return the user's storefront country code.
  *
- * @see {@link https://www.openiap.dev/docs/apis/get-storefront}
+ * @see {@link https://openiap.dev/docs/apis/get-storefront}
  */
 export const getStorefront = async () => {
   if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
@@ -811,7 +812,7 @@ export const getStorefront = async () => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/get-app-transaction-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/get-app-transaction-ios}
  */
 export const getAppTransactionIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -846,7 +847,7 @@ export const getAppTransactionIOS = async () => {
  * @throws Error when called on non-iOS platforms or when IAP is not initialized
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/subscription-status-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/subscription-status-ios}
  */
 export const subscriptionStatusIOS = async sku => {
   if (Platform.OS !== 'ios') {
@@ -874,7 +875,7 @@ export const subscriptionStatusIOS = async sku => {
  * @returns Promise<Purchase | null> - Current entitlement or null
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/current-entitlement-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/current-entitlement-ios}
  */
 export const currentEntitlementIOS = async sku => {
   if (Platform.OS !== 'ios') {
@@ -905,7 +906,7 @@ export const currentEntitlementIOS = async sku => {
  * @returns Promise<Purchase | null> - Latest transaction or null
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/latest-transaction-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/latest-transaction-ios}
  */
 export const latestTransactionIOS = async sku => {
   if (Platform.OS !== 'ios') {
@@ -935,7 +936,7 @@ export const latestTransactionIOS = async sku => {
  * @returns Promise<Purchase[]> - Array of pending transactions
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/get-pending-transactions-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/get-pending-transactions-ios}
  */
 export const getPendingTransactionsIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -959,7 +960,7 @@ export const getPendingTransactionsIOS = async () => {
 /**
  * List every StoreKit transaction (finished + unfinished) for the current user.
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/get-all-transactions-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/get-all-transactions-ios}
  */
 export const getAllTransactionsIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -985,7 +986,7 @@ export const getAllTransactionsIOS = async () => {
  * @returns Promise<Purchase[]> - Subscriptions where auto-renewal status changed
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/show-manage-subscriptions-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/show-manage-subscriptions-ios}
  */
 export const showManageSubscriptionsIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -1012,7 +1013,7 @@ export const showManageSubscriptionsIOS = async () => {
  * @returns Promise<boolean> - Eligibility status
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/is-eligible-for-intro-offer-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/is-eligible-for-intro-offer-ios}
  */
 export const isEligibleForIntroOfferIOS = async groupID => {
   if (Platform.OS !== 'ios') {
@@ -1037,7 +1038,7 @@ export const isEligibleForIntroOfferIOS = async groupID => {
  * @returns Promise<string> - Base64 encoded receipt data
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/get-receipt-data-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/get-receipt-data-ios}
  */
 export const getReceiptDataIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -1106,7 +1107,7 @@ export const requestReceiptRefreshIOS = async () => {
  * @returns Promise<boolean> - Verification status
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/is-transaction-verified-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/is-transaction-verified-ios}
  */
 export const isTransactionVerifiedIOS = async sku => {
   if (Platform.OS !== 'ios') {
@@ -1132,7 +1133,7 @@ export const isTransactionVerifiedIOS = async sku => {
  * @returns Promise<string | null> - JWS representation or null
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/get-transaction-jws-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/get-transaction-jws-ios}
  */
 export const getTransactionJwsIOS = async sku => {
   if (Platform.OS !== 'ios') {
@@ -1173,7 +1174,7 @@ export const getTransactionJwsIOS = async sku => {
  * @remarks When using `useIAP()`, connection is auto-managed on mount/unmount —
  *   pass options to the hook instead of calling this directly.
  *
- * @see {@link https://www.openiap.dev/docs/apis/init-connection}
+ * @see {@link https://openiap.dev/docs/apis/init-connection}
  */
 export const initConnection = async config => {
   try {
@@ -1193,7 +1194,7 @@ export const initConnection = async config => {
 /**
  * Close the store connection and release resources.
  *
- * @see {@link https://www.openiap.dev/docs/apis/end-connection}
+ * @see {@link https://openiap.dev/docs/apis/end-connection}
  */
 export const endConnection = async () => {
   try {
@@ -1216,7 +1217,7 @@ export const endConnection = async () => {
 /**
  * Restore non-consumable and active subscription purchases.
  *
- * @see {@link https://www.openiap.dev/docs/apis/restore-purchases}
+ * @see {@link https://openiap.dev/docs/apis/restore-purchases}
  */
 export const restorePurchases = async () => {
   try {
@@ -1263,7 +1264,7 @@ export const restorePurchases = async () => {
  * @remarks Event-based. Listen for the result via {@link purchaseUpdatedListener} /
  *   {@link purchaseErrorListener}, or use `useIAP({ onPurchaseSuccess, onPurchaseError })`.
  *
- * @see {@link https://www.openiap.dev/docs/apis/request-purchase}
+ * @see {@link https://openiap.dev/docs/apis/request-purchase}
  */
 export const requestPurchase = async request => {
   try {
@@ -1290,7 +1291,7 @@ export const requestPurchase = async request => {
         throw new Error('Invalid request for Android. The `skus` property is required and must be a non-empty array.');
       }
     } else {
-      throw new Error('Unsupported platform');
+      throw unsupportedPlatformError();
     }
     const unifiedRequest = {};
 
@@ -1317,6 +1318,18 @@ export const requestPurchase = async request => {
       if (iosRequest.advancedCommerceData) {
         iosPayload.advancedCommerceData = iosRequest.advancedCommerceData;
       }
+      if (isSubs) {
+        const subscriptionRequest = iosRequest;
+        if (subscriptionRequest.introductoryOfferEligibility !== undefined) {
+          iosPayload.introductoryOfferEligibility = subscriptionRequest.introductoryOfferEligibility;
+        }
+        if (subscriptionRequest.promotionalOfferJWS) {
+          iosPayload.promotionalOfferJWS = subscriptionRequest.promotionalOfferJWS;
+        }
+        if (subscriptionRequest.winBackOffer) {
+          iosPayload.winBackOffer = subscriptionRequest.winBackOffer;
+        }
+      }
       unifiedRequest.ios = iosPayload;
     }
 
@@ -1398,7 +1411,7 @@ export const requestPurchase = async request => {
  * @remarks **Critical:** Android purchases must be finalized within 3 days or Google
  *   auto-refunds. iOS unfinished transactions replay on every app launch.
  *
- * @see {@link https://www.openiap.dev/docs/apis/finish-transaction}
+ * @see {@link https://openiap.dev/docs/apis/finish-transaction}
  */
 export const finishTransaction = async args => {
   const {
@@ -1428,7 +1441,7 @@ export const finishTransaction = async args => {
         }
       };
     } else {
-      throw new Error('Unsupported platform');
+      throw unsupportedPlatformError();
     }
     const result = await IAP.instance.finishTransaction(params);
     const success = getSuccessFromPurchaseVariant(result, 'finishTransaction');
@@ -1462,7 +1475,7 @@ export const finishTransaction = async args => {
  * await acknowledgePurchaseAndroid('purchase_token_here');
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/android/acknowledge-purchase-android}
+ * @see {@link https://openiap.dev/docs/apis/android/acknowledge-purchase-android}
  */
 export const acknowledgePurchaseAndroid = async purchaseToken => {
   try {
@@ -1498,7 +1511,7 @@ export const acknowledgePurchaseAndroid = async purchaseToken => {
  * await consumePurchaseAndroid('purchase_token_here');
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/android/consume-purchase-android}
+ * @see {@link https://openiap.dev/docs/apis/android/consume-purchase-android}
  */
 export const consumePurchaseAndroid = async purchaseToken => {
   try {
@@ -1552,7 +1565,7 @@ export const consumePurchaseAndroid = async purchaseToken => {
  * });
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/validate-receipt}
+ * @see {@link https://openiap.dev/docs/apis/validate-receipt}
  */
 export const validateReceipt = async options => {
   const {
@@ -1661,7 +1674,7 @@ export const validateReceipt = async options => {
  * @param options - Receipt validation options containing the SKU
  * @returns Promise resolving to receipt validation result
  *
- * @see {@link https://www.openiap.dev/docs/features/validation#verify-purchase}
+ * @see {@link https://openiap.dev/docs/features/validation#verify-purchase}
  */
 export const verifyPurchase = validateReceipt;
 
@@ -1672,7 +1685,7 @@ export const verifyPurchase = validateReceipt;
  * consumers who imported `validateReceiptIOS` — which is still declared on the
  * OpenIAP Query interface — keep working. Throws on non-iOS platforms.
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/validate-receipt-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/validate-receipt-ios}
  */
 export const validateReceiptIOS = async options => {
   if (Platform.OS !== 'ios') {
@@ -1703,7 +1716,7 @@ export const validateReceiptIOS = async options => {
  * });
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/features/validation#verify-purchase-with-provider}
+ * @see {@link https://openiap.dev/docs/features/validation#verify-purchase-with-provider}
  */
 export const verifyPurchaseWithProvider = async options => {
   try {
@@ -1744,7 +1757,7 @@ export const verifyPurchaseWithProvider = async options => {
  * @returns Promise<boolean>
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/sync-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/sync-ios}
  */
 export const syncIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -1770,7 +1783,7 @@ export const syncIOS = async () => {
  * @returns Promise<boolean> - Indicates whether the redemption sheet was presented
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/present-code-redemption-sheet-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/present-code-redemption-sheet-ios}
  */
 export const presentCodeRedemptionSheetIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -1811,7 +1824,7 @@ export const presentCodeRedemptionSheetIOS = async () => {
  * @returns Promise<boolean> - true when the request triggers successfully
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/request-purchase-on-promoted-product-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/request-purchase-on-promoted-product-ios}
  */
 export const requestPurchaseOnPromotedProductIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -1846,7 +1859,7 @@ export const requestPurchaseOnPromotedProductIOS = async () => {
  * @returns Promise<boolean>
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/clear-transaction-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/clear-transaction-ios}
  */
 export const clearTransactionIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -1873,7 +1886,7 @@ export const clearTransactionIOS = async () => {
  * @returns Promise<string | null> - The refund status or null if not available
  * @platform iOS
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/begin-refund-request-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/begin-refund-request-ios}
  */
 export const beginRefundRequestIOS = async sku => {
   if (Platform.OS !== 'ios') {
@@ -1898,7 +1911,7 @@ export const beginRefundRequestIOS = async sku => {
  * Deeplinks to native interface that allows users to manage their subscriptions
  * Cross-platform alias aligning with expo-iap
  *
- * @see {@link https://www.openiap.dev/docs/apis/deep-link-to-subscriptions}
+ * @see {@link https://openiap.dev/docs/apis/deep-link-to-subscriptions}
  */
 export const deepLinkToSubscriptions = async options => {
   const resolvedOptions = options ?? undefined;
@@ -1910,16 +1923,14 @@ export const deepLinkToSubscriptions = async options => {
     return;
   }
   if (Platform.OS === 'ios') {
-    try {
-      if (typeof IAP.instance.deepLinkToSubscriptionsIOS === 'function') {
-        await IAP.instance.deepLinkToSubscriptionsIOS();
-      } else {
-        await IAP.instance.showManageSubscriptionsIOS();
-      }
-    } catch (error) {
-      RnIapConsole.warn('[deepLinkToSubscriptions] Failed on iOS:', error);
+    if (typeof IAP.instance.deepLinkToSubscriptionsIOS === 'function') {
+      await IAP.instance.deepLinkToSubscriptionsIOS();
+    } else {
+      await IAP.instance.showManageSubscriptionsIOS();
     }
+    return;
   }
+  throw unsupportedPlatformError();
 };
 export const deepLinkToSubscriptionsIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -1956,7 +1967,7 @@ export const deepLinkToSubscriptionsIOS = async () => {
  * @param subscriptionIds - Optional array of subscription IDs to filter by
  * @returns Promise<ActiveSubscription[]> - Array of active subscriptions
  *
- * @see {@link https://www.openiap.dev/docs/apis/get-active-subscriptions}
+ * @see {@link https://openiap.dev/docs/apis/get-active-subscriptions}
  */
 export const getActiveSubscriptions = async subscriptionIds => {
   try {
@@ -1977,7 +1988,7 @@ export const getActiveSubscriptions = async subscriptionIds => {
       environmentIOS: sub.environmentIOS ?? null,
       willExpireSoon: sub.willExpireSoon ?? null,
       daysUntilExpirationIOS: sub.daysUntilExpirationIOS ?? null,
-      // 🆕 renewalInfoIOS - subscription lifecycle information (iOS only)
+      // renewalInfoIOS contains subscription lifecycle information on iOS.
       renewalInfoIOS: sub.renewalInfoIOS ? {
         willAutoRenew: sub.renewalInfoIOS.willAutoRenew ?? false,
         autoRenewPreference: sub.renewalInfoIOS.autoRenewPreference ?? null,
@@ -2012,90 +2023,6 @@ export const getActiveSubscriptions = async subscriptionIds => {
   }
 };
 
-// OLD IMPLEMENTATION - REPLACED WITH NATIVE CALL
-/*
-export const getActiveSubscriptions_OLD: QueryField<
-  'getActiveSubscriptions'
-> = async (subscriptionIds) => {
-  try {
-    // Get all available purchases first
-    const allPurchases = await getAvailablePurchases();
-
-    // For the critical bug fix: this function was previously returning ALL purchases
-    // Now we properly filter for subscriptions only
-
-    // In production with real data, Android subscription filtering is done via platform-specific calls
-    // But for backward compatibility and test support, we also check platform-specific fields
-
-    // Since expirationDateIOS and subscriptionGroupIdIOS are not available in NitroPurchase,
-    // we need to rely on other indicators or assume all purchases are subscriptions
-    // when called from getActiveSubscriptions
-    const purchases = allPurchases;
-
-    // Filter for subscriptions and map to ActiveSubscription format
-    const subscriptions = purchases
-      .filter((purchase) => {
-        // Filter by subscription IDs if provided
-        if (subscriptionIds && subscriptionIds.length > 0) {
-          return subscriptionIds.includes(purchase.productId);
-        }
-        return true;
-      })
-      .map((purchase): ActiveSubscription => {
-        // Safe access to platform-specific fields with type guards
-        const expirationDateIOS =
-          'expirationDateIOS' in purchase
-            ? ((purchase as PurchaseIOS).expirationDateIOS ?? null)
-            : null;
-
-        const environmentIOS =
-          'environmentIOS' in purchase
-            ? ((purchase as PurchaseIOS).environmentIOS ?? null)
-            : null;
-
-        const autoRenewingAndroid =
-          'autoRenewingAndroid' in purchase || 'isAutoRenewing' in purchase
-            ? ((purchase as PurchaseAndroid).autoRenewingAndroid ??
-              (purchase as PurchaseAndroid).isAutoRenewing) // deprecated - use isAutoRenewing instead
-            : null;
-
-        // 🆕 Extract renewalInfoIOS if available
-        const renewalInfoIOS =
-          'renewalInfoIOS' in purchase
-            ? ((purchase as PurchaseIOS).renewalInfoIOS ?? null)
-            : null;
-
-        return {
-          productId: purchase.productId,
-          isActive: true, // If it's in availablePurchases, it's active
-          // Backend validation fields - use transactionId ?? id for proper field mapping
-          transactionId: purchase.transactionId ?? purchase.id,
-          purchaseToken: purchase.purchaseToken,
-          transactionDate: purchase.transactionDate,
-          // Platform-specific fields
-          expirationDateIOS,
-          autoRenewingAndroid,
-          environmentIOS,
-          renewalInfoIOS,
-          // Convenience fields
-          willExpireSoon: false, // Would need to calculate based on expiration date
-          daysUntilExpirationIOS:
-            expirationDateIOS != null
-              ? Math.ceil(
-                  (expirationDateIOS - Date.now()) / (1000 * 60 * 60 * 24),
-                )
-              : null,
-        };
-      });
-
-    return subscriptions;
-  } catch (error) {
-    RnIapConsole.error('Failed to get active subscriptions:', error);
-    const errorJson = parseErrorStringToJsonObj(error);
-    throw new Error(errorJson.message);
-  }
-};
-
 /**
  * Check if the user has any active subscriptions (OpenIAP compliant)
  * Returns true if the user has at least one active subscription, false otherwise.
@@ -2104,7 +2031,7 @@ export const getActiveSubscriptions_OLD: QueryField<
  * @param subscriptionIds - Optional array of subscription IDs to check
  * @returns Promise<boolean> - True if there are active subscriptions
  *
- * @see {@link https://www.openiap.dev/docs/apis/has-active-subscriptions}
+ * @see {@link https://openiap.dev/docs/apis/has-active-subscriptions}
  */
 export const hasActiveSubscriptions = async subscriptionIds => {
   try {
@@ -2208,7 +2135,7 @@ const normalizeProductQueryType = type => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/android/check-alternative-billing-availability-android}
+ * @see {@link https://openiap.dev/docs/apis/android/check-alternative-billing-availability-android}
  */
 export const checkAlternativeBillingAvailabilityAndroid = async () => {
   if (Platform.OS !== 'android') {
@@ -2245,7 +2172,7 @@ export const checkAlternativeBillingAvailabilityAndroid = async () => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/android/show-alternative-billing-dialog-android}
+ * @see {@link https://openiap.dev/docs/apis/android/show-alternative-billing-dialog-android}
  */
 export const showAlternativeBillingDialogAndroid = async () => {
   if (Platform.OS !== 'android') {
@@ -2282,7 +2209,7 @@ export const showAlternativeBillingDialogAndroid = async () => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/android/create-alternative-billing-token-android}
+ * @see {@link https://openiap.dev/docs/apis/android/create-alternative-billing-token-android}
  */
 export const createAlternativeBillingTokenAndroid = async sku => {
   if (Platform.OS !== 'android') {
@@ -2296,18 +2223,6 @@ export const createAlternativeBillingTokenAndroid = async sku => {
   }
 };
 
-/**
- * Parameters for launching an external link (Android 8.2.0+).
- */
-
-/**
- * Result of checking billing program availability (Android 8.2.0+).
- */
-
-/**
- * Reporting details for external transactions (Android 8.2.0+).
- */
-
 /**
  * Enable a billing program before initConnection (Android only).
  * Must be called BEFORE initConnection() to configure the BillingClient.
@@ -2351,7 +2266,7 @@ export const enableBillingProgramAndroid = program => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/android/is-billing-program-available-android}
+ * @see {@link https://openiap.dev/docs/apis/android/is-billing-program-available-android}
  */
 export const isBillingProgramAvailableAndroid = async program => {
   if (Platform.OS !== 'android') {
@@ -2388,7 +2303,7 @@ export const isBillingProgramAvailableAndroid = async program => {
  * });
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/android/create-billing-program-reporting-details-android}
+ * @see {@link https://openiap.dev/docs/apis/android/create-billing-program-reporting-details-android}
  */
 export const createBillingProgramReportingDetailsAndroid = async program => {
   if (Platform.OS !== 'android') {
@@ -2427,7 +2342,7 @@ export const createBillingProgramReportingDetailsAndroid = async program => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/android/launch-external-link-android}
+ * @see {@link https://openiap.dev/docs/apis/android/launch-external-link-android}
  */
 export const launchExternalLinkAndroid = async params => {
   if (Platform.OS !== 'android') {
@@ -2469,7 +2384,7 @@ export const launchExternalLinkAndroid = async params => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/can-present-external-purchase-notice-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/can-present-external-purchase-notice-ios}
  */
 export const canPresentExternalPurchaseNoticeIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -2499,7 +2414,7 @@ export const canPresentExternalPurchaseNoticeIOS = async () => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/present-external-purchase-notice-sheet-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/present-external-purchase-notice-sheet-ios}
  */
 export const presentExternalPurchaseNoticeSheetIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -2528,7 +2443,7 @@ export const presentExternalPurchaseNoticeSheetIOS = async () => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/present-external-purchase-link-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/present-external-purchase-link-ios}
  */
 export const presentExternalPurchaseLinkIOS = async url => {
   if (Platform.OS !== 'ios') {
@@ -2562,7 +2477,7 @@ export const presentExternalPurchaseLinkIOS = async url => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/is-eligible-for-external-purchase-custom-link-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/is-eligible-for-external-purchase-custom-link-ios}
  */
 export const isEligibleForExternalPurchaseCustomLinkIOS = async () => {
   if (Platform.OS !== 'ios') {
@@ -2595,7 +2510,7 @@ export const isEligibleForExternalPurchaseCustomLinkIOS = async () => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/get-external-purchase-custom-link-token-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/get-external-purchase-custom-link-token-ios}
  */
 export const getExternalPurchaseCustomLinkTokenIOS = async tokenType => {
   if (Platform.OS !== 'ios') {
@@ -2628,7 +2543,7 @@ export const getExternalPurchaseCustomLinkTokenIOS = async tokenType => {
  * }
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/ios/show-external-purchase-custom-link-notice-ios}
+ * @see {@link https://openiap.dev/docs/apis/ios/show-external-purchase-custom-link-notice-ios}
  */
 export const showExternalPurchaseCustomLinkNoticeIOS = async noticeType => {
   if (Platform.OS !== 'ios') {