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

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);

package/src/specs/RnIap.nitro.ts

@@ -14,8 +14,9 @@ import type {
   ProductCommon,
   PurchaseCommon,
   PurchaseOptions,
-  VerifyPurchaseAndroidOptions,
-  VerifyPurchaseProps,
+  VerifyPurchaseAppleOptions,
+  VerifyPurchaseGoogleOptions,
+  VerifyPurchaseHorizonOptions,
   VerifyPurchaseResultAndroid,
   RequestPurchaseIosProps,
   RequestPurchaseResult,
@@ -64,18 +65,30 @@ export type ExternalLinkTypeAndroid =
 // ║                                  PARAMS                                  ║
 // ╚══════════════════════════════════════════════════════════════════════════╝
 
-// Receipt validation parameters
+// Receipt validation parameters (platform-specific)
 
-export interface NitroReceiptValidationAndroidOptions {
-  accessToken: VerifyPurchaseAndroidOptions['accessToken'];
-  isSub?: VerifyPurchaseAndroidOptions['isSub'];
-  packageName: VerifyPurchaseAndroidOptions['packageName'];
-  productToken: VerifyPurchaseAndroidOptions['productToken'];
+export interface NitroReceiptValidationAppleOptions {
+  sku: VerifyPurchaseAppleOptions['sku'];
+}
+
+export interface NitroReceiptValidationGoogleOptions {
+  accessToken: VerifyPurchaseGoogleOptions['accessToken'];
+  isSub?: VerifyPurchaseGoogleOptions['isSub'];
+  packageName: VerifyPurchaseGoogleOptions['packageName'];
+  purchaseToken: VerifyPurchaseGoogleOptions['purchaseToken'];
+  sku: VerifyPurchaseGoogleOptions['sku'];
+}
+
+export interface NitroReceiptValidationHorizonOptions {
+  accessToken: VerifyPurchaseHorizonOptions['accessToken'];
+  sku: VerifyPurchaseHorizonOptions['sku'];
+  userId: VerifyPurchaseHorizonOptions['userId'];
 }
 
 export interface NitroReceiptValidationParams {
-  sku: VerifyPurchaseProps['sku'];
-  androidOptions?: NitroReceiptValidationAndroidOptions | null;
+  apple?: NitroReceiptValidationAppleOptions | null;
+  google?: NitroReceiptValidationGoogleOptions | null;
+  horizon?: NitroReceiptValidationHorizonOptions | null;
 }
 
 // Purchase request parameters
@@ -822,6 +835,7 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
 
   /**
    * Validate a receipt on the appropriate platform
+   * @deprecated Use `verifyPurchase` instead. This function will be removed in a future version.
    * @param params - Receipt validation parameters including SKU and platform-specific options
    * @returns Promise<NitroReceiptValidationResultIOS | NitroReceiptValidationResultAndroid> - Platform-specific validation result
    */

package/src/types.ts

@@ -917,6 +917,14 @@ export type RequestPurchaseProps =
       useAlternativeBilling?: boolean | null;
     };
 
+/**
+ * Platform-specific purchase request parameters.
+ *
+ * Note: "Platforms" refers to the SDK/OS level (apple, google), not the store.
+ * - apple: Always targets App Store
+ * - google: Targets Play Store by default, or Horizon when built with horizon flavor
+ *   (determined at build time, not runtime)
+ */
 export interface RequestPurchasePropsByPlatforms {
   /** @deprecated Use google instead */
   android?: (RequestPurchaseAndroidProps | null);
@@ -963,6 +971,14 @@ export interface RequestSubscriptionIosProps {
   withOffer?: (DiscountOfferInputIOS | null);
 }
 
+/**
+ * Platform-specific subscription request parameters.
+ *
+ * Note: "Platforms" refers to the SDK/OS level (apple, google), not the store.
+ * - apple: Always targets App Store
+ * - google: Targets Play Store by default, or Horizon when built with horizon flavor
+ *   (determined at build time, not runtime)
+ */
 export interface RequestSubscriptionPropsByPlatforms {
   /** @deprecated Use google instead */
   android?: (RequestSubscriptionAndroidProps | null);
@@ -984,12 +1000,18 @@ export interface RequestVerifyPurchaseWithIapkitGoogleProps {
   purchaseToken: string;
 }
 
+/**
+ * Platform-specific verification parameters for IAPKit.
+ *
+ * - apple: Verifies via App Store (JWS token)
+ * - google: Verifies via Play Store (purchase token)
+ */
 export interface RequestVerifyPurchaseWithIapkitProps {
   /** API key used for the Authorization header (Bearer {apiKey}). */
   apiKey?: (string | null);
-  /** Apple verification parameters. */
+  /** Apple App Store verification parameters. */
   apple?: (RequestVerifyPurchaseWithIapkitAppleProps | null);
-  /** Google verification parameters. */
+  /** Google Play Store verification parameters. */
   google?: (RequestVerifyPurchaseWithIapkitGoogleProps | null);
 }
 
@@ -1088,21 +1110,76 @@ export interface ValidTimeWindowAndroid {
   startTimeMillis: string;
 }
 
-export interface VerifyPurchaseAndroidOptions {
+/**
+ * Apple App Store verification parameters.
+ * Used for server-side receipt validation via App Store Server API.
+ */
+export interface VerifyPurchaseAppleOptions {
+  /** Product SKU to validate */
+  sku: string;
+}
+
+/**
+ * Google Play Store verification parameters.
+ * Used for server-side receipt validation via Google Play Developer API.
+ *
+ * ⚠️ SECURITY: Contains sensitive tokens (accessToken, purchaseToken). Do not log or persist this data.
+ */
+export interface VerifyPurchaseGoogleOptions {
+  /**
+   * Google OAuth2 access token for API authentication.
+   * ⚠️ Sensitive: Do not log this value.
+   */
   accessToken: string;
+  /** Whether this is a subscription purchase (affects API endpoint used) */
   isSub?: (boolean | null);
+  /** Android package name (e.g., com.example.app) */
   packageName: string;
-  productToken: string;
+  /**
+   * Purchase token from the purchase response.
+   * ⚠️ Sensitive: Do not log this value.
+   */
+  purchaseToken: string;
+  /** Product SKU to validate */
+  sku: string;
 }
 
-export interface VerifyPurchaseProps {
-  /** Android-specific validation options */
-  androidOptions?: (VerifyPurchaseAndroidOptions | null);
-  /** Product SKU to validate */
+/**
+ * Meta Horizon (Quest) verification parameters.
+ * Used for server-side entitlement verification via Meta's S2S API.
+ * POST https://graph.oculus.com/$APP_ID/verify_entitlement
+ *
+ * ⚠️ SECURITY: Contains sensitive token (accessToken). Do not log or persist this data.
+ */
+export interface VerifyPurchaseHorizonOptions {
+  /**
+   * Access token for Meta API authentication (OC|$APP_ID|$APP_SECRET or User Access Token).
+   * ⚠️ Sensitive: Do not log this value.
+   */
+  accessToken: string;
+  /** The SKU for the add-on item, defined in Meta Developer Dashboard */
   sku: string;
+  /** The user ID of the user whose purchase you want to verify */
+  userId: string;
 }
 
-export type VerifyPurchaseResult = VerifyPurchaseResultAndroid | VerifyPurchaseResultIOS;
+/**
+ * Platform-specific purchase verification parameters.
+ *
+ * - apple: Verifies via App Store Server API
+ * - google: Verifies via Google Play Developer API
+ * - horizon: Verifies via Meta's S2S API (verify_entitlement endpoint)
+ */
+export interface VerifyPurchaseProps {
+  /** Apple App Store verification parameters. */
+  apple?: (VerifyPurchaseAppleOptions | null);
+  /** Google Play Store verification parameters. */
+  google?: (VerifyPurchaseGoogleOptions | null);
+  /** Meta Horizon (Quest) verification parameters. */
+  horizon?: (VerifyPurchaseHorizonOptions | null);
+}
+
+export type VerifyPurchaseResult = VerifyPurchaseResultAndroid | VerifyPurchaseResultHorizon | VerifyPurchaseResultIOS;
 
 export interface VerifyPurchaseResultAndroid {
   autoRenewing: boolean;
@@ -1125,6 +1202,17 @@ export interface VerifyPurchaseResultAndroid {
   testTransaction: boolean;
 }
 
+/**
+ * Result from Meta Horizon verify_entitlement API.
+ * Returns verification status and grant time for the entitlement.
+ */
+export interface VerifyPurchaseResultHorizon {
+  /** Unix timestamp (seconds) when the entitlement was granted. */
+  grantTime?: (number | null);
+  /** Whether the entitlement verification succeeded. */
+  success: boolean;
+}
+
 export interface VerifyPurchaseResultIOS {
   /** Whether the receipt is valid */
   isValid: boolean;

package/ios/reactnativeiap.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<Workspace
-   version = "1.0">
-   <FileRef
-      location = "self:">
-   </FileRef>
-</Workspace>

package/ios/reactnativeiap.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-	<key>IDEDidComputeMac32BitWarning</key>
-	<true/>
-</dict>
-</plist>

package/plugin/build/src/withIAP.d.ts

@@ -1,3 +0,0 @@
-import type { ConfigPlugin } from 'expo/config-plugins';
-declare const _default: ConfigPlugin<void>;
-export default _default;

package/plugin/build/src/withIAP.js

@@ -1,81 +0,0 @@
-"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

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