react-native-iap 14.5.1-rc.1 → 14.6.0-rc.2

package/nitrogen/generated/shared/c++/NitroReceiptValidationParams.hpp

@@ -23,12 +23,17 @@
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
 
-// Forward declaration of `NitroReceiptValidationAndroidOptions` to properly resolve imports.
-namespace margelo::nitro::iap { struct NitroReceiptValidationAndroidOptions; }
+// Forward declaration of `NitroReceiptValidationAppleOptions` to properly resolve imports.
+namespace margelo::nitro::iap { struct NitroReceiptValidationAppleOptions; }
+// Forward declaration of `NitroReceiptValidationGoogleOptions` to properly resolve imports.
+namespace margelo::nitro::iap { struct NitroReceiptValidationGoogleOptions; }
+// Forward declaration of `NitroReceiptValidationHorizonOptions` to properly resolve imports.
+namespace margelo::nitro::iap { struct NitroReceiptValidationHorizonOptions; }
 
-#include <string>
-#include "NitroReceiptValidationAndroidOptions.hpp"
+#include "NitroReceiptValidationAppleOptions.hpp"
 #include <optional>
+#include "NitroReceiptValidationGoogleOptions.hpp"
+#include "NitroReceiptValidationHorizonOptions.hpp"
 
 namespace margelo::nitro::iap {
 
@@ -37,12 +42,13 @@ namespace margelo::nitro::iap {
    */
   struct NitroReceiptValidationParams {
   public:
-    std::string sku     SWIFT_PRIVATE;
-    std::optional<NitroReceiptValidationAndroidOptions> androidOptions     SWIFT_PRIVATE;
+    std::optional<NitroReceiptValidationAppleOptions> apple     SWIFT_PRIVATE;
+    std::optional<NitroReceiptValidationGoogleOptions> google     SWIFT_PRIVATE;
+    std::optional<NitroReceiptValidationHorizonOptions> horizon     SWIFT_PRIVATE;
 
   public:
     NitroReceiptValidationParams() = default;
-    explicit NitroReceiptValidationParams(std::string sku, std::optional<NitroReceiptValidationAndroidOptions> androidOptions): sku(sku), androidOptions(androidOptions) {}
+    explicit NitroReceiptValidationParams(std::optional<NitroReceiptValidationAppleOptions> apple, std::optional<NitroReceiptValidationGoogleOptions> google, std::optional<NitroReceiptValidationHorizonOptions> horizon): apple(apple), google(google), horizon(horizon) {}
   };
 
 } // namespace margelo::nitro::iap
@@ -55,14 +61,16 @@ namespace margelo::nitro {
     static inline margelo::nitro::iap::NitroReceiptValidationParams fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
       jsi::Object obj = arg.asObject(runtime);
       return margelo::nitro::iap::NitroReceiptValidationParams(
-        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "sku")),
-        JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationAndroidOptions>>::fromJSI(runtime, obj.getProperty(runtime, "androidOptions"))
+        JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationAppleOptions>>::fromJSI(runtime, obj.getProperty(runtime, "apple")),
+        JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationGoogleOptions>>::fromJSI(runtime, obj.getProperty(runtime, "google")),
+        JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationHorizonOptions>>::fromJSI(runtime, obj.getProperty(runtime, "horizon"))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::NitroReceiptValidationParams& arg) {
       jsi::Object obj(runtime);
-      obj.setProperty(runtime, "sku", JSIConverter<std::string>::toJSI(runtime, arg.sku));
-      obj.setProperty(runtime, "androidOptions", JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationAndroidOptions>>::toJSI(runtime, arg.androidOptions));
+      obj.setProperty(runtime, "apple", JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationAppleOptions>>::toJSI(runtime, arg.apple));
+      obj.setProperty(runtime, "google", JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationGoogleOptions>>::toJSI(runtime, arg.google));
+      obj.setProperty(runtime, "horizon", JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationHorizonOptions>>::toJSI(runtime, arg.horizon));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -73,8 +81,9 @@ namespace margelo::nitro {
       if (!nitro::isPlainObject(runtime, obj)) {
         return false;
       }
-      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "sku"))) return false;
-      if (!JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationAndroidOptions>>::canConvert(runtime, obj.getProperty(runtime, "androidOptions"))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationAppleOptions>>::canConvert(runtime, obj.getProperty(runtime, "apple"))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationGoogleOptions>>::canConvert(runtime, obj.getProperty(runtime, "google"))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::iap::NitroReceiptValidationHorizonOptions>>::canConvert(runtime, obj.getProperty(runtime, "horizon"))) return false;
       return true;
     }
   };

