expo-iap 3.1.38 → 3.3.0-rc.1

package/build/modules/android.js

@@ -183,4 +183,65 @@ export const showAlternativeBillingDialogAndroid = async () => {
 export const createAlternativeBillingTokenAndroid = async (sku) => {
     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) => {
+    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) => {
+    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) => {
+    return ExpoIapModule.createBillingProgramReportingDetailsAndroid(program);
+};
 //# sourceMappingURL=android.js.map

package/build/modules/android.js.map

@@ -1 +1 @@
-{"version":3,"file":"android.js","sourceRoot":"","sources":["../../src/modules/android.ts"],"names":[],"mappings":"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","sourcesContent":["// External dependencies\nimport {Linking} from 'react-native';\n\n// Internal modules\nimport ExpoIapModule from '../ExpoIapModule';\n\n// Types\nimport type {\n  DeepLinkOptions,\n  MutationField,\n  VerifyPurchaseResultAndroid,\n} from '../types';\n\ntype NativeAndroidModule = {\n  deepLinkToSubscriptionsAndroid?: (params: {\n    skuAndroid?: string;\n    packageNameAndroid?: string;\n  }) => Promise<void> | void;\n  getStorefront?: () => Promise<string> | string;\n};\n\nconst nativeAndroidModule = ExpoIapModule as NativeAndroidModule;\n\n// Type guards\nexport function isProductAndroid<T extends {platform?: string}>(\n  item: unknown,\n): item is T & {platform: 'android'} {\n  return (\n    item != null &&\n    typeof item === 'object' &&\n    'platform' in item &&\n    typeof (item as any).platform === 'string' &&\n    (item as any).platform.toLowerCase() === 'android'\n  );\n}\n\n/**\n * Deep link to subscriptions screen on Android.\n * @param {Object} params - The parameters object\n * @param {string} params.skuAndroid - The product's SKU (on Android)\n * @param {string} params.packageNameAndroid - The package name of your Android app (e.g., 'com.example.app')\n * @returns {Promise<void>}\n *\n * @example\n * ```typescript\n * await deepLinkToSubscriptionsAndroid({\n *   skuAndroid: 'subscription_id',\n *   packageNameAndroid: 'com.example.app'\n * });\n * ```\n */\nexport const deepLinkToSubscriptionsAndroid = async (\n  options?: DeepLinkOptions | null,\n): Promise<void> => {\n  const sku = options?.skuAndroid ?? undefined;\n  const packageName = options?.packageNameAndroid ?? undefined;\n\n  // Prefer native deep link implementation via OpenIAP module\n  if (nativeAndroidModule?.deepLinkToSubscriptionsAndroid) {\n    return nativeAndroidModule.deepLinkToSubscriptionsAndroid({\n      skuAndroid: sku,\n      packageNameAndroid: packageName,\n    });\n  }\n\n  // Fallback to Linking if native method unavailable\n  if (!packageName) {\n    throw new Error(\n      'packageName is required for deepLinkToSubscriptionsAndroid',\n    );\n  }\n  const base = `https://play.google.com/store/account/subscriptions?package=${encodeURIComponent(\n    packageName,\n  )}`;\n  const url = sku ? `${base}&sku=${encodeURIComponent(sku)}` : base;\n  return Linking.openURL(url);\n};\n\n/**\n * Validate receipt for Android. NOTE: This method is here for debugging purposes only. Including\n * your access token in the binary you ship to users is potentially dangerous.\n * Use server side validation instead for your production builds\n *\n * @deprecated Use verifyPurchase instead\n * @param {Object} params - The parameters object\n * @param {string} params.packageName - package name of your app.\n * @param {string} params.productId - product id for your in app product.\n * @param {string} params.productToken - token for your purchase (called 'token' in the API documentation).\n * @param {string} params.accessToken - OAuth access token with androidpublisher scope. Required for authentication.\n * @param {boolean} params.isSub - whether this is subscription or in-app. `true` for subscription.\n * @returns {Promise<ReceiptAndroid>}\n */\nexport const validateReceiptAndroid = async ({\n  packageName,\n  productId,\n  productToken,\n  accessToken,\n  isSub,\n}: {\n  packageName: string;\n  productId: string;\n  productToken: string;\n  accessToken: string;\n  isSub?: boolean;\n}): Promise<VerifyPurchaseResultAndroid> => {\n  const type = isSub ? 'subscriptions' : 'products';\n\n  const url =\n    'https://androidpublisher.googleapis.com/androidpublisher/v3/applications' +\n    `/${packageName}/purchases/${type}/${productId}` +\n    `/tokens/${productToken}`;\n\n  const response = await fetch(url, {\n    method: 'GET',\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${accessToken}`,\n    },\n  });\n\n  if (!response.ok) {\n    throw Object.assign(new Error(response.statusText), {\n      statusCode: response.status,\n    });\n  }\n\n  return response.json();\n};\n\n/**\n * Acknowledge a product (on Android.) No-op on iOS.\n * @param {Object} params - The parameters object\n * @param {string} params.token - The product's token (on Android)\n * @returns {Promise<VoidResult | void>}\n */\nexport const acknowledgePurchaseAndroid: MutationField<\n  'acknowledgePurchaseAndroid'\n> = async (purchaseToken) => {\n  const result = await ExpoIapModule.acknowledgePurchaseAndroid(purchaseToken);\n\n  if (typeof result === 'boolean') {\n    return result;\n  }\n\n  if (result && typeof result === 'object') {\n    const record = result as Record<string, unknown>;\n    if (typeof record.success === 'boolean') {\n      return record.success;\n    }\n    if (typeof record.responseCode === 'number') {\n      return record.responseCode === 0;\n    }\n  }\n\n  return true;\n};\n\n/**\n * Open the Google Play Store to redeem offer codes (Android only).\n * Note: Google Play does not provide a direct API to redeem codes within the app.\n * This function opens the Play Store where users can manually enter their codes.\n *\n * @returns {Promise<void>}\n */\nexport const openRedeemOfferCodeAndroid = async (): Promise<void> => {\n  return Linking.openURL(`https://play.google.com/redeem?code=`);\n};\n\n/**\n * Check if alternative billing is available for this user/device (Android only).\n * Step 1 of alternative billing flow.\n *\n * Returns true if available, false otherwise.\n * Throws OpenIapError.NotPrepared if billing client not ready.\n *\n * @returns {Promise<boolean>}\n *\n * @example\n * ```typescript\n * const isAvailable = await checkAlternativeBillingAvailabilityAndroid();\n * if (isAvailable) {\n *   // Proceed with alternative billing flow\n * }\n * ```\n */\nexport const checkAlternativeBillingAvailabilityAndroid: MutationField<\n  'checkAlternativeBillingAvailabilityAndroid'\n> = async () => {\n  return ExpoIapModule.checkAlternativeBillingAvailabilityAndroid();\n};\n\n/**\n * Show alternative billing information dialog to user (Android only).\n * Step 2 of alternative billing flow.\n * Must be called BEFORE processing payment in your payment system.\n *\n * Returns true if user accepted, false if user canceled.\n * Throws OpenIapError.NotPrepared if billing client not ready.\n *\n * @returns {Promise<boolean>}\n *\n * @example\n * ```typescript\n * const userAccepted = await showAlternativeBillingDialogAndroid();\n * if (userAccepted) {\n *   // Process payment in your payment system\n *   const success = await processCustomPayment();\n *   if (success) {\n *     // Create reporting token\n *     const token = await createAlternativeBillingTokenAndroid();\n *     // Send token to your backend for Google Play reporting\n *   }\n * }\n * ```\n */\nexport const showAlternativeBillingDialogAndroid: MutationField<\n  'showAlternativeBillingDialogAndroid'\n> = async () => {\n  return ExpoIapModule.showAlternativeBillingDialogAndroid();\n};\n\n/**\n * Create external transaction token for Google Play reporting (Android only).\n * Step 3 of alternative billing flow.\n * Must be called AFTER successful payment in your payment system.\n * Token must be reported to Google Play backend within 24 hours.\n *\n * Returns token string, or null if creation failed.\n * Throws OpenIapError.NotPrepared if billing client not ready.\n *\n * @param {string} sku - The product SKU that was purchased\n * @returns {Promise<string | null>}\n *\n * @example\n * ```typescript\n * const token = await createAlternativeBillingTokenAndroid('premium_subscription');\n * if (token) {\n *   // Send token to your backend\n *   await fetch('/api/report-transaction', {\n *     method: 'POST',\n *     body: JSON.stringify({ token, sku: 'premium_subscription' })\n *   });\n * }\n * ```\n */\nexport const createAlternativeBillingTokenAndroid: MutationField<\n  'createAlternativeBillingTokenAndroid'\n> = async (sku?: string) => {\n  return ExpoIapModule.createAlternativeBillingTokenAndroid(sku);\n};\n"]}
+{"version":3,"file":"android.js","sourceRoot":"","sources":["../../src/modules/android.ts"],"names":[],"mappings":"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","sourcesContent":["// External dependencies\nimport {Linking} from 'react-native';\n\n// Internal modules\nimport ExpoIapModule from '../ExpoIapModule';\n\n// Types\nimport type {\n  BillingProgramAndroid,\n  BillingProgramAvailabilityResultAndroid,\n  BillingProgramReportingDetailsAndroid,\n  DeepLinkOptions,\n  LaunchExternalLinkParamsAndroid,\n  MutationField,\n  VerifyPurchaseResultAndroid,\n} from '../types';\n\ntype NativeAndroidModule = {\n  deepLinkToSubscriptionsAndroid?: (params: {\n    skuAndroid?: string;\n    packageNameAndroid?: string;\n  }) => Promise<void> | void;\n  getStorefront?: () => Promise<string> | string;\n};\n\nconst nativeAndroidModule = ExpoIapModule as NativeAndroidModule;\n\n// Type guards\nexport function isProductAndroid<T extends {platform?: string}>(\n  item: unknown,\n): item is T & {platform: 'android'} {\n  return (\n    item != null &&\n    typeof item === 'object' &&\n    'platform' in item &&\n    typeof (item as any).platform === 'string' &&\n    (item as any).platform.toLowerCase() === 'android'\n  );\n}\n\n/**\n * Deep link to subscriptions screen on Android.\n * @param {Object} params - The parameters object\n * @param {string} params.skuAndroid - The product's SKU (on Android)\n * @param {string} params.packageNameAndroid - The package name of your Android app (e.g., 'com.example.app')\n * @returns {Promise<void>}\n *\n * @example\n * ```typescript\n * await deepLinkToSubscriptionsAndroid({\n *   skuAndroid: 'subscription_id',\n *   packageNameAndroid: 'com.example.app'\n * });\n * ```\n */\nexport const deepLinkToSubscriptionsAndroid = async (\n  options?: DeepLinkOptions | null,\n): Promise<void> => {\n  const sku = options?.skuAndroid ?? undefined;\n  const packageName = options?.packageNameAndroid ?? undefined;\n\n  // Prefer native deep link implementation via OpenIAP module\n  if (nativeAndroidModule?.deepLinkToSubscriptionsAndroid) {\n    return nativeAndroidModule.deepLinkToSubscriptionsAndroid({\n      skuAndroid: sku,\n      packageNameAndroid: packageName,\n    });\n  }\n\n  // Fallback to Linking if native method unavailable\n  if (!packageName) {\n    throw new Error(\n      'packageName is required for deepLinkToSubscriptionsAndroid',\n    );\n  }\n  const base = `https://play.google.com/store/account/subscriptions?package=${encodeURIComponent(\n    packageName,\n  )}`;\n  const url = sku ? `${base}&sku=${encodeURIComponent(sku)}` : base;\n  return Linking.openURL(url);\n};\n\n/**\n * Validate receipt for Android. NOTE: This method is here for debugging purposes only. Including\n * your access token in the binary you ship to users is potentially dangerous.\n * Use server side validation instead for your production builds\n *\n * @deprecated Use verifyPurchase instead\n * @param {Object} params - The parameters object\n * @param {string} params.packageName - package name of your app.\n * @param {string} params.productId - product id for your in app product.\n * @param {string} params.productToken - token for your purchase (called 'token' in the API documentation).\n * @param {string} params.accessToken - OAuth access token with androidpublisher scope. Required for authentication.\n * @param {boolean} params.isSub - whether this is subscription or in-app. `true` for subscription.\n * @returns {Promise<ReceiptAndroid>}\n */\nexport const validateReceiptAndroid = async ({\n  packageName,\n  productId,\n  productToken,\n  accessToken,\n  isSub,\n}: {\n  packageName: string;\n  productId: string;\n  productToken: string;\n  accessToken: string;\n  isSub?: boolean;\n}): Promise<VerifyPurchaseResultAndroid> => {\n  const type = isSub ? 'subscriptions' : 'products';\n\n  const url =\n    'https://androidpublisher.googleapis.com/androidpublisher/v3/applications' +\n    `/${packageName}/purchases/${type}/${productId}` +\n    `/tokens/${productToken}`;\n\n  const response = await fetch(url, {\n    method: 'GET',\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${accessToken}`,\n    },\n  });\n\n  if (!response.ok) {\n    throw Object.assign(new Error(response.statusText), {\n      statusCode: response.status,\n    });\n  }\n\n  return response.json();\n};\n\n/**\n * Acknowledge a product (on Android.) No-op on iOS.\n * @param {Object} params - The parameters object\n * @param {string} params.token - The product's token (on Android)\n * @returns {Promise<VoidResult | void>}\n */\nexport const acknowledgePurchaseAndroid: MutationField<\n  'acknowledgePurchaseAndroid'\n> = async (purchaseToken) => {\n  const result = await ExpoIapModule.acknowledgePurchaseAndroid(purchaseToken);\n\n  if (typeof result === 'boolean') {\n    return result;\n  }\n\n  if (result && typeof result === 'object') {\n    const record = result as Record<string, unknown>;\n    if (typeof record.success === 'boolean') {\n      return record.success;\n    }\n    if (typeof record.responseCode === 'number') {\n      return record.responseCode === 0;\n    }\n  }\n\n  return true;\n};\n\n/**\n * Open the Google Play Store to redeem offer codes (Android only).\n * Note: Google Play does not provide a direct API to redeem codes within the app.\n * This function opens the Play Store where users can manually enter their codes.\n *\n * @returns {Promise<void>}\n */\nexport const openRedeemOfferCodeAndroid = async (): Promise<void> => {\n  return Linking.openURL(`https://play.google.com/redeem?code=`);\n};\n\n/**\n * Check if alternative billing is available for this user/device (Android only).\n * Step 1 of alternative billing flow.\n *\n * Returns true if available, false otherwise.\n * Throws OpenIapError.NotPrepared if billing client not ready.\n *\n * @returns {Promise<boolean>}\n *\n * @example\n * ```typescript\n * const isAvailable = await checkAlternativeBillingAvailabilityAndroid();\n * if (isAvailable) {\n *   // Proceed with alternative billing flow\n * }\n * ```\n */\nexport const checkAlternativeBillingAvailabilityAndroid: MutationField<\n  'checkAlternativeBillingAvailabilityAndroid'\n> = async () => {\n  return ExpoIapModule.checkAlternativeBillingAvailabilityAndroid();\n};\n\n/**\n * Show alternative billing information dialog to user (Android only).\n * Step 2 of alternative billing flow.\n * Must be called BEFORE processing payment in your payment system.\n *\n * Returns true if user accepted, false if user canceled.\n * Throws OpenIapError.NotPrepared if billing client not ready.\n *\n * @returns {Promise<boolean>}\n *\n * @example\n * ```typescript\n * const userAccepted = await showAlternativeBillingDialogAndroid();\n * if (userAccepted) {\n *   // Process payment in your payment system\n *   const success = await processCustomPayment();\n *   if (success) {\n *     // Create reporting token\n *     const token = await createAlternativeBillingTokenAndroid();\n *     // Send token to your backend for Google Play reporting\n *   }\n * }\n * ```\n */\nexport const showAlternativeBillingDialogAndroid: MutationField<\n  'showAlternativeBillingDialogAndroid'\n> = async () => {\n  return ExpoIapModule.showAlternativeBillingDialogAndroid();\n};\n\n/**\n * Create external transaction token for Google Play reporting (Android only).\n * Step 3 of alternative billing flow.\n * Must be called AFTER successful payment in your payment system.\n * Token must be reported to Google Play backend within 24 hours.\n *\n * Returns token string, or null if creation failed.\n * Throws OpenIapError.NotPrepared if billing client not ready.\n *\n * @param {string} sku - The product SKU that was purchased\n * @returns {Promise<string | null>}\n *\n * @example\n * ```typescript\n * const token = await createAlternativeBillingTokenAndroid('premium_subscription');\n * if (token) {\n *   // Send token to your backend\n *   await fetch('/api/report-transaction', {\n *     method: 'POST',\n *     body: JSON.stringify({ token, sku: 'premium_subscription' })\n *   });\n * }\n * ```\n */\nexport const createAlternativeBillingTokenAndroid: MutationField<\n  'createAlternativeBillingTokenAndroid'\n> = async (sku?: string) => {\n  return ExpoIapModule.createAlternativeBillingTokenAndroid(sku);\n};\n\n// ============================================================================\n// Billing Programs API (Google Play Billing Library 8.2.0+)\n// ============================================================================\n\n/**\n * Check if a specific billing program is available for this user/device (Android only).\n * Available in Google Play Billing Library 8.2.0+.\n *\n * @param program - The billing program to check ('external-offer' or 'external-content-link')\n * @returns Promise resolving to availability result\n *\n * @example\n * ```typescript\n * const result = await isBillingProgramAvailableAndroid('external-offer');\n * if (result.isAvailable) {\n *   // Proceed with billing program flow\n * }\n * ```\n */\nexport const isBillingProgramAvailableAndroid = async (\n  program: BillingProgramAndroid,\n): Promise<BillingProgramAvailabilityResultAndroid> => {\n  return ExpoIapModule.isBillingProgramAvailableAndroid(program);\n};\n\n/**\n * Launch an external link for the specified billing program (Android only).\n * Available in Google Play Billing Library 8.2.0+.\n *\n * @param params - The external link parameters\n * @returns Promise resolving when the link is launched\n *\n * @example\n * ```typescript\n * await launchExternalLinkAndroid({\n *   billingProgram: 'external-offer',\n *   launchMode: 'launch-in-external-browser-or-app',\n *   linkType: 'link-to-digital-content-offer',\n *   linkUri: 'https://your-payment-site.com',\n * });\n * ```\n */\nexport const launchExternalLinkAndroid = async (\n  params: LaunchExternalLinkParamsAndroid,\n): Promise<void> => {\n  return ExpoIapModule.launchExternalLinkAndroid(params);\n};\n\n/**\n * Create billing program reporting details for Google Play reporting (Android only).\n * Available in Google Play Billing Library 8.2.0+.\n *\n * Must be called AFTER successful payment in your payment system.\n * Token must be reported to Google Play backend within 24 hours.\n *\n * @param program - The billing program type\n * @returns Promise resolving to reporting details including the external transaction token\n *\n * @example\n * ```typescript\n * const details = await createBillingProgramReportingDetailsAndroid('external-offer');\n * // Report details.externalTransactionToken to Google Play within 24 hours\n * await reportToGooglePlay(details.externalTransactionToken);\n * ```\n */\nexport const createBillingProgramReportingDetailsAndroid = async (\n  program: BillingProgramAndroid,\n): Promise<BillingProgramReportingDetailsAndroid> => {\n  return ExpoIapModule.createBillingProgramReportingDetailsAndroid(program);\n};\n"]}

package/build/types.d.ts

@@ -56,12 +56,67 @@ export interface AppTransaction {
     preorderDate?: (number | null);
     signedDate: number;
 }
+/**
+ * Billing program types for external content links and external offers (Android)
+ * Available in Google Play Billing Library 8.2.0+
+ */
+export type BillingProgramAndroid = 'unspecified' | 'external-content-link' | 'external-offer';
+/**
+ * Result of checking billing program availability (Android)
+ * Available in Google Play Billing Library 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 transactions made outside of Google Play Billing (Android)
+ * Contains the external transaction token needed for reporting
+ * Available in Google Play Billing Library 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 made outside of Google Play Billing.
+     * This token must be used when reporting the external transaction to Google.
+     */
+    externalTransactionToken: string;
+}
 export interface DeepLinkOptions {
     /** Android package name to target (required on Android) */
     packageNameAndroid?: (string | null);
     /** Android SKU to open (required on Android) */
     skuAndroid?: (string | null);
 }
