expo-iap 3.1.38 → 3.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-iap",
-  "version": "3.1.38",
+  "version": "3.2.1",
   "description": "In App Purchase module in Expo",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/plugin/build/withIAP.d.ts

@@ -1,6 +1,12 @@
 import { ConfigPlugin } from 'expo/config-plugins';
 import { withIosAlternativeBilling, type IOSAlternativeBillingConfig } from './withIosAlternativeBilling';
 export interface ExpoIapPluginOptions {
+    /**
+     * IAPKit API key for server-side receipt verification.
+     * Get your API key from https://iapkit.com
+     * This will be available via `Constants.expoConfig?.extra?.iapkitApiKey`
+     */
+    iapkitApiKey?: string;
     /** Local development path for OpenIAP library */
     localPath?: string | {
         ios?: string;
@@ -46,11 +52,8 @@ export interface ExpoIapPluginOptions {
          */
         horizonAppId?: string;
     };
-    /** @deprecated Use ios.alternativeBilling instead */
-    iosAlternativeBilling?: IOSAlternativeBillingConfig;
-    /** @deprecated Use android.horizonAppId instead */
-    horizonAppId?: string;
 }
-export { withIosAlternativeBilling };
+declare const withIap: ConfigPlugin<ExpoIapPluginOptions | void>;
+export { withIosAlternativeBilling, withIap };
 declare const _default: ConfigPlugin<void | ExpoIapPluginOptions>;
 export default _default;

package/plugin/build/withIAP.js

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withIosAlternativeBilling = void 0;
+exports.withIap = exports.withIosAlternativeBilling = void 0;
 const config_plugins_1 = require("expo/config-plugins");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -219,10 +219,18 @@ const withIapIOS = (config, options) => {
 };
 const withIap = (config, options) => {
     try {
+        // Add iapkitApiKey to extra if provided
+        if (options?.iapkitApiKey) {
+            config.extra = {
+                ...config.extra,
+                iapkitApiKey: options.iapkitApiKey,
+            };
+            logOnce('🔑 [expo-iap] Added iapkitApiKey to config.extra');
+        }
         // Read Horizon configuration from modules
         const isHorizonEnabled = options?.modules?.horizon ?? false;
-        const horizonAppId = options?.android?.horizonAppId ?? options?.horizonAppId;
-        const iosAlternativeBilling = options?.ios?.alternativeBilling ?? options?.iosAlternativeBilling;
+        const horizonAppId = options?.android?.horizonAppId;
+        const iosAlternativeBilling = options?.ios?.alternativeBilling;
         logOnce(`🔍 [expo-iap] Config values: horizonAppId=${horizonAppId}, isHorizonEnabled=${isHorizonEnabled}`);
         // Respect explicit flag; fall back to presence of localPath only when flag is unset
         const isLocalDev = options?.enableLocalDev ?? !!options?.localPath;
@@ -270,4 +278,5 @@ const withIap = (config, options) => {
         return config;
     }
 };
+exports.withIap = withIap;
 exports.default = (0, config_plugins_1.createRunOncePlugin)(withIap, pkg.name, pkg.version);

package/plugin/src/withIAP.ts

@@ -289,6 +289,12 @@ const withIapIOS: ConfigPlugin<IOSAlternativeBillingConfig | undefined> = (
 };
 
 export interface ExpoIapPluginOptions {
+  /**
+   * IAPKit API key for server-side receipt verification.
+   * Get your API key from https://iapkit.com
+   * This will be available via `Constants.expoConfig?.extra?.iapkitApiKey`
+   */
+  iapkitApiKey?: string;
   /** Local development path for OpenIAP library */
   localPath?:
     | string
@@ -336,10 +342,6 @@ export interface ExpoIapPluginOptions {
      */
     horizonAppId?: string;
   };
-  /** @deprecated Use ios.alternativeBilling instead */
-  iosAlternativeBilling?: IOSAlternativeBillingConfig;
-  /** @deprecated Use android.horizonAppId instead */
-  horizonAppId?: string;
 }
 
 const withIap: ConfigPlugin<ExpoIapPluginOptions | void> = (
@@ -347,13 +349,20 @@ const withIap: ConfigPlugin<ExpoIapPluginOptions | void> = (
   options,
 ) => {
   try {
+    // Add iapkitApiKey to extra if provided
+    if (options?.iapkitApiKey) {
+      config.extra = {
+        ...config.extra,
+        iapkitApiKey: options.iapkitApiKey,
+      };
+      logOnce('🔑 [expo-iap] Added iapkitApiKey to config.extra');
+    }
+
     // Read Horizon configuration from modules
     const isHorizonEnabled = options?.modules?.horizon ?? false;
 
-    const horizonAppId =
-      options?.android?.horizonAppId ?? options?.horizonAppId;
-    const iosAlternativeBilling =
-      options?.ios?.alternativeBilling ?? options?.iosAlternativeBilling;
+    const horizonAppId = options?.android?.horizonAppId;
+    const iosAlternativeBilling = options?.ios?.alternativeBilling;
 
     logOnce(
       `🔍 [expo-iap] Config values: horizonAppId=${horizonAppId}, isHorizonEnabled=${isHorizonEnabled}`,
@@ -416,5 +425,5 @@ const withIap: ConfigPlugin<ExpoIapPluginOptions | void> = (
   }
 };
 
-export {withIosAlternativeBilling};
+export {withIosAlternativeBilling, withIap};
 export default createRunOncePlugin(withIap, pkg.name, pkg.version);

package/src/index.ts

@@ -424,24 +424,28 @@ function normalizeRequestProps(
     | RequestSubscriptionPropsByPlatforms,
   platform: 'ios' | 'android',
 ) {
-  // Platform-specific format - directly return the appropriate platform data
-  return platform === 'ios' ? request.ios : request.android;
+  // Support both new (apple/google) and legacy (ios/android) field names
+  // New fields take precedence over deprecated ones
+  if (platform === 'ios') {
+    return request.apple ?? request.ios;
+  }
+  return request.google ?? request.android;
 }
 
 /**
  * Request a purchase for products or subscriptions.
  *
  * @param requestObj - Purchase request configuration
- * @param requestObj.request - Platform-specific purchase parameters
+ * @param requestObj.request - Store-specific purchase parameters
  * @param requestObj.type - Type of purchase: 'in-app' for products (default) or 'subs' for subscriptions
  *
  * @example
  * ```typescript
- * // Product purchase
+ * // Product purchase (recommended: use apple/google)
  * await requestPurchase({
  *   request: {
- *     ios: { sku: productId },
- *     android: { skus: [productId] }
+ *     apple: { sku: productId },
+ *     google: { skus: [productId] }
  *   },
  *   type: 'in-app'
  * });
@@ -449,14 +453,23 @@ function normalizeRequestProps(
  * // Subscription purchase
  * await requestPurchase({
  *   request: {
- *     ios: { sku: subscriptionId },
- *     android: {
+ *     apple: { sku: subscriptionId },
+ *     google: {
  *       skus: [subscriptionId],
  *       subscriptionOffers: [{ sku: subscriptionId, offerToken: 'token' }]
  *     }
  *   },
  *   type: 'subs'
  * });
+ *
+ * // Legacy format (deprecated, but still supported)
+ * await requestPurchase({
+ *   request: {
+ *     ios: { sku: productId },
+ *     android: { skus: [productId] }
+ *   },
+ *   type: 'in-app'
+ * });
  * ```
  */
 export const requestPurchase: MutationField<'requestPurchase'> = async (
@@ -471,12 +484,12 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
 
     if (!normalizedRequest?.sku) {
       throw new Error(
-        'Invalid request for iOS. The `sku` property is required and must be a string.\n\n' +
+        'Invalid request for Apple. The `sku` property is required and must be a string.\n\n' +
           'Expected format:\n' +
           '  requestPurchase({\n' +
           '    request: {\n' +
-          '      android: { skus: ["product_id"] },\n' +
-          '      ios: { sku: "product_id" }\n' +
+          '      apple: { sku: "product_id" },\n' +
+          '      google: { skus: ["product_id"] }\n' +
           '    },\n' +
           '    type: "in-app"\n' +
           '  })\n\n' +
@@ -519,12 +532,12 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
 
       if (!normalizedRequest?.skus?.length) {
         throw new Error(
-          'Invalid request for Android. The `skus` property is required and must be a non-empty array.\n\n' +
+          'Invalid request for Google. The `skus` property is required and must be a non-empty array.\n\n' +
             'Expected format:\n' +
             '  requestPurchase({\n' +
             '    request: {\n' +
-            '      android: { skus: ["product_id"] },\n' +
-            '      ios: { sku: "product_id" }\n' +
+            '      apple: { sku: "product_id" },\n' +
+            '      google: { skus: ["product_id"] }\n' +
             '    },\n' +
             '    type: "in-app"\n' +
             '  })\n\n' +
@@ -561,12 +574,12 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
 
       if (!normalizedRequest?.skus?.length) {
         throw new Error(
-          'Invalid request for Android. The `skus` property is required and must be a non-empty array.\n\n' +
+          'Invalid request for Google. The `skus` property is required and must be a non-empty array.\n\n' +
             'Expected format:\n' +
             '  requestPurchase({\n' +
             '    request: {\n' +
-            '      android: { skus: ["subscription_id"] },\n' +
-            '      ios: { sku: "subscription_id" }\n' +
+            '      apple: { sku: "subscription_id" },\n' +
+            '      google: { skus: ["subscription_id"] }\n' +
             '    },\n' +
             '    type: "subs"\n' +
             '  })\n\n' +
@@ -714,29 +727,33 @@ export const deepLinkToSubscriptions: MutationField<
 export const validateReceipt: MutationField<'validateReceipt'> = async (
   options,
 ) => {
-  const {sku, androidOptions} = options as MutationValidateReceiptArgs;
+  const {apple, google} = options as MutationValidateReceiptArgs;
 
   if (Platform.OS === 'ios') {
-    return validateReceiptIOS({sku});
+    if (!apple?.sku) {
+      throw new Error('iOS validation requires apple.sku');
+    }
+    return validateReceiptIOS({apple: {sku: apple.sku}});
   }
 
   if (Platform.OS === 'android') {
     if (
-      !androidOptions ||
-      !androidOptions.packageName ||
-      !androidOptions.productToken ||
-      !androidOptions.accessToken
+      !google ||
+      !google.sku ||
+      !google.packageName ||
+      !google.purchaseToken ||
+      !google.accessToken
     ) {
       throw new Error(
-        'Android validation requires packageName, productToken, and accessToken',
+        'Android validation requires google.sku, google.packageName, google.purchaseToken, and google.accessToken',
       );
     }
     return validateReceiptAndroid({
-      packageName: androidOptions.packageName,
-      productId: sku,
-      productToken: androidOptions.productToken,
-      accessToken: androidOptions.accessToken,
-      isSub: androidOptions.isSub ?? undefined,
+      packageName: google.packageName,
+      productId: google.sku,
+      productToken: google.purchaseToken,
+      accessToken: google.accessToken,
+      isSub: google.isSub ?? undefined,
     });
   }
 

package/src/modules/android.ts

@@ -6,7 +6,11 @@ import ExpoIapModule from '../ExpoIapModule';
 
 // Types
 import type {
+  BillingProgramAndroid,
+  BillingProgramAvailabilityResultAndroid,
+  BillingProgramReportingDetailsAndroid,
   DeepLinkOptions,
+  LaunchExternalLinkParamsAndroid,
   MutationField,
   VerifyPurchaseResultAndroid,
 } from '../types';
@@ -248,3 +252,74 @@ export const createAlternativeBillingTokenAndroid: MutationField<
 > = async (sku?: string) => {
   return ExpoIapModule.createAlternativeBillingTokenAndroid(sku);
 };
+
+// ============================================================================
+// Billing Programs API (Google Play Billing Library 8.2.0+)
+// ============================================================================
+
+/**
+ * Check if a specific billing program is available for this user/device (Android only).
+ * Available in Google Play Billing Library 8.2.0+.
+ *
+ * @param program - The billing program to check ('external-offer' or 'external-content-link')
+ * @returns Promise resolving to availability result
+ *
+ * @example
+ * ```typescript
+ * const result = await isBillingProgramAvailableAndroid('external-offer');
+ * if (result.isAvailable) {
+ *   // Proceed with billing program flow
+ * }
+ * ```
+ */
+export const isBillingProgramAvailableAndroid = async (
+  program: BillingProgramAndroid,
+): Promise<BillingProgramAvailabilityResultAndroid> => {
+  return ExpoIapModule.isBillingProgramAvailableAndroid(program);
+};
+
+/**
+ * Launch an external link for the specified billing program (Android only).
+ * Available in Google Play Billing Library 8.2.0+.
+ *
+ * @param params - The external link parameters
+ * @returns Promise resolving when the link is launched
+ *
+ * @example
+ * ```typescript
+ * await launchExternalLinkAndroid({
+ *   billingProgram: 'external-offer',
+ *   launchMode: 'launch-in-external-browser-or-app',
+ *   linkType: 'link-to-digital-content-offer',
+ *   linkUri: 'https://your-payment-site.com',
+ * });
+ * ```
+ */
+export const launchExternalLinkAndroid = async (
+  params: LaunchExternalLinkParamsAndroid,
+): Promise<void> => {
+  return ExpoIapModule.launchExternalLinkAndroid(params);
+};
+
+/**
+ * Create billing program reporting details for Google Play reporting (Android only).
+ * Available in Google Play Billing Library 8.2.0+.
+ *
+ * Must be called AFTER successful payment in your payment system.
+ * Token must be reported to Google Play backend within 24 hours.
+ *
+ * @param program - The billing program type
+ * @returns Promise resolving to reporting details including the external transaction token
+ *
+ * @example
+ * ```typescript
+ * const details = await createBillingProgramReportingDetailsAndroid('external-offer');
+ * // Report details.externalTransactionToken to Google Play within 24 hours
+ * await reportToGooglePlay(details.externalTransactionToken);
+ * ```
+ */
+export const createBillingProgramReportingDetailsAndroid = async (
+  program: BillingProgramAndroid,
+): Promise<BillingProgramReportingDetailsAndroid> => {
+  return ExpoIapModule.createBillingProgramReportingDetailsAndroid(program);
+};

package/src/modules/ios.ts

@@ -237,10 +237,12 @@ export const getTransactionJwsIOS: QueryField<'getTransactionJwsIOS'> = async (
  */
 const validateReceiptIOSImpl = async (props: VerifyPurchaseProps | string) => {
   const sku =
-    typeof props === 'string' ? props : (props as VerifyPurchaseProps)?.sku;
+    typeof props === 'string'
+      ? props
+      : (props as VerifyPurchaseProps)?.apple?.sku;
 
   if (!sku) {
-    throw new Error('validateReceiptIOS requires a SKU');
+    throw new Error('validateReceiptIOS requires a SKU (via apple.sku)');
   }
 
   return (await ExpoIapModule.validateReceiptIOS(