package/openiap-versions.json

@@ -1,5 +1,5 @@
 {
-  "apple": "1.3.0",
-  "google": "1.3.11",
-  "gql": "1.3.1"
+  "apple": "1.3.2",
+  "google": "1.3.14",
+  "gql": "1.3.4"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "14.5.1-rc.1",
+  "version": "14.6.0-rc.2",
   "description": "React Native In-App Purchases module for iOS and Android using Nitro",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/plugin/build/withIAP.d.ts

@@ -31,6 +31,12 @@ type IapPluginProps = {
      * @platform ios
      */
     iosAlternativeBilling?: IosAlternativeBillingConfig;
+    /**
+     * IAPKit API key for purchase verification.
+     * This key will be added to AndroidManifest.xml (as meta-data) and Info.plist.
+     * Get your API key from https://iapkit.com
+     */
+    iapkitApiKey?: string;
 };
 type IapPluginCallable = {
     (config: ExpoConfig): ExpoConfig;

package/plugin/build/withIAP.js

@@ -86,7 +86,7 @@ const modifyAppBuildGradle = (gradle) => {
     }
     return modified;
 };
-const withIapAndroid = (config) => {
+const withIapAndroid = (config, props) => {
     // Add OpenIAP dependency to app build.gradle
     config = (0, config_plugins_1.withAppBuildGradle)(config, (config) => {
         config.modResults.contents = modifyAppBuildGradle(config.modResults.contents);
@@ -111,6 +111,29 @@ const withIapAndroid = (config) => {
                 console.log('ℹ️ com.android.vending.BILLING already exists in AndroidManifest.xml');
             }
         }
+        // Add IAPKit API key as meta-data if provided
+        if (props?.iapkitApiKey) {
+            const application = manifest.manifest.application;
+            const app = application?.[0];
+            if (app) {
+                if (!app['meta-data']) {
+                    app['meta-data'] = [];
+                }
+                const metaDataKey = 'dev.iapkit.API_KEY';
+                const existingMetaData = app['meta-data'].find((m) => m.$?.['android:name'] === metaDataKey);
+                if (!existingMetaData) {
+                    app['meta-data'].push({
+                        $: {
+                            'android:name': metaDataKey,
+                            'android:value': props.iapkitApiKey,
+                        },
+                    });
+                    if (!hasLoggedPluginExecution) {
+                        console.log('✅ Added IAPKit API key to AndroidManifest.xml');
+                    }
+                }
+            }
+        }
         return config;
     });
     return config;
@@ -247,14 +270,35 @@ end
         return config;
     });
 };