+/**
+ * Discount amount details for one-time purchase offers (Android)
+ * Available in Google Play Billing Library 7.0+
+ */
+export interface DiscountAmountAndroid {
+    /** Discount amount in micro-units (1,000,000 = 1 unit of currency) */
+    discountAmountMicros: string;
+    /** Formatted discount amount with currency sign (e.g., "$4.99") */
+    formattedDiscountAmount: string;
+}
+/**
+ * Discount display information for one-time purchase offers (Android)
+ * Available in Google Play Billing Library 7.0+
+ */
+export interface DiscountDisplayInfoAndroid {
+    /**
+     * Absolute discount amount details
+     * Only returned for fixed amount discounts
+     */
+    discountAmount?: (DiscountAmountAndroid | null);
+    /**
+     * Percentage discount (e.g., 33 for 33% off)
+     * Only returned for percentage-based discounts
+     */
+    percentageDiscount?: (number | null);
+}
 export interface DiscountIOS {
     identifier: string;
     localizedPrice?: (string | null);
@@ -140,6 +195,36 @@ export declare enum ErrorCode {
     UserCancelled = "user-cancelled",
     UserError = "user-error"
 }
+/**
+ * Launch mode for external link flow (Android)
+ * Determines how the external URL is launched
+ * Available in 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 (Android)
+ * Specifies the type of external link destination
+ * Available in Google Play Billing Library 8.2.0+
+ */
+export type ExternalLinkTypeAndroid = 'unspecified' | 'link-to-digital-content-offer' | 'link-to-app-download';
+/**
+ * External offer availability result (Android)
+ * @deprecated Use BillingProgramAvailabilityResultAndroid with isBillingProgramAvailableAsync instead
+ * Available in Google Play Billing Library 6.2.0+, deprecated in 8.2.0
+ */
+export interface ExternalOfferAvailabilityResultAndroid {
+    /** Whether external offers are available for the user */
+    isAvailable: boolean;
+}
+/**
+ * External offer reporting details (Android)
+ * @deprecated Use BillingProgramReportingDetailsAndroid with createBillingProgramReportingDetailsAsync instead
+ * Available in Google Play Billing Library 6.2.0+, deprecated in 8.2.0
+ */
+export interface ExternalOfferReportingDetailsAndroid {
+    /** External transaction token for reporting external offer transactions */
+    externalTransactionToken: string;
+}
 /** Result of presenting an external purchase link (iOS 18.2+) */
 export interface ExternalPurchaseLinkResultIOS {
     /** Optional error message if the presentation failed */
@@ -159,9 +244,9 @@ export interface ExternalPurchaseNoticeResultIOS {
 export type FetchProductsResult = ProductOrSubscription[] | Product[] | ProductSubscription[] | null;
 export type IapEvent = 'purchase-updated' | 'purchase-error' | 'promoted-product-ios' | 'user-choice-billing-android';
 export type IapPlatform = 'ios' | 'android';
+export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon';
 /** Unified purchase states from IAPKit verification response. */
 export type IapkitPurchaseState = 'entitled' | 'pending-acknowledgment' | 'pending' | 'canceled' | 'expired' | 'ready-to-consume' | 'consumed' | 'unknown' | 'inauthentic';
-export type IapkitStore = 'apple' | 'google';
 /** Connection initialization configuration */
 export interface InitConnectionConfig {
     /**
@@ -170,6 +255,31 @@ export interface InitConnectionConfig {
      */
     alternativeBillingModeAndroid?: (AlternativeBillingModeAndroid | null);
 }
+/**
+ * Parameters for launching an external link (Android)
+ * Used with launchExternalLink to initiate external offer or app install flows
+ * Available in Google Play Billing Library 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;
+}
+/**
+ * Limited quantity information for one-time purchase offers (Android)
+ * Available in Google Play Billing Library 7.0+
+ */
+export interface LimitedQuantityInfoAndroid {
+    /** Maximum quantity a user can purchase */
+    maximumQuantity: number;
+    /** Remaining quantity the user can still purchase */
+    remainingQuantity: number;
+}
 export interface Mutation {
     /** Acknowledge a non-consumable purchase or subscription */
     acknowledgePurchaseAndroid: Promise<boolean>;
@@ -267,6 +377,22 @@ export type MutationValidateReceiptArgs = VerifyPurchaseProps;
 export type MutationVerifyPurchaseArgs = VerifyPurchaseProps;
 export type MutationVerifyPurchaseWithProviderArgs = VerifyPurchaseWithProviderProps;
 export type PaymentModeIOS = 'empty' | 'free-trial' | 'pay-as-you-go' | 'pay-up-front';
+/**
+ * Pre-order details for one-time purchase products (Android)
+ * Available in Google Play Billing Library 8.1.0+
+ */
+export interface PreorderDetailsAndroid {
+    /**
+     * Pre-order presale end time in milliseconds since epoch.
+     * This is when the presale period ends and the product will be released.
+     */
+    preorderPresaleEndTimeMillis: string;
+    /**
+     * Pre-order release time in milliseconds since epoch.
+     * This is when the product will be available to users who pre-ordered.
+     */
+    preorderReleaseTimeMillis: string;
+}
 export interface PricingPhaseAndroid {
     billingCycleCount: number;
     billingPeriod: string;
@@ -287,17 +413,52 @@ export interface ProductAndroid extends ProductCommon {
     displayPrice: string;
     id: string;
     nameAndroid: string;
-    oneTimePurchaseOfferDetailsAndroid?: (ProductAndroidOneTimePurchaseOfferDetail | null);
+    /**
+     * One-time purchase offer details including discounts (Android)
+     * Returns all eligible offers. Available in Google Play Billing Library 7.0+
+     */
+    oneTimePurchaseOfferDetailsAndroid?: (ProductAndroidOneTimePurchaseOfferDetail[] | null);
     platform: 'android';
     price?: (number | null);
     subscriptionOfferDetailsAndroid?: (ProductSubscriptionAndroidOfferDetails[] | null);
     title: string;
     type: 'in-app';
 }
+/**
+ * One-time purchase offer details (Android)
+ * Available in Google Play Billing Library 7.0+
+ */
 export interface ProductAndroidOneTimePurchaseOfferDetail {
+    /**
+     * Discount display information
+     * Only available for discounted offers
+     */
+    discountDisplayInfo?: (DiscountDisplayInfoAndroid | null);
     formattedPrice: string;
+    /**
+     * Full (non-discounted) price in micro-units
+     * Only available for discounted offers
+     */
+    fullPriceMicros?: (string | null);
+    /** Limited quantity information */
+    limitedQuantityInfo?: (LimitedQuantityInfoAndroid | null);
+    /** Offer ID */
+    offerId?: (string | null);
+    /** List of offer tags */
+    offerTags: string[];
+    /** Offer token for use in BillingFlowParams when purchasing */
+    offerToken: string;
+    /**
+     * Pre-order details for products available for pre-order
+     * Available in Google Play Billing Library 8.1.0+
+     */
+    preorderDetailsAndroid?: (PreorderDetailsAndroid | null);
     priceAmountMicros: string;
     priceCurrencyCode: string;
+    /** Rental details for rental offers */
+    rentalDetailsAndroid?: (RentalDetailsAndroid | null);
+    /** Valid time window for the offer */
+    validTimeWindow?: (ValidTimeWindowAndroid | null);
 }
 export interface ProductCommon {
     currency: string;
@@ -343,7 +504,11 @@ export interface ProductSubscriptionAndroid extends ProductCommon {
     displayPrice: string;
     id: string;
     nameAndroid: string;
-    oneTimePurchaseOfferDetailsAndroid?: (ProductAndroidOneTimePurchaseOfferDetail | null);
+    /**
+     * One-time purchase offer details including discounts (Android)
+     * Returns all eligible offers. Available in Google Play Billing Library 7.0+
+     */
+    oneTimePurchaseOfferDetailsAndroid?: (ProductAndroidOneTimePurchaseOfferDetail[] | null);
     platform: 'android';
     price?: (number | null);
     subscriptionOfferDetailsAndroid: ProductSubscriptionAndroidOfferDetails[];
@@ -394,15 +559,26 @@ export interface PurchaseAndroid extends PurchaseCommon {
     ids?: (string[] | null);
     isAcknowledgedAndroid?: (boolean | null);
     isAutoRenewing: boolean;
+    /**
+     * Whether the subscription is suspended (Android)
+     * A suspended subscription means the user's payment method failed and they need to fix it.
+     * Users should be directed to the subscription center to resolve the issue.
+     * Do NOT grant entitlements for suspended subscriptions.
+     * Available in Google Play Billing Library 8.1.0+
+     */
+    isSuspendedAndroid?: (boolean | null);
     obfuscatedAccountIdAndroid?: (string | null);
     obfuscatedProfileIdAndroid?: (string | null);
     packageNameAndroid?: (string | null);
+    /** @deprecated Use store instead */
     platform: IapPlatform;
     productId: string;
     purchaseState: PurchaseState;
     purchaseToken?: (string | null);
     quantity: number;
     signatureAndroid?: (string | null);
+    /** Store where purchase was made */
+    store: IapStore;
     transactionDate: number;
     transactionId?: (string | null);
 }
@@ -417,12 +593,15 @@ export interface PurchaseCommon {
     id: string;
     ids?: (string[] | null);
     isAutoRenewing: boolean;
+    /** @deprecated Use store instead */
     platform: IapPlatform;
     productId: string;
     purchaseState: PurchaseState;
     /** Unified purchase token (iOS JWS, Android purchaseToken) */
     purchaseToken?: (string | null);
     quantity: number;
+    /** Store where purchase was made */
+    store: IapStore;
     transactionDate: number;
 }
 export interface PurchaseError {
@@ -447,6 +626,7 @@ export interface PurchaseIOS extends PurchaseCommon {
     originalTransactionDateIOS?: (number | null);
     originalTransactionIdentifierIOS?: (string | null);
     ownershipTypeIOS?: (string | null);
+    /** @deprecated Use store instead */
     platform: IapPlatform;
     productId: string;
     purchaseState: PurchaseState;
@@ -458,6 +638,8 @@ export interface PurchaseIOS extends PurchaseCommon {
     renewalInfoIOS?: (RenewalInfoIOS | null);
     revocationDateIOS?: (number | null);
     revocationReasonIOS?: (string | null);
+    /** Store where purchase was made */
+    store: IapStore;
     storefrontCountryCodeIOS?: (string | null);
     subscriptionGroupIdIOS?: (string | null);
     transactionDate: number;
@@ -584,6 +766,19 @@ export interface RenewalInfoIOS {
     renewalOfferType?: (string | null);
     willAutoRenew: boolean;
 }
+/**
+ * Rental details for one-time purchase products that can be rented (Android)
+ * Available in Google Play Billing Library 7.0+
+ */
+export interface RentalDetailsAndroid {
+    /**
+     * Rental expiration period in ISO 8601 format
+     * Time after rental period ends when user can still extend
+     */
+    rentalExpirationPeriod?: (string | null);
+    /** Rental period in ISO 8601 format (e.g., P7D for 7 days) */
+    rentalPeriod: string;
+}
 export interface RequestPurchaseAndroidProps {
     /** Personalized offer flag */
     isOfferPersonalized?: (boolean | null);
@@ -620,9 +815,13 @@ export type RequestPurchaseProps = {
     useAlternativeBilling?: boolean | null;
 };
 export interface RequestPurchasePropsByPlatforms {
-    /** Android-specific purchase parameters */
+    /** @deprecated Use google instead */
     android?: (RequestPurchaseAndroidProps | null);
-    /** iOS-specific purchase parameters */
+    /** Apple-specific purchase parameters */
+    apple?: (RequestPurchaseIosProps | null);
+    /** Google-specific purchase parameters */
+    google?: (RequestPurchaseAndroidProps | null);
+    /** @deprecated Use apple instead */
     ios?: (RequestPurchaseIosProps | null);
 }
 export type RequestPurchaseResult = Purchase | Purchase[] | null;
@@ -635,12 +834,20 @@ export interface RequestSubscriptionAndroidProps {
     obfuscatedProfileIdAndroid?: (string | null);
     /** Purchase token for upgrades/downgrades */
     purchaseTokenAndroid?: (string | null);
-    /** Replacement mode for subscription changes */
+    /**
+     * Replacement mode for subscription changes
+     * @deprecated Use subscriptionProductReplacementParams instead for item-level replacement (8.1.0+)
+     */
     replacementModeAndroid?: (number | null);
     /** List of subscription SKUs */
     skus: string[];
     /** Subscription offers */
     subscriptionOffers?: (AndroidSubscriptionOfferInput[] | null);
+    /**
+     * Product-level replacement parameters (8.1.0+)
+     * Use this instead of replacementModeAndroid for item-level replacement
+     */
+    subscriptionProductReplacementParams?: (SubscriptionProductReplacementParamsAndroid | null);
 }
 export interface RequestSubscriptionIosProps {
     andDangerouslyFinishTransactionAutomatically?: (boolean | null);
@@ -650,9 +857,13 @@ export interface RequestSubscriptionIosProps {
     withOffer?: (DiscountOfferInputIOS | null);
 }
 export interface RequestSubscriptionPropsByPlatforms {
-    /** Android-specific subscription parameters */
+    /** @deprecated Use google instead */
     android?: (RequestSubscriptionAndroidProps | null);
-    /** iOS-specific subscription parameters */
+    /** Apple-specific subscription parameters */
+    apple?: (RequestSubscriptionIosProps | null);
+    /** Google-specific subscription parameters */
+    google?: (RequestSubscriptionAndroidProps | null);
+    /** @deprecated Use apple instead */
     ios?: (RequestSubscriptionIosProps | null);
 }
 export interface RequestVerifyPurchaseWithIapkitAppleProps {
@@ -676,7 +887,7 @@ export interface RequestVerifyPurchaseWithIapkitResult {
     isValid: boolean;
     /** The current state of the purchase. */
     state: IapkitPurchaseState;
-    store: IapkitStore;
+    store: IapStore;
 }
 export interface Subscription {
     /** Fires when the App Store surfaces a promoted product (iOS only) */
@@ -712,6 +923,23 @@ export interface SubscriptionPeriodValueIOS {
     unit: SubscriptionPeriodIOS;
     value: number;
 }
+/**
+ * Product-level subscription replacement parameters (Android)
+ * Used with setSubscriptionProductReplacementParams in BillingFlowParams.ProductDetailsParams
+ * Available in Google Play Billing Library 8.1.0+
+ */
+export interface SubscriptionProductReplacementParamsAndroid {
+    /** The old product ID that needs to be replaced */
+    oldProductId: string;
+    /** The replacement mode for this product change */
+    replacementMode: SubscriptionReplacementModeAndroid;
+}
+/**
+ * Replacement mode for subscription changes (Android)
+ * These modes determine how the subscription replacement affects billing.
+ * Available in Google Play Billing Library 8.1.0+
+ */
+export type SubscriptionReplacementModeAndroid = 'unknown-replacement-mode' | 'with-time-proration' | 'charge-prorated-price' | 'charge-full-price' | 'without-proration' | 'deferred' | 'keep-existing';
 export interface SubscriptionStatusIOS {
     renewalInfo?: (RenewalInfoIOS | null);
     state: string;
@@ -726,6 +954,16 @@ export interface UserChoiceBillingDetails {
     /** List of product IDs selected by the user */
     products: string[];
 }
+/**
+ * Valid time window for when an offer is available (Android)
+ * Available in Google Play Billing Library 7.0+
+ */
+export interface ValidTimeWindowAndroid {
+    /** End time in milliseconds since epoch */
+    endTimeMillis: string;
+    /** Start time in milliseconds since epoch */
+    startTimeMillis: string;
+}
 export interface VerifyPurchaseAndroidOptions {
     accessToken: string;
     isSub?: (boolean | null);
@@ -769,13 +1007,19 @@ export interface VerifyPurchaseResultIOS {
     /** Receipt data string */
     receiptData: string;
 }
+export interface VerifyPurchaseWithProviderError {
+    code?: (string | null);
+    message: string;
+}
 export interface VerifyPurchaseWithProviderProps {
     iapkit?: (RequestVerifyPurchaseWithIapkitProps | null);
     provider: PurchaseVerificationProvider;
 }
 export interface VerifyPurchaseWithProviderResult {
-    /** IAPKit verification results (can include Apple and Google entries) */
-    iapkit: RequestVerifyPurchaseWithIapkitResult[];
+    /** Error details if verification failed */
+    errors?: (VerifyPurchaseWithProviderError[] | null);
+    /** IAPKit verification result */
+    iapkit?: (RequestVerifyPurchaseWithIapkitResult | null);
     provider: PurchaseVerificationProvider;
 }
 export type VoidResult = void;