react-native-iap 15.2.3 → 15.3.0

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
@@ -114,11 +115,15 @@ const IAP = {
 // ============================================================================
 
 const purchaseUpdateJsListeners = new Set();
+const purchaseUpdateDuplicateJsListeners = new Set();
 let purchaseUpdateNativeAttached = false;
-const purchaseUpdateNativeHandler = nitroPurchase => {
+let purchaseUpdateDuplicateNativeAttached = false;
+let purchaseUpdateNativeToken = null;
+let purchaseUpdateDuplicateNativeToken = null;
+const emitPurchaseUpdateToListeners = (nitroPurchase, listeners) => {
   if (validateNitroPurchase(nitroPurchase)) {
     const convertedPurchase = convertNitroPurchaseToPurchase(nitroPurchase);
-    for (const listener of purchaseUpdateJsListeners) {
+    for (const listener of listeners) {
       try {
         listener(convertedPurchase);
       } catch (e) {
@@ -129,6 +134,12 @@ const purchaseUpdateNativeHandler = nitroPurchase => {
     RnIapConsole.error('Invalid purchase data received from native — productId:', nitroPurchase?.productId ?? 'unknown');
   }
 };
+const purchaseUpdateNativeHandler = nitroPurchase => {
+  emitPurchaseUpdateToListeners(nitroPurchase, purchaseUpdateJsListeners);
+};
+const purchaseUpdateDuplicateNativeHandler = nitroPurchase => {
+  emitPurchaseUpdateToListeners(nitroPurchase, purchaseUpdateDuplicateJsListeners);
+};
 const purchaseErrorJsListeners = new Set();
 let purchaseErrorNativeAttached = false;
 const purchaseErrorNativeHandler = error => {
@@ -168,6 +179,9 @@ const promotedProductNativeHandler = nitroProduct => {
  */
 export const resetListenerState = () => {
   purchaseUpdateNativeAttached = false;
+  purchaseUpdateDuplicateNativeAttached = false;
+  purchaseUpdateNativeToken = null;
+  purchaseUpdateDuplicateNativeToken = null;
   purchaseErrorNativeAttached = false;
   promotedProductNativeAttached = false;
   userChoiceBillingNativeAttached = false;
@@ -175,17 +189,21 @@ export const resetListenerState = () => {
   subscriptionBillingIssueNativeAttached = false;
   // Clear all JS listeners since native side clears them in endConnection
   purchaseUpdateJsListeners.clear();
+  purchaseUpdateDuplicateJsListeners.clear();
   purchaseErrorJsListeners.clear();
   promotedProductJsListeners.clear();
   userChoiceBillingJsListeners.clear();
   developerProvidedBillingJsListeners.clear();
   subscriptionBillingIssueJsListeners.clear();
 };
-export const purchaseUpdatedListener = listener => {
-  purchaseUpdateJsListeners.add(listener);
-  if (!purchaseUpdateNativeAttached) {
+export const purchaseUpdatedListener = (listener, options) => {
+  const receiveDuplicateTransactionUpdatesIOS = Platform.OS === 'ios' && options?.dedupeTransactionIOS === false;
+  const listeners = receiveDuplicateTransactionUpdatesIOS ? purchaseUpdateDuplicateJsListeners : purchaseUpdateJsListeners;
+  listeners.add(listener);
+  if (!purchaseUpdateNativeAttached && !receiveDuplicateTransactionUpdatesIOS) {
     try {
-      IAP.instance.addPurchaseUpdatedListener(purchaseUpdateNativeHandler);
+      const token = IAP.instance.addPurchaseUpdatedListener(purchaseUpdateNativeHandler);
+      purchaseUpdateNativeToken = typeof token === 'number' ? token : null;
       purchaseUpdateNativeAttached = true;
     } catch (e) {
       const msg = toErrorMessage(e);
@@ -196,9 +214,50 @@ export const purchaseUpdatedListener = listener => {
       }
     }
   }
+  if (!purchaseUpdateDuplicateNativeAttached && receiveDuplicateTransactionUpdatesIOS) {
+    try {
+      const nativeOptions = {
+        dedupeTransactionIOS: false
+      };
+      const token = IAP.instance.addPurchaseUpdatedListener(purchaseUpdateDuplicateNativeHandler, nativeOptions);
+      purchaseUpdateDuplicateNativeToken = typeof token === 'number' ? token : null;
+      purchaseUpdateDuplicateNativeAttached = true;
+    } catch (e) {
+      const msg = toErrorMessage(e);
+      if (msg.includes('Nitro runtime not installed')) {
+        RnIapConsole.warn('[purchaseUpdatedListener] Nitro not ready yet; listener inert until initConnection()');
+      } else {
+        throw e;
+      }
+    }
+  }
+  let removed = false;
   return {
     remove: () => {
-      purchaseUpdateJsListeners.delete(listener);
+      if (removed) {
+        return;
+      }
+      removed = true;
+      listeners.delete(listener);
+      if (listeners.size > 0) {
+        return;
+      }
+      const token = receiveDuplicateTransactionUpdatesIOS ? purchaseUpdateDuplicateNativeToken : purchaseUpdateNativeToken;
+      if (token == null) {
+        return;
+      }
+      try {
+        IAP.instance.removePurchaseUpdatedListener(token);
+        if (receiveDuplicateTransactionUpdatesIOS) {
+          purchaseUpdateDuplicateNativeToken = null;
+          purchaseUpdateDuplicateNativeAttached = false;
+        } else {
+          purchaseUpdateNativeToken = null;
+          purchaseUpdateNativeAttached = false;
+        }
+      } catch (e) {
+        RnIapConsole.warn('[purchaseUpdatedListener] native remove failed:', e);
+      }
     }
   };
 };
@@ -272,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);
@@ -339,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();
@@ -490,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 {
@@ -597,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);
@@ -642,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);
@@ -655,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') {
@@ -692,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') {
@@ -710,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') {
@@ -753,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') {
@@ -788,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') {
@@ -816,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') {
@@ -847,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') {
@@ -877,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') {
@@ -901,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') {
@@ -927,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') {
@@ -954,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') {
@@ -979,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') {
@@ -1048,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') {
@@ -1074,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') {
@@ -1115,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 {
@@ -1135,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 {
@@ -1158,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 {
@@ -1205,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 {
@@ -1232,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 = {};
 
@@ -1259,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;
     }
 
@@ -1340,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 {
@@ -1370,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');
@@ -1404,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 {
@@ -1440,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 {
@@ -1494,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 {
@@ -1603,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;
 
@@ -1614,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') {
@@ -1645,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 {
@@ -1686,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') {
@@ -1712,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') {
@@ -1753,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') {
@@ -1788,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') {
@@ -1815,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') {
@@ -1840,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;
@@ -1852,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') {
@@ -1898,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 {
@@ -1919,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,
@@ -1954,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.
@@ -2046,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 {
@@ -2150,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') {
@@ -2187,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') {
@@ -2224,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') {
@@ -2238,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.
@@ -2293,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') {
@@ -2330,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') {
@@ -2369,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') {
@@ -2411,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') {
@@ -2441,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') {
@@ -2470,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') {
@@ -2504,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') {
@@ -2537,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') {
@@ -2570,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') {