+/** Add IAPKit API key to iOS Info.plist */
+const withIapkitApiKeyIOS = (config, apiKey) => {
+    if (!apiKey) {
+        return config;
+    }
+    return (0, config_plugins_1.withInfoPlist)(config, (config) => {
+        const plist = config.modResults;
+        const plistKey = 'IAPKitAPIKey';
+        if (!plist[plistKey]) {
+            plist[plistKey] = apiKey;
+            if (!hasLoggedPluginExecution) {
+                console.log('✅ Added IAPKit API key to Info.plist');
+            }
+        }
+        return config;
+    });
+};
 const withIAP = (config, props) => {
     try {
-        let result = withIapAndroid(config);
+        let result = withIapAndroid(config, { iapkitApiKey: props?.iapkitApiKey });
         result = withIapIosFollyWorkaround(result, props);
         // Add iOS alternative billing configuration if provided
         if (props?.iosAlternativeBilling) {
             result = withIosAlternativeBilling(result, props.iosAlternativeBilling);
         }
+        // Add IAPKit API key to iOS Info.plist if provided
+        if (props?.iapkitApiKey) {
+            result = withIapkitApiKeyIOS(result, props.iapkitApiKey);
+        }
         // Set flag after first execution to prevent duplicate logs
         hasLoggedPluginExecution = true;
         return result;

package/plugin/src/withIAP.ts

@@ -125,7 +125,10 @@ const modifyAppBuildGradle = (gradle: string): string => {
   return modified;
 };
 
-const withIapAndroid: ConfigPlugin = (config) => {
+const withIapAndroid: ConfigPlugin<{iapkitApiKey?: string} | undefined> = (
+  config,
+  props,
+) => {
   // Add OpenIAP dependency to app build.gradle
   config = withAppBuildGradle(config, (config) => {
     config.modResults.contents = modifyAppBuildGradle(
@@ -161,6 +164,34 @@ const withIapAndroid: ConfigPlugin = (config) => {
       }
     }
 
+    // Add IAPKit API key as meta-data if provided
+    if (props?.iapkitApiKey) {
+      const application = manifest.manifest.application;
+      const app = application?.[0];
+      if (app) {
+        if (!app['meta-data']) {
+          app['meta-data'] = [];
+        }
+
+        const metaDataKey = 'dev.iapkit.API_KEY';
+        const existingMetaData = (
+          app['meta-data'] as {$?: {'android:name'?: string}}[]
+        ).find((m) => m.$?.['android:name'] === metaDataKey);
+
+        if (!existingMetaData) {
+          app['meta-data'].push({
+            $: {
+              'android:name': metaDataKey,
+              'android:value': props.iapkitApiKey,
+            },
+          });
+          if (!hasLoggedPluginExecution) {
+            console.log('✅ Added IAPKit API key to AndroidManifest.xml');
+          }
+        }
+      }
+    }
+
     return config;
   });
 
@@ -329,6 +360,12 @@ type IapPluginProps = {
    * @platform ios
    */
   iosAlternativeBilling?: IosAlternativeBillingConfig;
+  /**
+   * IAPKit API key for purchase verification.
+   * This key will be added to AndroidManifest.xml (as meta-data) and Info.plist.
+   * Get your API key from https://iapkit.com
+   */
+  iapkitApiKey?: string;
 };
 
 const withIapIosFollyWorkaround: ConfigPlugin<IapPluginProps | undefined> = (
@@ -389,14 +426,42 @@ end
   });
 };
 
+/** Add IAPKit API key to iOS Info.plist */
+const withIapkitApiKeyIOS: ConfigPlugin<string | undefined> = (
+  config,
+  apiKey,
+) => {
+  if (!apiKey) {
+    return config;
+  }
+
+  return withInfoPlist(config, (config) => {
+    const plist = config.modResults;
+    const plistKey = 'IAPKitAPIKey';
+
+    if (!plist[plistKey]) {
+      plist[plistKey] = apiKey;
+      if (!hasLoggedPluginExecution) {
+        console.log('✅ Added IAPKit API key to Info.plist');
+      }
+    }
+
+    return config;
+  });
+};
+
 const withIAP: ConfigPlugin<IapPluginProps | undefined> = (config, props) => {
   try {
-    let result = withIapAndroid(config);
+    let result = withIapAndroid(config, {iapkitApiKey: props?.iapkitApiKey});
     result = withIapIosFollyWorkaround(result, props);
     // Add iOS alternative billing configuration if provided
     if (props?.iosAlternativeBilling) {
       result = withIosAlternativeBilling(result, props.iosAlternativeBilling);
     }
+    // Add IAPKit API key to iOS Info.plist if provided
+    if (props?.iapkitApiKey) {
+      result = withIapkitApiKeyIOS(result, props.iapkitApiKey);
+    }
     // Set flag after first execution to prevent duplicate logs
     hasLoggedPluginExecution = true;
     return result;

package/src/hooks/useIAP.ts

@@ -71,16 +71,13 @@ type UseIap = {
   requestPurchase: (
     params: RequestPurchaseProps,
   ) => Promise<RequestPurchaseResult | null>;
+  /**
+   * @deprecated Use `verifyPurchase` instead. This function will be removed in a future version.
+   */
   validateReceipt: (
-    sku: string,
-    androidOptions?: {
-      packageName: string;
-      productToken: string;
-      accessToken: string;
-      isSub?: boolean;
-    },
-  ) => Promise<any>;
-  /** Verify purchase with the configured providers (alias for validateReceipt) */
+    options: VerifyPurchaseProps,
+  ) => Promise<VerifyPurchaseResult>;
+  /** Verify purchase with the configured providers */
   verifyPurchase: (
     options: VerifyPurchaseProps,
   ) => Promise<VerifyPurchaseResult>;
@@ -311,20 +308,8 @@ export function useIAP(options?: UseIapOptions): UseIap {
   // No local restorePurchases; use the top-level helper via returned API
 
   const validateReceipt = useCallback(
-    async (
-      sku: string,
-      androidOptions?: {
-        packageName: string;
-        productToken: string;
-        accessToken: string;
-        isSub?: boolean;
-      },
-    ) => {
-      return validateReceiptInternal({
-        sku,
-        androidOptions,
-      });
-    },
+    async (options: VerifyPurchaseProps): Promise<VerifyPurchaseResult> =>
+      validateReceiptInternal(options),
     [],
   );
 

package/src/index.ts

@@ -1335,29 +1335,94 @@ export const consumePurchaseAndroid: MutationField<
 
 /**
  * Validate receipt on both iOS and Android platforms
- * @param sku - Product SKU
- * @param androidOptions - Android-specific validation options (required for Android)
+ * @deprecated Use `verifyPurchase` instead. This function will be removed in a future version.
+ * @param options - Platform-specific verification options
+ * @param options.apple - Apple App Store verification options (iOS)
+ * @param options.google - Google Play verification options (Android)
+ * @param options.horizon - Meta Horizon (Quest) verification options
  * @returns Promise<VerifyPurchaseResultIOS | VerifyPurchaseResultAndroid> - Platform-specific receipt validation result
+ *
+ * @example
+ * ```typescript
+ * // Use verifyPurchase instead:
+ * const result = await verifyPurchase({
+ *   apple: { sku: 'premium_monthly' },
+ *   google: {
+ *     sku: 'premium_monthly',
+ *     packageName: 'com.example.app',
+ *     purchaseToken: 'token...',
+ *     accessToken: 'oauth_token...',
+ *     isSub: true
+ *   }
+ * });
+ * ```
  */
 export const validateReceipt: MutationField<'validateReceipt'> = async (
   options,
 ) => {
-  const {sku, androidOptions} = options;
+  const {apple, google, horizon} = options;
   try {
-    const normalizedAndroidOptions =
-      androidOptions != null
-        ? {
-            ...androidOptions,
-            isSub:
-              androidOptions.isSub == null
-                ? undefined
-                : Boolean(androidOptions.isSub),
+    // Validate required fields based on platform
+    if (Platform.OS === 'ios') {
+      if (!apple?.sku) {
+        throw new Error('Missing required parameter: apple.sku');
+      }
+    } else if (Platform.OS === 'android') {
+      // Horizon verification path (e.g., Meta Quest) - skip Google validation
+      if (horizon?.sku) {
+        // Validate all required Horizon fields
+        if (!horizon.userId || !horizon.accessToken) {
+          throw new Error(
+            'Missing required Horizon parameters: userId and accessToken are required when horizon.sku is provided',
+          );
+        }
+        // Horizon verification will be handled by native layer
+      } else if (!google) {
+        throw new Error('Missing required parameter: google options');
+      } else {
+        const requiredFields: (keyof typeof google)[] = [
+          'sku',
+          'accessToken',
+          'packageName',
+          'purchaseToken',
+        ];
+        for (const field of requiredFields) {
+          if (!google[field]) {
+            throw new Error(
+              `Missing or empty required parameter: google.${field}`,
+            );
           }
-        : undefined;
+        }
+      }
+    }
 
     const params: NitroReceiptValidationParams = {
-      sku,
-      androidOptions: normalizedAndroidOptions,
+      apple: apple?.sku
+        ? {
+            sku: apple.sku,
+          }
+        : null,
+      google:
+        google?.sku &&
+        google.accessToken &&
+        google.packageName &&
+        google.purchaseToken
+          ? {
+              sku: google.sku,
+              accessToken: google.accessToken,
+              packageName: google.packageName,
+              purchaseToken: google.purchaseToken,
+              isSub: google.isSub == null ? undefined : Boolean(google.isSub),
+            }
+          : null,
+      horizon:
+        horizon?.sku && horizon.userId && horizon.accessToken
+          ? {
+              sku: horizon.sku,
+              userId: horizon.userId,
+              accessToken: horizon.accessToken,
+            }
+          : null,
     };
 
     const nitroResult = await IAP.instance.validateReceipt(params);
@@ -2153,6 +2218,224 @@ export const createAlternativeBillingTokenAndroid: MutationField<
   }
 };
 
+// ------------------------------
+// Billing Programs API (Android 8.2.0+)
+// ------------------------------
+
+/**
+ * Billing program type for external content links and external offers.
+ * @platform Android
+ * @since Google Play Billing Library 8.2.0+
+ */
+export type BillingProgramAndroid =
+  | 'unspecified'
+  | 'external-content-link'
+  | 'external-offer';
+
+/**
+ * Launch mode for external link flow.
+ * @platform Android
+ * @since Google Play Billing Library 8.2.0+
+ */
+export type ExternalLinkLaunchModeAndroid =
+  | 'unspecified'
+  | 'launch-in-external-browser-or-app'
+  | 'caller-will-launch-link';
+
+/**
+ * Link type for external link flow.
+ * @platform Android
+ * @since Google Play Billing Library 8.2.0+
+ */
+export type ExternalLinkTypeAndroid =
+  | 'unspecified'
+  | 'link-to-digital-content-offer'
+  | 'link-to-app-download';
+
+/**
+ * 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.
+ *
+ * @param program - The billing program to enable (external-content-link or external-offer)
+ * @platform Android
+ * @since Google Play Billing Library 8.2.0+
+ *
+ * @example
+ * ```typescript
+ * // Enable external offers before connecting
+ * enableBillingProgramAndroid('external-offer');
+ * await initConnection();
+ * ```
+ */
+export const enableBillingProgramAndroid = (
+  program: BillingProgramAndroid,
+): void => {
+  if (Platform.OS !== 'android') {
+    RnIapConsole.warn(
+      'enableBillingProgramAndroid is only supported on Android',
+    );
+    return;
+  }
+  try {
+    IAP.instance.enableBillingProgramAndroid(program as any);
+  } catch (error) {
+    RnIapConsole.error('Failed to enable billing program:', error);
+  }
+};
+
+/**
+ * Check if a billing program is available for this user/device (Android only).
+ *
+ * @param program - The billing program to check
+ * @returns Promise with availability result
+ * @platform Android
+ * @since Google Play Billing Library 8.2.0+
+ *
+ * @example
+ * ```typescript
+ * const result = await isBillingProgramAvailableAndroid('external-offer');
+ * if (result.isAvailable) {
+ *   // External offers are available for this user
+ * }
+ * ```
+ */
+export const isBillingProgramAvailableAndroid = async (
+  program: BillingProgramAndroid,
+): Promise<BillingProgramAvailabilityResultAndroid> => {
+  if (Platform.OS !== 'android') {
+    throw new Error('Billing Programs API is only supported on Android');
+  }
+  try {
+    const result = await IAP.instance.isBillingProgramAvailableAndroid(
+      program as any,
+    );
+    return {
+      billingProgram: result.billingProgram as unknown as BillingProgramAndroid,
+      isAvailable: result.isAvailable,
+    };
+  } catch (error) {
+    RnIapConsole.error('Failed to check billing program availability:', error);
+    throw error;
+  }
+};
+
+/**
+ * Create billing program reporting details for external transactions (Android only).
+ * Used to get the external transaction token needed for reporting to Google.
+ *
+ * @param program - The billing program to create reporting details for
+ * @returns Promise with reporting details including external transaction token
+ * @platform Android
+ * @since Google Play Billing Library 8.2.0+
+ *
+ * @example
+ * ```typescript
+ * const details = await createBillingProgramReportingDetailsAndroid('external-offer');
+ * // Use details.externalTransactionToken to report the transaction
+ * await fetch('/api/report-external-transaction', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ token: details.externalTransactionToken })
+ * });
+ * ```
+ */
+export const createBillingProgramReportingDetailsAndroid = async (
+  program: BillingProgramAndroid,
+): Promise<BillingProgramReportingDetailsAndroid> => {
+  if (Platform.OS !== 'android') {
+    throw new Error('Billing Programs API is only supported on Android');
+  }
+  try {
+    const result =
+      await IAP.instance.createBillingProgramReportingDetailsAndroid(
+        program as any,
+      );
+    return {
+      billingProgram: result.billingProgram as unknown as BillingProgramAndroid,
+      externalTransactionToken: result.externalTransactionToken,
+    };
+  } catch (error) {
+    RnIapConsole.error(
+      'Failed to create billing program reporting details:',
+      error,
+    );
+    throw error;
+  }
+};
+
+/**
+ * Launch external link for external offers or app download (Android only).
+ *
+ * @param params - Parameters for launching the external link
+ * @returns Promise<boolean> - true if user accepted, false otherwise
+ * @platform Android
+ * @since Google Play Billing Library 8.2.0+
+ *
+ * @example
+ * ```typescript
+ * const success = await launchExternalLinkAndroid({
+ *   billingProgram: 'external-offer',
+ *   launchMode: 'launch-in-external-browser-or-app',
+ *   linkType: 'link-to-digital-content-offer',
+ *   linkUri: 'https://your-website.com/purchase'
+ * });
+ * if (success) {
+ *   console.log('User accepted external link');
+ * }
+ * ```
+ */
+export const launchExternalLinkAndroid = async (
+  params: LaunchExternalLinkParamsAndroid,
+): Promise<boolean> => {
+  if (Platform.OS !== 'android') {
+    throw new Error('Billing Programs API is only supported on Android');
+  }
+  try {
+    return await IAP.instance.launchExternalLinkAndroid({
+      billingProgram: params.billingProgram as any,
+      launchMode: params.launchMode as any,
+      linkType: params.linkType as any,
+      linkUri: params.linkUri,
+    });
+  } catch (error) {
+    RnIapConsole.error('Failed to launch external link:', error);
+    throw error;
+  }
+};
+
 // ------------------------------
 // iOS External Purchase
 // ------------------------------