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

package/plugin/build/src/withIAP.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("expo/config-plugins");
+const pkg = require('../../package.json');
+// Global flag to prevent duplicate logs
+let hasLoggedPluginExecution = false;
+const addLineToGradle = (content, anchor, lineToAdd, offset = 1) => {
+    const lines = content.split('\n');
+    const index = lines.findIndex((line) => line.match(anchor));
+    if (index === -1) {
+        console.warn(`Anchor "${anchor}" not found in build.gradle. Appending to end.`);
+        lines.push(lineToAdd);
+    }
+    else {
+        lines.splice(index + offset, 0, lineToAdd);
+    }
+    return lines.join('\n');
+};
+const modifyAppBuildGradle = (gradle) => {
+    let modified = gradle;
+    // Add billing library dependencies to app-level build.gradle
+    const billingDep = `    implementation "com.android.billingclient:billing-ktx:8.0.0"`;
+    const gmsDep = `    implementation "com.google.android.gms:play-services-base:18.1.0"`;
+    let hasAddedDependency = false;
+    if (!modified.includes(billingDep)) {
+        modified = addLineToGradle(modified, /dependencies\s*{/, billingDep);
+        hasAddedDependency = true;
+    }
+    if (!modified.includes(gmsDep)) {
+        modified = addLineToGradle(modified, /dependencies\s*{/, gmsDep, 1);
+        hasAddedDependency = true;
+    }
+    // Log only once and only if we actually added dependencies
+    if (hasAddedDependency && !hasLoggedPluginExecution) {
+        console.log('🛠️ react-native-iap: Added billing dependencies to build.gradle');
+    }
+    return modified;
+};
+const withIapAndroid = (config) => {
+    // Add IAP dependencies to app build.gradle
+    config = (0, config_plugins_1.withAppBuildGradle)(config, (config) => {
+        config.modResults.contents = modifyAppBuildGradle(config.modResults.contents);
+        return config;
+    });
+    config = (0, config_plugins_1.withAndroidManifest)(config, (config) => {
+        const manifest = config.modResults;
+        if (!manifest.manifest['uses-permission']) {
+            manifest.manifest['uses-permission'] = [];
+        }
+        const permissions = manifest.manifest['uses-permission'];
+        const billingPerm = { $: { 'android:name': 'com.android.vending.BILLING' } };
+        const alreadyExists = permissions.some((p) => p.$['android:name'] === 'com.android.vending.BILLING');
+        if (!alreadyExists) {
+            permissions.push(billingPerm);
+            if (!hasLoggedPluginExecution) {
+                console.log('✅ Added com.android.vending.BILLING to AndroidManifest.xml');
+            }
+        }
+        else {
+            if (!hasLoggedPluginExecution) {
+                console.log('ℹ️ com.android.vending.BILLING already exists in AndroidManifest.xml');
+            }
+        }
+        return config;
+    });
+    return config;
+};
+const withIAP = (config, _props) => {
+    try {
+        const result = withIapAndroid(config);
+        // Set flag after first execution to prevent duplicate logs
+        hasLoggedPluginExecution = true;
+        return result;
+    }
+    catch (error) {
+        config_plugins_1.WarningAggregator.addWarningAndroid('react-native-iap', `react-native-iap plugin encountered an error: ${error}`);
+        console.error('react-native-iap plugin error:', error);
+        return config;
+    }
+};
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withIAP, pkg.name, pkg.version);

package/plugin/build/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/withiap.ts"],"version":"5.9.2"}

package/plugin/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/withIAP.ts"],"version":"5.9.2"}
+{"root":["./src/withiap.ts"],"version":"5.9.2"}

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,13 +281,91 @@ 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)
+ */
+export interface NitroDiscountAmountAndroid {
+  discountAmountMicros: string;
+  formattedDiscountAmount: string;
+}
+
+/**
+ * Discount display information for one-time purchase offers (Android)
+ */
+export interface NitroDiscountDisplayInfoAndroid {
+  discountAmount?: NitroDiscountAmountAndroid | null;
+  percentageDiscount?: number | null;
+}
+
+/**
+ * Limited quantity information for one-time purchase offers (Android)
+ */
+export interface NitroLimitedQuantityInfoAndroid {
+  maximumQuantity: number;
+  remainingQuantity: number;
+}
+
+/**
+ * Pre-order details for one-time purchase products (Android)
+ */
+export interface NitroPreorderDetailsAndroid {
+  preorderPresaleEndTimeMillis: string;
+  preorderReleaseTimeMillis: string;
+}
+
+/**
+ * Rental details for one-time purchase products (Android)
+ */
+export interface NitroRentalDetailsAndroid {
+  rentalExpirationPeriod?: string | null;
+  rentalPeriod: string;
+}
+
+/**
+ * Valid time window for when an offer is available (Android)
+ */
+export interface NitroValidTimeWindowAndroid {
+  endTimeMillis: string;
+  startTimeMillis: string;
+}
+
 /**
  * Android one-time purchase offer details
+ * Available in Google Play Billing Library 7.0+
  */
 export interface NitroOneTimePurchaseOfferDetail {
+  discountDisplayInfo?: NitroDiscountDisplayInfoAndroid | null;
   formattedPrice: string;
+  fullPriceMicros?: string | null;
+  limitedQuantityInfo?: NitroLimitedQuantityInfoAndroid | null;
+  offerId?: string | null;
+  offerTags: string[];
+  offerToken: string;
+  preorderDetailsAndroid?: NitroPreorderDetailsAndroid | null;
   priceAmountMicros: string;
   priceCurrencyCode: string;
+  rentalDetailsAndroid?: NitroRentalDetailsAndroid | null;
+  validTimeWindow?: NitroValidTimeWindowAndroid | null;
 }
 
 export interface NitroPurchase {
@@ -306,6 +414,7 @@ export interface NitroPurchase {
   obfuscatedAccountIdAndroid?: string | null;
   obfuscatedProfileIdAndroid?: string | null;
   developerPayloadAndroid?: string | null;
+  isSuspendedAndroid?: boolean | null;
 }
 
 /**
@@ -380,7 +489,7 @@ export interface NitroProduct {
   subscriptionPeriodAndroid?: string | null;
   freeTrialPeriodAndroid?: string | null;
   subscriptionOfferDetailsAndroid?: string | null;
-  oneTimePurchaseOfferDetailsAndroid?: NitroOneTimePurchaseOfferDetail | null;
+  oneTimePurchaseOfferDetailsAndroid?: NitroOneTimePurchaseOfferDetail[] | null;
 }
 
 // ╔══════════════════════════════════════════════════════════════════════════╗
@@ -811,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+)                     ║
   // ╚════════════════════════════════════════════════════════════════════════╝