react-native-iap 15.2.3 → 15.3.0

package/src/index.ts

@@ -10,6 +10,7 @@ import type {
   NitroReceiptValidationParams,
   NitroReceiptValidationResultIOS,
   NitroReceiptValidationResultAndroid,
+  NitroPurchaseUpdatedListenerOptions,
   NitroSubscriptionStatus,
   RnIap,
 } from './specs/RnIap.nitro';
@@ -30,6 +31,7 @@ import type {
   ProductSubscription,
   Purchase,
   PurchaseError,
+  PurchaseUpdatedListenerOptions,
   PurchaseIOS,
   QueryField,
   AppTransaction,
@@ -42,6 +44,8 @@ import type {
   RequestSubscriptionIosProps,
   RequestSubscriptionPropsByPlatforms,
   ActiveSubscription,
+  DeveloperProvidedBillingDetailsAndroid,
+  UserChoiceBillingDetails,
 } from './types';
 import {
   convertNitroProductToProduct,
@@ -70,8 +74,6 @@ import {parseAppTransactionPayload} from './utils';
 // Import them here for use in this file's interfaces and functions.
 import type {
   BillingProgramAndroid,
-  ExternalLinkLaunchModeAndroid,
-  ExternalLinkTypeAndroid,
 } from './types';
 
 // Export all types
@@ -87,7 +89,7 @@ export * from './utils/error';
 export type ProductTypeInput = 'inapp' | 'in-app' | 'subs';
 
 const LEGACY_INAPP_WARNING =
-  "[react-native-iap] `type: 'inapp'` is deprecated and will be removed in v14.4.0. Use 'in-app' instead.";
+  "[react-native-iap] `type: 'inapp'` is deprecated and will be removed in a future major version. Use 'in-app' instead.";
 
 type NitroPurchaseRequest = Parameters<RnIap['requestPurchase']>[0];
 type NitroAvailablePurchasesOptions = NonNullable<
@@ -97,6 +99,9 @@ type NitroFinishTransactionParamsInternal = Parameters<
   RnIap['finishTransaction']
 >[0];
 type NitroPurchaseListener = Parameters<RnIap['addPurchaseUpdatedListener']>[0];
+type NitroPurchaseUpdatedListenerOptionsParam = NonNullable<
+  Parameters<RnIap['addPurchaseUpdatedListener']>[1]
+>;
 type NitroPurchaseErrorListener = Parameters<
   RnIap['addPurchaseErrorListener']
 >[0];
@@ -116,6 +121,9 @@ const toErrorMessage = (error: unknown): string => {
   return String(error ?? '');
 };
 
+const unsupportedPlatformError = (): Error =>
+  new Error(`Unsupported platform: ${Platform.OS}`);
+
 export interface EventSubscription {
   remove(): void;
 }
@@ -129,10 +137,7 @@ export type {
   UseWebhookEventsOptions,
   UseWebhookEventsResult,
 } from './hooks/useWebhookEvents';
-export {
-  connectWebhookStream,
-  parseWebhookEventData,
-} from './webhook-client';
+export {connectWebhookStream, parseWebhookEventData} from './webhook-client';
 export type {
   WebhookEventPayload,
   WebhookEventStream,
@@ -232,11 +237,20 @@ const IAP = {
 // ============================================================================
 
 const purchaseUpdateJsListeners = new Set<(purchase: Purchase) => void>();
+const purchaseUpdateDuplicateJsListeners = new Set<
+  (purchase: Purchase) => void
+>();
 let purchaseUpdateNativeAttached = false;
-const purchaseUpdateNativeHandler: NitroPurchaseListener = (nitroPurchase) => {
+let purchaseUpdateDuplicateNativeAttached = false;
+let purchaseUpdateNativeToken: number | null = null;
+let purchaseUpdateDuplicateNativeToken: number | null = null;
+const emitPurchaseUpdateToListeners = (
+  nitroPurchase: Parameters<NitroPurchaseListener>[0],
+  listeners: Set<(purchase: Purchase) => void>,
+) => {
   if (validateNitroPurchase(nitroPurchase)) {
     const convertedPurchase = convertNitroPurchaseToPurchase(nitroPurchase);
-    for (const listener of purchaseUpdateJsListeners) {
+    for (const listener of listeners) {
       try {
         listener(convertedPurchase);
       } catch (e) {
@@ -250,6 +264,17 @@ const purchaseUpdateNativeHandler: NitroPurchaseListener = (nitroPurchase) => {
     );
   }
 };
+const purchaseUpdateNativeHandler: NitroPurchaseListener = (nitroPurchase) => {
+  emitPurchaseUpdateToListeners(nitroPurchase, purchaseUpdateJsListeners);
+};
+const purchaseUpdateDuplicateNativeHandler: NitroPurchaseListener = (
+  nitroPurchase,
+) => {
+  emitPurchaseUpdateToListeners(
+    nitroPurchase,
+    purchaseUpdateDuplicateJsListeners,
+  );
+};
 
 const purchaseErrorJsListeners = new Set<(error: PurchaseError) => void>();
 let purchaseErrorNativeAttached = false;
@@ -299,6 +324,9 @@ const promotedProductNativeHandler: NitroPromotedProductListener = (
  */
 export const resetListenerState = (): void => {
   purchaseUpdateNativeAttached = false;
+  purchaseUpdateDuplicateNativeAttached = false;
+  purchaseUpdateNativeToken = null;
+  purchaseUpdateDuplicateNativeToken = null;
   purchaseErrorNativeAttached = false;
   promotedProductNativeAttached = false;
   userChoiceBillingNativeAttached = false;
@@ -306,6 +334,7 @@ export const resetListenerState = (): void => {
   subscriptionBillingIssueNativeAttached = false;
   // Clear all JS listeners since native side clears them in endConnection
   purchaseUpdateJsListeners.clear();
+  purchaseUpdateDuplicateJsListeners.clear();
   purchaseErrorJsListeners.clear();
   promotedProductJsListeners.clear();
   userChoiceBillingJsListeners.clear();
@@ -315,12 +344,22 @@ export const resetListenerState = (): void => {
 
 export const purchaseUpdatedListener = (
   listener: (purchase: Purchase) => void,
+  options?: PurchaseUpdatedListenerOptions | null,
 ): EventSubscription => {
-  purchaseUpdateJsListeners.add(listener);
+  const receiveDuplicateTransactionUpdatesIOS =
+    Platform.OS === 'ios' && options?.dedupeTransactionIOS === false;
+  const listeners = receiveDuplicateTransactionUpdatesIOS
+    ? purchaseUpdateDuplicateJsListeners
+    : purchaseUpdateJsListeners;
+
+  listeners.add(listener);
 
-  if (!purchaseUpdateNativeAttached) {
+  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);
@@ -334,9 +373,65 @@ export const purchaseUpdatedListener = (
     }
   }
 
+  if (
+    !purchaseUpdateDuplicateNativeAttached &&
+    receiveDuplicateTransactionUpdatesIOS
+  ) {
+    try {
+      const nativeOptions: NitroPurchaseUpdatedListenerOptions &
+        NitroPurchaseUpdatedListenerOptionsParam = {
+        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);
+      }
     },
   };
 };
@@ -425,7 +520,7 @@ export const promotedProductListenerIOS = (
  * 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);
@@ -439,7 +534,9 @@ type NitroUserChoiceBillingListener = Parameters<
   RnIap['addUserChoiceBillingListenerAndroid']
 >[0];
 
-const userChoiceBillingJsListeners = new Set<(details: any) => void>();
+const userChoiceBillingJsListeners = new Set<
+  (details: UserChoiceBillingDetails) => void
+>();
 let userChoiceBillingNativeAttached = false;
 const userChoiceBillingNativeHandler: NitroUserChoiceBillingListener = (
   details,
@@ -457,7 +554,7 @@ const userChoiceBillingNativeHandler: NitroUserChoiceBillingListener = (
 };
 
 export const userChoiceBillingListenerAndroid = (
-  listener: (details: any) => void,
+  listener: (details: UserChoiceBillingDetails) => void,
 ): EventSubscription => {
   if (Platform.OS !== 'android') {
     RnIapConsole.warn(
@@ -510,7 +607,7 @@ export const userChoiceBillingListenerAndroid = (
  * ```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();
@@ -545,15 +642,6 @@ const developerProvidedBillingNativeHandler: NitroDeveloperProvidedBillingListen
     }
   };
 
-export interface DeveloperProvidedBillingDetailsAndroid {
-  /**
-   * External transaction token used to report transactions made through developer billing.
-   * This token must be used when reporting the external transaction to Google Play.
-   * Must be reported within 24 hours of the transaction.
-   */
-  externalTransactionToken: string;
-}
-
 export const developerProvidedBillingListenerAndroid = (
   listener: (details: DeveloperProvidedBillingDetailsAndroid) => void,
 ): EventSubscription => {
@@ -619,7 +707,9 @@ type NitroSubscriptionBillingIssueListener = Parameters<
   RnIap['addSubscriptionBillingIssueListener']
 >[0];
 
-const subscriptionBillingIssueJsListeners = new Set<(purchase: Purchase) => void>();
+const subscriptionBillingIssueJsListeners = new Set<
+  (purchase: Purchase) => void
+>();
 let subscriptionBillingIssueNativeAttached = false;
 const subscriptionBillingIssueNativeHandler: NitroSubscriptionBillingIssueListener =
   (nitroPurchase) => {
@@ -707,7 +797,7 @@ export const subscriptionBillingIssueListener = (
  * @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: QueryField<'fetchProducts'> = async (request) => {
   const {skus, type} = request;
@@ -849,7 +939,7 @@ export const fetchProducts: QueryField<'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: QueryField<
   'getAvailablePurchases'
@@ -904,7 +994,7 @@ export const getAvailablePurchases: QueryField<
 
       return validPurchases.map(convertNitroPurchaseToPurchase);
     } else {
-      throw new Error('Unsupported platform');
+      throw unsupportedPlatformError();
     }
   } catch (error) {
     RnIapConsole.error('Failed to get available purchases:', error);
@@ -917,7 +1007,7 @@ export const getAvailablePurchases: QueryField<
  * @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: QueryField<
   'getPromotedProductIOS'
@@ -961,7 +1051,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: QueryField<'getStorefrontIOS'> = async () => {
   if (Platform.OS !== 'ios') {
@@ -980,7 +1070,7 @@ export const getStorefrontIOS: QueryField<'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: QueryField<'getStorefront'> = async () => {
   if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
@@ -1034,7 +1124,7 @@ export const getStorefront: QueryField<'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: QueryField<
   'getAppTransactionIOS'
@@ -1075,7 +1165,7 @@ export const getAppTransactionIOS: QueryField<
  * @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: QueryField<
   'subscriptionStatusIOS'
@@ -1108,7 +1198,7 @@ export const subscriptionStatusIOS: QueryField<
  * @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: QueryField<
   'currentEntitlementIOS'
@@ -1142,7 +1232,7 @@ export const currentEntitlementIOS: QueryField<
  * @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: QueryField<'latestTransactionIOS'> = async (
   sku,
@@ -1175,7 +1265,7 @@ export const latestTransactionIOS: QueryField<'latestTransactionIOS'> = async (
  * @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: QueryField<
   'getPendingTransactionsIOS'
@@ -1206,7 +1296,7 @@ export const getPendingTransactionsIOS: QueryField<
 /**
  * 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: QueryField<
   'getAllTransactionsIOS'
@@ -1239,7 +1329,7 @@ export const getAllTransactionsIOS: QueryField<
  * @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: MutationField<
   'showManageSubscriptionsIOS'
@@ -1273,7 +1363,7 @@ export const showManageSubscriptionsIOS: MutationField<
  * @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: QueryField<
   'isEligibleForIntroOfferIOS'
@@ -1301,7 +1391,7 @@ export const isEligibleForIntroOfferIOS: QueryField<
  * @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: QueryField<'getReceiptDataIOS'> = async () => {
   if (Platform.OS !== 'ios') {
@@ -1390,7 +1480,7 @@ export const requestReceiptRefreshIOS = async (): Promise<string> => {
  * @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: QueryField<
   'isTransactionVerifiedIOS'
@@ -1419,7 +1509,7 @@ export const isTransactionVerifiedIOS: QueryField<
  * @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: QueryField<'getTransactionJwsIOS'> = async (
   sku,
@@ -1463,7 +1553,7 @@ export const getTransactionJwsIOS: QueryField<'getTransactionJwsIOS'> = async (
  * @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: MutationField<'initConnection'> = async (
   config,
@@ -1487,7 +1577,7 @@ export const initConnection: MutationField<'initConnection'> = async (
 /**
  * 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: MutationField<'endConnection'> = async () => {
   try {
@@ -1510,7 +1600,7 @@ export const endConnection: MutationField<'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: MutationField<'restorePurchases'> = async () => {
   try {
@@ -1558,7 +1648,7 @@ export const restorePurchases: MutationField<'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: MutationField<'requestPurchase'> = async (
   request,
@@ -1594,7 +1684,7 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
         );
       }
     } else {
-      throw new Error('Unsupported platform');
+      throw unsupportedPlatformError();
     }
 
     const unifiedRequest: NitroPurchaseRequest = {};
@@ -1629,6 +1719,22 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
       if (iosRequest.advancedCommerceData) {
         iosPayload.advancedCommerceData = iosRequest.advancedCommerceData;
       }
+      if (isSubs) {
+        const subscriptionRequest = iosRequest as RequestSubscriptionIosProps;
+        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;
     }
@@ -1726,7 +1832,7 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
  * @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: MutationField<'finishTransaction'> = async (
   args,
@@ -1757,7 +1863,7 @@ export const finishTransaction: MutationField<'finishTransaction'> = async (
         },
       };
     } else {
-      throw new Error('Unsupported platform');
+      throw unsupportedPlatformError();
     }
 
     const result = await IAP.instance.finishTransaction(params);
@@ -1795,7 +1901,7 @@ export const finishTransaction: MutationField<'finishTransaction'> = async (
  * 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: MutationField<
   'acknowledgePurchaseAndroid'
@@ -1836,7 +1942,7 @@ export const acknowledgePurchaseAndroid: MutationField<
  * 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: MutationField<
   'consumePurchaseAndroid'
@@ -1893,7 +1999,7 @@ export const consumePurchaseAndroid: MutationField<
  * });
  * ```
  *
- * @see {@link https://www.openiap.dev/docs/apis/validate-receipt}
+ * @see {@link https://openiap.dev/docs/apis/validate-receipt}
  */
 export const validateReceipt: MutationField<'validateReceipt'> = async (
   options,
@@ -2024,7 +2130,7 @@ export const validateReceipt: MutationField<'validateReceipt'> = async (
  * @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: MutationField<'verifyPurchase'> = validateReceipt;
 
@@ -2035,7 +2141,7 @@ export const verifyPurchase: MutationField<'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: QueryField<'validateReceiptIOS'> = async (
   options,
@@ -2068,7 +2174,7 @@ export const validateReceiptIOS: QueryField<'validateReceiptIOS'> = async (
  * });
  * ```
  *
- * @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: MutationField<
   'verifyPurchaseWithProvider'
@@ -2113,7 +2219,7 @@ export const verifyPurchaseWithProvider: MutationField<
  * @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: MutationField<'syncIOS'> = async () => {
   if (Platform.OS !== 'ios') {
@@ -2140,7 +2246,7 @@ export const syncIOS: MutationField<'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: MutationField<
   'presentCodeRedemptionSheetIOS'
@@ -2184,7 +2290,7 @@ export const presentCodeRedemptionSheetIOS: MutationField<
  * @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 (): Promise<boolean> => {
@@ -2228,7 +2334,7 @@ export const requestPurchaseOnPromotedProductIOS =
  * @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: MutationField<
   'clearTransactionIOS'
@@ -2258,7 +2364,7 @@ export const clearTransactionIOS: MutationField<
  * @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: MutationField<
   'beginRefundRequestIOS'
@@ -2286,7 +2392,7 @@ export const beginRefundRequestIOS: MutationField<
  * 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: MutationField<
   'deepLinkToSubscriptions'
@@ -2301,16 +2407,15 @@ export const deepLinkToSubscriptions: MutationField<
     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 (): Promise<boolean> => {
@@ -2349,7 +2454,7 @@ export const deepLinkToSubscriptionsIOS = async (): Promise<boolean> => {
  * @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: QueryField<
   'getActiveSubscriptions'
@@ -2375,7 +2480,7 @@ export const getActiveSubscriptions: QueryField<
         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,
@@ -2418,90 +2523,6 @@ export const getActiveSubscriptions: QueryField<
   }
 };
 
-// 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.
@@ -2510,7 +2531,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: QueryField<
   'hasActiveSubscriptions'
@@ -2639,7 +2660,7 @@ const normalizeProductQueryType = (
  * }
  * ```
  *
- * @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: MutationField<
   'checkAlternativeBillingAvailabilityAndroid'
@@ -2681,7 +2702,7 @@ export const checkAlternativeBillingAvailabilityAndroid: MutationField<
  * }
  * ```
  *
- * @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: MutationField<
   'showAlternativeBillingDialogAndroid'
@@ -2720,7 +2741,7 @@ export const showAlternativeBillingDialogAndroid: MutationField<
  * }
  * ```
  *
- * @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: MutationField<
   'createAlternativeBillingTokenAndroid'
@@ -2736,40 +2757,6 @@ export const createAlternativeBillingTokenAndroid: MutationField<
   }
 };
 
-/**
- * Parameters for launching an external link (Android 8.2.0+).
- */
-export interface LaunchExternalLinkParamsAndroid {
-  /** The billing program (external-content-link or external-offer) */
-  billingProgram: BillingProgramAndroid;
-  /** The external link launch mode */
-  launchMode: ExternalLinkLaunchModeAndroid;
-  /** The type of the external link */
-  linkType: ExternalLinkTypeAndroid;
-  /** The URI where the content will be accessed from */
-  linkUri: string;
-}
-
-/**
- * Result of checking billing program availability (Android 8.2.0+).
- */
-export interface BillingProgramAvailabilityResultAndroid {
-  /** The billing program that was checked */
-  billingProgram: BillingProgramAndroid;
-  /** Whether the billing program is available for the user */
-  isAvailable: boolean;
-}
-
-/**
- * Reporting details for external transactions (Android 8.2.0+).
- */
-export interface BillingProgramReportingDetailsAndroid {
-  /** The billing program that the reporting details are associated with */
-  billingProgram: BillingProgramAndroid;
-  /** External transaction token used to report transactions to Google */
-  externalTransactionToken: string;
-}
-
 /**
  * Enable a billing program before initConnection (Android only).
  * Must be called BEFORE initConnection() to configure the BillingClient.
@@ -2795,7 +2782,7 @@ export const enableBillingProgramAndroid = (
     return;
   }
   try {
-    IAP.instance.enableBillingProgramAndroid(program as any);
+    IAP.instance.enableBillingProgramAndroid(program);
   } catch (error) {
     RnIapConsole.error('Failed to enable billing program:', error);
   }
@@ -2817,7 +2804,7 @@ export const enableBillingProgramAndroid = (
  * }
  * ```
  *
- * @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: MutationField<
   'isBillingProgramAvailableAndroid'
@@ -2826,9 +2813,7 @@ export const isBillingProgramAvailableAndroid: MutationField<
     throw new Error('Billing Programs API is only supported on Android');
   }
   try {
-    const result = await IAP.instance.isBillingProgramAvailableAndroid(
-      program as any,
-    );
+    const result = await IAP.instance.isBillingProgramAvailableAndroid(program);
     return {
       billingProgram: result.billingProgram as unknown as BillingProgramAndroid,
       isAvailable: result.isAvailable,
@@ -2858,7 +2843,7 @@ export const isBillingProgramAvailableAndroid: MutationField<
  * });
  * ```
  *
- * @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: MutationField<
   'createBillingProgramReportingDetailsAndroid'
@@ -2868,9 +2853,7 @@ export const createBillingProgramReportingDetailsAndroid: MutationField<
   }
   try {
     const result =
-      await IAP.instance.createBillingProgramReportingDetailsAndroid(
-        program as any,
-      );
+      await IAP.instance.createBillingProgramReportingDetailsAndroid(program);
     return {
       billingProgram: result.billingProgram as unknown as BillingProgramAndroid,
       externalTransactionToken: result.externalTransactionToken,
@@ -2905,7 +2888,7 @@ export const createBillingProgramReportingDetailsAndroid: MutationField<
  * }
  * ```
  *
- * @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: MutationField<
   'launchExternalLinkAndroid'
@@ -2915,9 +2898,9 @@ export const launchExternalLinkAndroid: MutationField<
   }
   try {
     return await IAP.instance.launchExternalLinkAndroid({
-      billingProgram: params.billingProgram as any,
-      launchMode: params.launchMode as any,
-      linkType: params.linkType as any,
+      billingProgram: params.billingProgram,
+      launchMode: params.launchMode,
+      linkType: params.linkType,
       linkUri: params.linkUri,
     });
   } catch (error) {
@@ -2949,7 +2932,7 @@ export const launchExternalLinkAndroid: MutationField<
  * }
  * ```
  *
- * @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: QueryField<
   'canPresentExternalPurchaseNoticeIOS'
@@ -2984,7 +2967,7 @@ export const canPresentExternalPurchaseNoticeIOS: QueryField<
  * }
  * ```
  *
- * @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 (): Promise<ExternalPurchaseNoticeResultIOS> => {
@@ -3017,7 +3000,7 @@ export const presentExternalPurchaseNoticeSheetIOS =
  * }
  * ```
  *
- * @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: MutationField<
   'presentExternalPurchaseLinkIOS'
@@ -3026,7 +3009,7 @@ export const presentExternalPurchaseLinkIOS: MutationField<
     throw new Error('External purchase is only supported on iOS');
   }
   try {
-    return (await IAP.instance.presentExternalPurchaseLinkIOS(url)) as any;
+    return await IAP.instance.presentExternalPurchaseLinkIOS(url);
   } catch (error) {
     RnIapConsole.error('Failed to present external purchase link:', error);
     throw error;
@@ -3053,7 +3036,7 @@ export const presentExternalPurchaseLinkIOS: MutationField<
  * }
  * ```
  *
- * @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 (): Promise<boolean> => {
@@ -3090,7 +3073,7 @@ export const isEligibleForExternalPurchaseCustomLinkIOS =
  * }
  * ```
  *
- * @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: ExternalPurchaseCustomLinkTokenTypeIOS,
@@ -3130,7 +3113,7 @@ export const getExternalPurchaseCustomLinkTokenIOS = async (
  * }
  * ```
  *
- * @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: ExternalPurchaseCustomLinkNoticeTypeIOS,