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

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

@@ -0,0 +1,80 @@
+///
+/// NitroBillingProgramAvailabilityResultAndroid.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `BillingProgramAndroid` to properly resolve imports.
+namespace margelo::nitro::iap { enum class BillingProgramAndroid; }
+
+#include "BillingProgramAndroid.hpp"
+
+namespace margelo::nitro::iap {
+
+  /**
+   * A struct which can be represented as a JavaScript object (NitroBillingProgramAvailabilityResultAndroid).
+   */
+  struct NitroBillingProgramAvailabilityResultAndroid {
+  public:
+    BillingProgramAndroid billingProgram     SWIFT_PRIVATE;
+    bool isAvailable     SWIFT_PRIVATE;
+
+  public:
+    NitroBillingProgramAvailabilityResultAndroid() = default;
+    explicit NitroBillingProgramAvailabilityResultAndroid(BillingProgramAndroid billingProgram, bool isAvailable): billingProgram(billingProgram), isAvailable(isAvailable) {}
+  };
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ NitroBillingProgramAvailabilityResultAndroid <> JS NitroBillingProgramAvailabilityResultAndroid (object)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::NitroBillingProgramAvailabilityResultAndroid> final {
+    static inline margelo::nitro::iap::NitroBillingProgramAvailabilityResultAndroid fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::iap::NitroBillingProgramAvailabilityResultAndroid(
+        JSIConverter<margelo::nitro::iap::BillingProgramAndroid>::fromJSI(runtime, obj.getProperty(runtime, "billingProgram")),
+        JSIConverter<bool>::fromJSI(runtime, obj.getProperty(runtime, "isAvailable"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::NitroBillingProgramAvailabilityResultAndroid& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "billingProgram", JSIConverter<margelo::nitro::iap::BillingProgramAndroid>::toJSI(runtime, arg.billingProgram));
+      obj.setProperty(runtime, "isAvailable", JSIConverter<bool>::toJSI(runtime, arg.isAvailable));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<margelo::nitro::iap::BillingProgramAndroid>::canConvert(runtime, obj.getProperty(runtime, "billingProgram"))) return false;
+      if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, "isAvailable"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,81 @@
+///
+/// NitroBillingProgramReportingDetailsAndroid.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `BillingProgramAndroid` to properly resolve imports.
+namespace margelo::nitro::iap { enum class BillingProgramAndroid; }
+
+#include "BillingProgramAndroid.hpp"
+#include <string>
+
+namespace margelo::nitro::iap {
+
+  /**
+   * A struct which can be represented as a JavaScript object (NitroBillingProgramReportingDetailsAndroid).
+   */
+  struct NitroBillingProgramReportingDetailsAndroid {
+  public:
+    BillingProgramAndroid billingProgram     SWIFT_PRIVATE;
+    std::string externalTransactionToken     SWIFT_PRIVATE;
+
+  public:
+    NitroBillingProgramReportingDetailsAndroid() = default;
+    explicit NitroBillingProgramReportingDetailsAndroid(BillingProgramAndroid billingProgram, std::string externalTransactionToken): billingProgram(billingProgram), externalTransactionToken(externalTransactionToken) {}
+  };
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ NitroBillingProgramReportingDetailsAndroid <> JS NitroBillingProgramReportingDetailsAndroid (object)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::NitroBillingProgramReportingDetailsAndroid> final {
+    static inline margelo::nitro::iap::NitroBillingProgramReportingDetailsAndroid fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::iap::NitroBillingProgramReportingDetailsAndroid(
+        JSIConverter<margelo::nitro::iap::BillingProgramAndroid>::fromJSI(runtime, obj.getProperty(runtime, "billingProgram")),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "externalTransactionToken"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::NitroBillingProgramReportingDetailsAndroid& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "billingProgram", JSIConverter<margelo::nitro::iap::BillingProgramAndroid>::toJSI(runtime, arg.billingProgram));
+      obj.setProperty(runtime, "externalTransactionToken", JSIConverter<std::string>::toJSI(runtime, arg.externalTransactionToken));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<margelo::nitro::iap::BillingProgramAndroid>::canConvert(runtime, obj.getProperty(runtime, "billingProgram"))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "externalTransactionToken"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,95 @@
+///
+/// NitroLaunchExternalLinkParamsAndroid.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `BillingProgramAndroid` to properly resolve imports.
+namespace margelo::nitro::iap { enum class BillingProgramAndroid; }
+// Forward declaration of `ExternalLinkLaunchModeAndroid` to properly resolve imports.
+namespace margelo::nitro::iap { enum class ExternalLinkLaunchModeAndroid; }
+// Forward declaration of `ExternalLinkTypeAndroid` to properly resolve imports.
+namespace margelo::nitro::iap { enum class ExternalLinkTypeAndroid; }
+
+#include "BillingProgramAndroid.hpp"
+#include "ExternalLinkLaunchModeAndroid.hpp"
+#include "ExternalLinkTypeAndroid.hpp"
+#include <string>
+
+namespace margelo::nitro::iap {
+
+  /**
+   * A struct which can be represented as a JavaScript object (NitroLaunchExternalLinkParamsAndroid).
+   */
+  struct NitroLaunchExternalLinkParamsAndroid {
+  public:
+    BillingProgramAndroid billingProgram     SWIFT_PRIVATE;
+    ExternalLinkLaunchModeAndroid launchMode     SWIFT_PRIVATE;
+    ExternalLinkTypeAndroid linkType     SWIFT_PRIVATE;
+    std::string linkUri     SWIFT_PRIVATE;
+
+  public:
+    NitroLaunchExternalLinkParamsAndroid() = default;
+    explicit NitroLaunchExternalLinkParamsAndroid(BillingProgramAndroid billingProgram, ExternalLinkLaunchModeAndroid launchMode, ExternalLinkTypeAndroid linkType, std::string linkUri): billingProgram(billingProgram), launchMode(launchMode), linkType(linkType), linkUri(linkUri) {}
+  };
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ NitroLaunchExternalLinkParamsAndroid <> JS NitroLaunchExternalLinkParamsAndroid (object)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::NitroLaunchExternalLinkParamsAndroid> final {
+    static inline margelo::nitro::iap::NitroLaunchExternalLinkParamsAndroid fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::iap::NitroLaunchExternalLinkParamsAndroid(
+        JSIConverter<margelo::nitro::iap::BillingProgramAndroid>::fromJSI(runtime, obj.getProperty(runtime, "billingProgram")),
+        JSIConverter<margelo::nitro::iap::ExternalLinkLaunchModeAndroid>::fromJSI(runtime, obj.getProperty(runtime, "launchMode")),
+        JSIConverter<margelo::nitro::iap::ExternalLinkTypeAndroid>::fromJSI(runtime, obj.getProperty(runtime, "linkType")),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "linkUri"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::NitroLaunchExternalLinkParamsAndroid& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "billingProgram", JSIConverter<margelo::nitro::iap::BillingProgramAndroid>::toJSI(runtime, arg.billingProgram));
+      obj.setProperty(runtime, "launchMode", JSIConverter<margelo::nitro::iap::ExternalLinkLaunchModeAndroid>::toJSI(runtime, arg.launchMode));
+      obj.setProperty(runtime, "linkType", JSIConverter<margelo::nitro::iap::ExternalLinkTypeAndroid>::toJSI(runtime, arg.linkType));
+      obj.setProperty(runtime, "linkUri", JSIConverter<std::string>::toJSI(runtime, arg.linkUri));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<margelo::nitro::iap::BillingProgramAndroid>::canConvert(runtime, obj.getProperty(runtime, "billingProgram"))) return false;
+      if (!JSIConverter<margelo::nitro::iap::ExternalLinkLaunchModeAndroid>::canConvert(runtime, obj.getProperty(runtime, "launchMode"))) return false;
+      if (!JSIConverter<margelo::nitro::iap::ExternalLinkTypeAndroid>::canConvert(runtime, obj.getProperty(runtime, "linkType"))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "linkUri"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/openiap-versions.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "14.5.1-rc.1",
+  "version": "14.6.0-rc.1",
   "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/src/index.ts

@@ -2153,6 +2153,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
 // ------------------------------

package/src/specs/RnIap.nitro.ts

@@ -44,6 +44,22 @@ export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon';
 // Note: Nitro requires at least 2 values for union types
 export type PurchaseVerificationProvider = 'iapkit' | 'none';
 
+// Billing Programs API types (Android 8.2.0+)
+export type BillingProgramAndroid =
+  | 'unspecified'
+  | 'external-content-link'
+  | 'external-offer';
+
+export type ExternalLinkLaunchModeAndroid =
+  | 'unspecified'
+  | 'launch-in-external-browser-or-app'
+  | 'caller-will-launch-link';
+
+export type ExternalLinkTypeAndroid =
+  | 'unspecified'
+  | 'link-to-digital-content-offer'
+  | 'link-to-app-download';
+
 // ╔══════════════════════════════════════════════════════════════════════════╗
 // ║                                  PARAMS                                  ║
 // ╚══════════════════════════════════════════════════════════════════════════╝
@@ -147,6 +163,20 @@ export interface NitroDeepLinkOptionsAndroid {
   packageNameAndroid?: DeepLinkOptions['packageNameAndroid'];
 }
 
+/**
+ * Parameters for launching an external link (Android 8.2.0+)
+ */
+export interface NitroLaunchExternalLinkParamsAndroid {
+  /** 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;
+}
+
 // ╔══════════════════════════════════════════════════════════════════════════╗
 // ║                                  TYPES                                   ║
 // ╚══════════════════════════════════════════════════════════════════════════╝
@@ -251,6 +281,26 @@ export interface NitroVerifyPurchaseWithProviderResult {
   provider: PurchaseVerificationProvider;
 }
 
+/**
+ * Result of checking billing program availability (Android 8.2.0+)
+ */
+export interface NitroBillingProgramAvailabilityResultAndroid {
+  /** 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 NitroBillingProgramReportingDetailsAndroid {
+  /** The billing program that the reporting details are associated with */
+  billingProgram: BillingProgramAndroid;
+  /** External transaction token used to report transactions to Google */
+  externalTransactionToken: string;
+}
+
 /**
  * Discount amount details for one-time purchase offers (Android)
  */
@@ -870,6 +920,57 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
     listener: (details: UserChoiceBillingDetails) => void,
   ): void;
 
+  // ╔════════════════════════════════════════════════════════════════════════╗
+  // ║                 BILLING PROGRAMS API (Android 8.2.0+)                  ║
+  // ╚════════════════════════════════════════════════════════════════════════╝
+
+  /**
+   * Enable a billing program before initConnection (Android only).
+   * Must be called BEFORE initConnection() to configure the BillingClient.
+   *
+   * @param program - The billing program to enable
+   * @platform Android
+   * @since Billing Library 8.2.0+
+   */
+  enableBillingProgramAndroid(program: BillingProgramAndroid): void;
+
+  /**
+   * 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 Billing Library 8.2.0+
+   */
+  isBillingProgramAvailableAndroid(
+    program: BillingProgramAndroid,
+  ): Promise<NitroBillingProgramAvailabilityResultAndroid>;
+
+  /**
+   * 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 Billing Library 8.2.0+
+   */
+  createBillingProgramReportingDetailsAndroid(
+    program: BillingProgramAndroid,
+  ): Promise<NitroBillingProgramReportingDetailsAndroid>;
+
+  /**
+   * 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 Billing Library 8.2.0+
+   */
+  launchExternalLinkAndroid(
+    params: NitroLaunchExternalLinkParamsAndroid,
+  ): Promise<boolean>;
+
   // ╔════════════════════════════════════════════════════════════════════════╗
   // ║                EXTERNAL PURCHASE LINKS (iOS 16.0+)                     ║
   // ╚════════════════════════════════════════════════════════════════════════╝