expo-iap 4.5.2 → 4.7.0

package/build/modules/android.js

@@ -1,8 +1,22 @@
 // External dependencies
-import { Linking } from 'react-native';
+import { Linking, Platform } from 'react-native';
 // Internal modules
 import ExpoIapModule from '../ExpoIapModule';
+import { isVegaOS } from '../vega';
 const nativeAndroidModule = ExpoIapModule;
+/**
+ * Enforce the documented Android-only contract. Vega OS is treated as an
+ * Android store runtime (matching `isAndroidStoreRuntime` in src/index.ts),
+ * so it passes through. Without this guard, calling a suffixed wrapper on
+ * another platform falls through to the native proxy and surfaces as an
+ * opaque `TypeError: ExpoIapModule.<name> is not a function` instead of the
+ * promised platform error.
+ */
+const requireAndroidPlatform = (methodName) => {
+    if (Platform.OS !== 'android' && !isVegaOS()) {
+        throw new Error(`${methodName} is only available on Android and Vega OS`);
+    }
+};
 // Type guards
 export function isProductAndroid(item) {
     return (item != null &&
@@ -85,6 +99,7 @@ export const validateReceiptAndroid = async ({ packageName, productId, productTo
  * @see {@link https://openiap.dev/docs/apis/android/consume-purchase-android}
  */
 export const consumePurchaseAndroid = async (purchaseToken) => {
+    requireAndroidPlatform('consumePurchaseAndroid');
     const result = await ExpoIapModule.consumePurchaseAndroid(purchaseToken);
     if (typeof result === 'boolean') {
         return result;
@@ -101,14 +116,16 @@ export const consumePurchaseAndroid = async (purchaseToken) => {
     throw new Error(`consumePurchaseAndroid returned an unexpected response payload: ${JSON.stringify(result)}`);
 };
 /**
- * Acknowledge a product (on Android.) No-op on iOS.
+ * Acknowledge a non-consumable purchase or subscription (Android only).
  * @param {Object} params - The parameters object
  * @param {string} params.token - The product's token (on Android)
  * @returns {Promise<VoidResult | void>}
+ * @throws Error if called on a non-Android platform
  *
  * @see {@link https://openiap.dev/docs/apis/android/acknowledge-purchase-android}
  */
 export const acknowledgePurchaseAndroid = async (purchaseToken) => {
+    requireAndroidPlatform('acknowledgePurchaseAndroid');
     const result = await ExpoIapModule.acknowledgePurchaseAndroid(purchaseToken);
     if (typeof result === 'boolean') {
         return result;
@@ -125,14 +142,23 @@ export const acknowledgePurchaseAndroid = async (purchaseToken) => {
     return true;
 };
 /**
- * Open the Google Play Store to redeem offer codes (Android only).
- * Note: Google Play does not provide a direct API to redeem codes within the app.
- * This function opens the Play Store where users can manually enter their codes.
+ * Open the Google Play offer/promo code redemption flow so the user can enter a code (Android only).
+ * On Play builds, launches the Play Store redeem page. A listener can receive
+ * the purchase while the app has an active billing connection; reconcile
+ * available purchases when the app resumes. Unsupported store flavors return false.
+ * Does not require the billing client to be initialized (no Play Billing version requirement).
+ * Android counterpart of presentCodeRedemptionSheetIOS.
  *
- * @returns {Promise<void>}
+ * @returns Promise resolving to true when launched, or false when unsupported
+ *
+ * @see {@link https://openiap.dev/docs/apis/android/open-redeem-offer-code-android}
  */
 export const openRedeemOfferCodeAndroid = async () => {
-    return Linking.openURL(`https://play.google.com/redeem?code=`);
+    requireAndroidPlatform('openRedeemOfferCodeAndroid');
+    if (isVegaOS()) {
+        return false;
+    }
+    return ExpoIapModule.openRedeemOfferCodeAndroid();
 };
 /**
  * Check if alternative billing is available for this user/device (Android only).
@@ -154,6 +180,7 @@ export const openRedeemOfferCodeAndroid = async () => {
  * @see {@link https://openiap.dev/docs/apis/android/check-alternative-billing-availability-android}
  */
 export const checkAlternativeBillingAvailabilityAndroid = async () => {
+    requireAndroidPlatform('checkAlternativeBillingAvailabilityAndroid');
     return ExpoIapModule.checkAlternativeBillingAvailabilityAndroid();
 };
 /**
@@ -183,6 +210,7 @@ export const checkAlternativeBillingAvailabilityAndroid = async () => {
  * @see {@link https://openiap.dev/docs/apis/android/show-alternative-billing-dialog-android}
  */
 export const showAlternativeBillingDialogAndroid = async () => {
+    requireAndroidPlatform('showAlternativeBillingDialogAndroid');
     return ExpoIapModule.showAlternativeBillingDialogAndroid();
 };
 /**
@@ -212,6 +240,7 @@ export const showAlternativeBillingDialogAndroid = async () => {
  * @see {@link https://openiap.dev/docs/apis/android/create-alternative-billing-token-android}
  */
 export const createAlternativeBillingTokenAndroid = async (sku) => {
+    requireAndroidPlatform('createAlternativeBillingTokenAndroid');
     return ExpoIapModule.createAlternativeBillingTokenAndroid(sku);
 };
 // ============================================================================
@@ -236,6 +265,7 @@ export const createAlternativeBillingTokenAndroid = async (sku) => {
  * @see {@link https://openiap.dev/docs/apis/android/is-billing-program-available-android}
  */
 export const isBillingProgramAvailableAndroid = async (program) => {
+    requireAndroidPlatform('isBillingProgramAvailableAndroid');
     return ExpoIapModule.isBillingProgramAvailableAndroid(program);
 };
 /**
@@ -248,6 +278,7 @@ export const isBillingProgramAvailableAndroid = async (program) => {
  * @see {@link https://openiap.dev/docs/apis/android/get-billing-choice-info-android}
  */
 export const getBillingChoiceInfoAndroid = async (params = {}) => {
+    requireAndroidPlatform('getBillingChoiceInfoAndroid');
     return ExpoIapModule.getBillingChoiceInfoAndroid({
         billingProgram: params.billingProgram ?? 'billing-choice',
         playBillingChoiceImageLayout: params.playBillingChoiceImageLayout ?? 'rectangular-four-by-one',
@@ -276,6 +307,7 @@ export const getBillingChoiceInfoAndroid = async (params = {}) => {
  * @see {@link https://openiap.dev/docs/apis/android/launch-external-link-android}
  */
 export const launchExternalLinkAndroid = async (params) => {
+    requireAndroidPlatform('launchExternalLinkAndroid');
     return ExpoIapModule.launchExternalLinkAndroid(params);
 };
 /**
@@ -297,7 +329,10 @@ export const launchExternalLinkAndroid = async (params) => {
  *
  * @see {@link https://openiap.dev/docs/apis/android/create-billing-program-reporting-details-android}
  */
-const createBillingProgramReportingDetailsAndroidField = async (args) => ExpoIapModule.createBillingProgramReportingDetailsAndroid(args.program, args.developerBillingType ?? null);
+const createBillingProgramReportingDetailsAndroidField = async (args) => {
+    requireAndroidPlatform('createBillingProgramReportingDetailsAndroid');
+    return ExpoIapModule.createBillingProgramReportingDetailsAndroid(args.program, args.developerBillingType ?? null);
+};
 export function createBillingProgramReportingDetailsAndroid(programOrArgs, developerBillingType) {
     const args = typeof programOrArgs === 'string'
         ? { program: programOrArgs, developerBillingType }
@@ -315,6 +350,7 @@ export function createBillingProgramReportingDetailsAndroid(programOrArgs, devel
  * @see {@link https://openiap.dev/docs/apis/android/show-billing-program-information-dialog-android}
  */
 export const showBillingProgramInformationDialogAndroid = async (params) => {
+    requireAndroidPlatform('showBillingProgramInformationDialogAndroid');
     return ExpoIapModule.showBillingProgramInformationDialogAndroid({
         billingProgram: params.billingProgram ?? 'billing-choice',
         externalTransactionToken: params.externalTransactionToken,
@@ -330,6 +366,7 @@ export const showBillingProgramInformationDialogAndroid = async (params) => {
  * @see {@link https://openiap.dev/docs/apis/android/show-in-app-messages-android}
  */
 export const showInAppMessagesAndroid = async (params) => {
+    requireAndroidPlatform('showInAppMessagesAndroid');
     return ExpoIapModule.showInAppMessagesAndroid(params ?? null);
 };
 //# 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":"AAAA,wBAAwB;AACxB,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AAErC,mBAAmB;AACnB,OAAO,aAAa,MAAM,kBAAkB,CAAC;AA4B7C,MAAM,mBAAmB,GAAG,aAAoC,CAAC;AAEjE,cAAc;AACd,MAAM,UAAU,gBAAgB,CAC9B,IAAa;IAEb,OAAO,CACL,IAAI,IAAI,IAAI;QACZ,OAAO,IAAI,KAAK,QAAQ;QACxB,UAAU,IAAI,IAAI;QAClB,OAAQ,IAAY,CAAC,QAAQ,KAAK,QAAQ;QACzC,IAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,SAAS,CACnD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,KAAK,EACjD,OAAgC,EACjB,EAAE;IACjB,MAAM,GAAG,GAAG,OAAO,EAAE,UAAU,IAAI,SAAS,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,EAAE,kBAAkB,IAAI,SAAS,CAAC;IAE7D,4DAA4D;IAC5D,IAAI,mBAAmB,EAAE,8BAA8B,EAAE,CAAC;QACxD,OAAO,mBAAmB,CAAC,8BAA8B,CAAC;YACxD,UAAU,EAAE,GAAG;YACf,kBAAkB,EAAE,WAAW;SAChC,CAAC,CAAC;IACL,CAAC;IAED,mDAAmD;IACnD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,+DAA+D,kBAAkB,CAC5F,WAAW,CACZ,EAAE,CAAC;IACJ,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,QAAQ,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,EAC3C,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,EACX,KAAK,GAON,EAAwC,EAAE;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC;IAElD,MAAM,GAAG,GACP,0EAA0E;QAC1E,IAAI,WAAW,cAAc,IAAI,IAAI,SAAS,EAAE;QAChD,WAAW,YAAY,EAAE,CAAC;IAE5B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,WAAW,EAAE;SACvC;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE;YAClD,UAAU,EAAE,QAAQ,CAAC,MAAM;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAE/B,KAAK,EAAE,aAAa,EAAE,EAAE;IAC1B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;IAEzE,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAiC,CAAC;QACjD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,MAAM,CAAC,YAAY,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,mEAAmE,IAAI,CAAC,SAAS,CAC/E,MAAM,CACP,EAAE,CACJ,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAEnC,KAAK,EAAE,aAAa,EAAE,EAAE;IAC1B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,0BAA0B,CAAC,aAAa,CAAC,CAAC;IAE7E,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAiC,CAAC;QACjD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,MAAM,CAAC,YAAY,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,IAAmB,EAAE;IAClE,OAAO,OAAO,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;AACjE,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAEnD,KAAK,IAAI,EAAE;IACb,OAAO,aAAa,CAAC,0CAA0C,EAAE,CAAC;AACpE,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAE5C,KAAK,IAAI,EAAE;IACb,OAAO,aAAa,CAAC,mCAAmC,EAAE,CAAC;AAC7D,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAE7C,KAAK,EAAE,GAAY,EAAE,EAAE;IACzB,OAAO,aAAa,CAAC,oCAAoC,CAAC,GAAG,CAAC,CAAC;AACjE,CAAC,CAAC;AAEF,+EAA+E;AAC/E,4DAA4D;AAC5D,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAEzC,KAAK,EAAE,OAAO,EAAE,EAAE;IACpB,OAAO,aAAa,CAAC,gCAAgC,CAAC,OAAO,CAAC,CAAC;AACjE,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAEpC,KAAK,EACP,SAA4C,EAAE,EACX,EAAE;IACrC,OAAO,aAAa,CAAC,2BAA2B,CAAC;QAC/C,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,gBAAgB;QACzD,4BAA4B,EAC1B,MAAM,CAAC,4BAA4B,IAAI,yBAAyB;QAClE,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;KACtC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAElC,KAAK,EAAE,MAAM,EAAE,EAAE;IACnB,OAAO,aAAa,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AACzD,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,gDAAgD,GAElD,KAAK,EACP,IAA6D,EACb,EAAE,CAClD,aAAa,CAAC,2CAA2C,CACvD,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAClC,CAAC;AASJ,MAAM,UAAU,2CAA2C,CACzD,aAE2D,EAC3D,oBAAyD;IAEzD,MAAM,IAAI,GACR,OAAO,aAAa,KAAK,QAAQ;QAC/B,CAAC,CAAC,EAAC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAC;QAChD,CAAC,CAAC,aAAa,CAAC;IACpB,OAAO,gDAAgD,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAEnD,KAAK,EACP,MAAoD,EACrB,EAAE;IACjC,OAAO,aAAa,CAAC,0CAA0C,CAAC;QAC9D,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,gBAAgB;QACzD,wBAAwB,EAAE,MAAM,CAAC,wBAAwB;KAC1D,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAEjC,KAAK,EACP,MAAyC,EACL,EAAE;IACtC,OAAO,aAAa,CAAC,wBAAwB,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;AAChE,CAAC,CAAC","sourcesContent":["// External dependencies\nimport {Linking} from 'react-native';\n\n// Internal modules\nimport ExpoIapModule from '../ExpoIapModule';\n\n// Types\nimport type {\n  BillingChoiceInfoAndroid,\n  BillingProgramAndroid,\n  BillingProgramInformationDialogParamsAndroid,\n  BillingProgramReportingDetailsAndroid,\n  BillingResultAndroid,\n  DeepLinkOptions,\n  DeveloperBillingTypeAndroid,\n  GetBillingChoiceInfoParamsAndroid,\n  InAppMessageParamsAndroid,\n  InAppMessageResultAndroid,\n  MutationCreateBillingProgramReportingDetailsAndroidArgs,\n  MutationField,\n  QueryField,\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 * Consume a purchase token so the user can purchase the same product again\n * (Android consumable products). Prefer using `finishTransaction` with\n * `isConsumable: true`, which dispatches to this under the hood.\n *\n * @see {@link https://openiap.dev/docs/apis/android/consume-purchase-android}\n */\nexport const consumePurchaseAndroid: MutationField<\n  'consumePurchaseAndroid'\n> = async (purchaseToken) => {\n  const result = await ExpoIapModule.consumePurchaseAndroid(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  throw new Error(\n    `consumePurchaseAndroid returned an unexpected response payload: ${JSON.stringify(\n      result,\n    )}`,\n  );\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 *\n * @see {@link https://openiap.dev/docs/apis/android/acknowledge-purchase-android}\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 *\n * @see {@link https://openiap.dev/docs/apis/android/check-alternative-billing-availability-android}\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 *\n * @see {@link https://openiap.dev/docs/apis/android/show-alternative-billing-dialog-android}\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 *\n * @see {@link https://openiap.dev/docs/apis/android/create-alternative-billing-token-android}\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+. Billing Choice availability\n * details, including the configured renderer and external-link support, require 9.1.0+.\n *\n * @param program - The billing program to check\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 *\n * @see {@link https://openiap.dev/docs/apis/android/is-billing-program-available-android}\n */\nexport const isBillingProgramAvailableAndroid: MutationField<\n  'isBillingProgramAvailableAndroid'\n> = async (program) => {\n  return ExpoIapModule.isBillingProgramAvailableAndroid(program);\n};\n\n/**\n * Fetch Play Billing assets and loyalty text for developer-rendered Billing Choice screens.\n * Available in Google Play Billing Library 9.1.0+.\n *\n * @param params - Billing Choice info request parameters\n * @returns Promise resolving to Play Billing Choice display information\n *\n * @see {@link https://openiap.dev/docs/apis/android/get-billing-choice-info-android}\n */\nexport const getBillingChoiceInfoAndroid: QueryField<\n  'getBillingChoiceInfoAndroid'\n> = async (\n  params: GetBillingChoiceInfoParamsAndroid = {},\n): Promise<BillingChoiceInfoAndroid> => {\n  return ExpoIapModule.getBillingChoiceInfoAndroid({\n    billingProgram: params.billingProgram ?? 'billing-choice',\n    playBillingChoiceImageLayout:\n      params.playBillingChoiceImageLayout ?? 'rectangular-four-by-one',\n    userLocale: params.userLocale ?? null,\n  });\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+; developer-rendered Billing\n * Choice external-link flows require 9.1.0+ and `externalTransactionToken`.\n *\n * @param params - The external link parameters\n * @returns Promise resolving to true if the link was launched successfully\n *\n * @example\n * ```typescript\n * await launchExternalLinkAndroid({\n *   billingProgram: 'billing-choice',\n *   externalTransactionToken: 'pre-generated-token',\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 *\n * @see {@link https://openiap.dev/docs/apis/android/launch-external-link-android}\n */\nexport const launchExternalLinkAndroid: MutationField<\n  'launchExternalLinkAndroid'\n> = async (params) => {\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 *\n * @see {@link https://openiap.dev/docs/apis/android/create-billing-program-reporting-details-android}\n */\nconst createBillingProgramReportingDetailsAndroidField: MutationField<\n  'createBillingProgramReportingDetailsAndroid'\n> = async (\n  args: MutationCreateBillingProgramReportingDetailsAndroidArgs,\n): Promise<BillingProgramReportingDetailsAndroid> =>\n  ExpoIapModule.createBillingProgramReportingDetailsAndroid(\n    args.program,\n    args.developerBillingType ?? null,\n  );\n\nexport function createBillingProgramReportingDetailsAndroid(\n  args: MutationCreateBillingProgramReportingDetailsAndroidArgs,\n): Promise<BillingProgramReportingDetailsAndroid>;\nexport function createBillingProgramReportingDetailsAndroid(\n  program: BillingProgramAndroid,\n  developerBillingType?: DeveloperBillingTypeAndroid | null,\n): Promise<BillingProgramReportingDetailsAndroid>;\nexport function createBillingProgramReportingDetailsAndroid(\n  programOrArgs:\n    | BillingProgramAndroid\n    | MutationCreateBillingProgramReportingDetailsAndroidArgs,\n  developerBillingType?: DeveloperBillingTypeAndroid | null,\n): Promise<BillingProgramReportingDetailsAndroid> {\n  const args =\n    typeof programOrArgs === 'string'\n      ? {program: programOrArgs, developerBillingType}\n      : programOrArgs;\n  return createBillingProgramReportingDetailsAndroidField(args);\n}\n\n/**\n * Show Google's mandatory information dialog before a developer-rendered,\n * in-app Billing Choice screen.\n * Available in Google Play Billing Library 9.1.0+.\n *\n * @param params - Dialog parameters with the external transaction token\n * @returns Promise resolving to BillingResult\n *\n * @see {@link https://openiap.dev/docs/apis/android/show-billing-program-information-dialog-android}\n */\nexport const showBillingProgramInformationDialogAndroid: MutationField<\n  'showBillingProgramInformationDialogAndroid'\n> = async (\n  params: BillingProgramInformationDialogParamsAndroid,\n): Promise<BillingResultAndroid> => {\n  return ExpoIapModule.showBillingProgramInformationDialogAndroid({\n    billingProgram: params.billingProgram ?? 'billing-choice',\n    externalTransactionToken: params.externalTransactionToken,\n  });\n};\n\n/**\n * Show Play Billing in-app messages, such as transactional subscription updates.\n * Available in Google Play Billing Library 4.1.0+.\n *\n * @param params - Optional in-app message categories\n * @returns Promise resolving to in-app message result\n *\n * @see {@link https://openiap.dev/docs/apis/android/show-in-app-messages-android}\n */\nexport const showInAppMessagesAndroid: MutationField<\n  'showInAppMessagesAndroid'\n> = async (\n  params?: InAppMessageParamsAndroid | null,\n): Promise<InAppMessageResultAndroid> => {\n  return ExpoIapModule.showInAppMessagesAndroid(params ?? null);\n};\n"]}
+{"version":3,"file":"android.js","sourceRoot":"","sources":["../../src/modules/android.ts"],"names":[],"mappings":"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","sourcesContent":["// External dependencies\nimport {Linking, Platform} from 'react-native';\n\n// Internal modules\nimport ExpoIapModule from '../ExpoIapModule';\nimport {isVegaOS} from '../vega';\n\n// Types\nimport type {\n  BillingChoiceInfoAndroid,\n  BillingProgramAndroid,\n  BillingProgramInformationDialogParamsAndroid,\n  BillingProgramReportingDetailsAndroid,\n  BillingResultAndroid,\n  DeepLinkOptions,\n  DeveloperBillingTypeAndroid,\n  GetBillingChoiceInfoParamsAndroid,\n  InAppMessageParamsAndroid,\n  InAppMessageResultAndroid,\n  MutationCreateBillingProgramReportingDetailsAndroidArgs,\n  MutationField,\n  QueryField,\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/**\n * Enforce the documented Android-only contract. Vega OS is treated as an\n * Android store runtime (matching `isAndroidStoreRuntime` in src/index.ts),\n * so it passes through. Without this guard, calling a suffixed wrapper on\n * another platform falls through to the native proxy and surfaces as an\n * opaque `TypeError: ExpoIapModule.<name> is not a function` instead of the\n * promised platform error.\n */\nconst requireAndroidPlatform = (methodName: string): void => {\n  if (Platform.OS !== 'android' && !isVegaOS()) {\n    throw new Error(`${methodName} is only available on Android and Vega OS`);\n  }\n};\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 * Consume a purchase token so the user can purchase the same product again\n * (Android consumable products). Prefer using `finishTransaction` with\n * `isConsumable: true`, which dispatches to this under the hood.\n *\n * @see {@link https://openiap.dev/docs/apis/android/consume-purchase-android}\n */\nexport const consumePurchaseAndroid: MutationField<\n  'consumePurchaseAndroid'\n> = async (purchaseToken) => {\n  requireAndroidPlatform('consumePurchaseAndroid');\n  const result = await ExpoIapModule.consumePurchaseAndroid(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  throw new Error(\n    `consumePurchaseAndroid returned an unexpected response payload: ${JSON.stringify(\n      result,\n    )}`,\n  );\n};\n\n/**\n * Acknowledge a non-consumable purchase or subscription (Android only).\n * @param {Object} params - The parameters object\n * @param {string} params.token - The product's token (on Android)\n * @returns {Promise<VoidResult | void>}\n * @throws Error if called on a non-Android platform\n *\n * @see {@link https://openiap.dev/docs/apis/android/acknowledge-purchase-android}\n */\nexport const acknowledgePurchaseAndroid: MutationField<\n  'acknowledgePurchaseAndroid'\n> = async (purchaseToken) => {\n  requireAndroidPlatform('acknowledgePurchaseAndroid');\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 offer/promo code redemption flow so the user can enter a code (Android only).\n * On Play builds, launches the Play Store redeem page. A listener can receive\n * the purchase while the app has an active billing connection; reconcile\n * available purchases when the app resumes. Unsupported store flavors return false.\n * Does not require the billing client to be initialized (no Play Billing version requirement).\n * Android counterpart of presentCodeRedemptionSheetIOS.\n *\n * @returns Promise resolving to true when launched, or false when unsupported\n *\n * @see {@link https://openiap.dev/docs/apis/android/open-redeem-offer-code-android}\n */\nexport const openRedeemOfferCodeAndroid: MutationField<\n  'openRedeemOfferCodeAndroid'\n> = async () => {\n  requireAndroidPlatform('openRedeemOfferCodeAndroid');\n  if (isVegaOS()) {\n    return false;\n  }\n  return ExpoIapModule.openRedeemOfferCodeAndroid();\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 *\n * @see {@link https://openiap.dev/docs/apis/android/check-alternative-billing-availability-android}\n */\nexport const checkAlternativeBillingAvailabilityAndroid: MutationField<\n  'checkAlternativeBillingAvailabilityAndroid'\n> = async () => {\n  requireAndroidPlatform('checkAlternativeBillingAvailabilityAndroid');\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 *\n * @see {@link https://openiap.dev/docs/apis/android/show-alternative-billing-dialog-android}\n */\nexport const showAlternativeBillingDialogAndroid: MutationField<\n  'showAlternativeBillingDialogAndroid'\n> = async () => {\n  requireAndroidPlatform('showAlternativeBillingDialogAndroid');\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 *\n * @see {@link https://openiap.dev/docs/apis/android/create-alternative-billing-token-android}\n */\nexport const createAlternativeBillingTokenAndroid: MutationField<\n  'createAlternativeBillingTokenAndroid'\n> = async (sku?: string) => {\n  requireAndroidPlatform('createAlternativeBillingTokenAndroid');\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+. Billing Choice availability\n * details, including the configured renderer and external-link support, require 9.1.0+.\n *\n * @param program - The billing program to check\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 *\n * @see {@link https://openiap.dev/docs/apis/android/is-billing-program-available-android}\n */\nexport const isBillingProgramAvailableAndroid: MutationField<\n  'isBillingProgramAvailableAndroid'\n> = async (program) => {\n  requireAndroidPlatform('isBillingProgramAvailableAndroid');\n  return ExpoIapModule.isBillingProgramAvailableAndroid(program);\n};\n\n/**\n * Fetch Play Billing assets and loyalty text for developer-rendered Billing Choice screens.\n * Available in Google Play Billing Library 9.1.0+.\n *\n * @param params - Billing Choice info request parameters\n * @returns Promise resolving to Play Billing Choice display information\n *\n * @see {@link https://openiap.dev/docs/apis/android/get-billing-choice-info-android}\n */\nexport const getBillingChoiceInfoAndroid: QueryField<\n  'getBillingChoiceInfoAndroid'\n> = async (\n  params: GetBillingChoiceInfoParamsAndroid = {},\n): Promise<BillingChoiceInfoAndroid> => {\n  requireAndroidPlatform('getBillingChoiceInfoAndroid');\n  return ExpoIapModule.getBillingChoiceInfoAndroid({\n    billingProgram: params.billingProgram ?? 'billing-choice',\n    playBillingChoiceImageLayout:\n      params.playBillingChoiceImageLayout ?? 'rectangular-four-by-one',\n    userLocale: params.userLocale ?? null,\n  });\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+; developer-rendered Billing\n * Choice external-link flows require 9.1.0+ and `externalTransactionToken`.\n *\n * @param params - The external link parameters\n * @returns Promise resolving to true if the link was launched successfully\n *\n * @example\n * ```typescript\n * await launchExternalLinkAndroid({\n *   billingProgram: 'billing-choice',\n *   externalTransactionToken: 'pre-generated-token',\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 *\n * @see {@link https://openiap.dev/docs/apis/android/launch-external-link-android}\n */\nexport const launchExternalLinkAndroid: MutationField<\n  'launchExternalLinkAndroid'\n> = async (params) => {\n  requireAndroidPlatform('launchExternalLinkAndroid');\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 *\n * @see {@link https://openiap.dev/docs/apis/android/create-billing-program-reporting-details-android}\n */\nconst createBillingProgramReportingDetailsAndroidField: MutationField<\n  'createBillingProgramReportingDetailsAndroid'\n> = async (\n  args: MutationCreateBillingProgramReportingDetailsAndroidArgs,\n): Promise<BillingProgramReportingDetailsAndroid> => {\n  requireAndroidPlatform('createBillingProgramReportingDetailsAndroid');\n  return ExpoIapModule.createBillingProgramReportingDetailsAndroid(\n    args.program,\n    args.developerBillingType ?? null,\n  );\n};\n\nexport function createBillingProgramReportingDetailsAndroid(\n  args: MutationCreateBillingProgramReportingDetailsAndroidArgs,\n): Promise<BillingProgramReportingDetailsAndroid>;\nexport function createBillingProgramReportingDetailsAndroid(\n  program: BillingProgramAndroid,\n  developerBillingType?: DeveloperBillingTypeAndroid | null,\n): Promise<BillingProgramReportingDetailsAndroid>;\nexport function createBillingProgramReportingDetailsAndroid(\n  programOrArgs:\n    | BillingProgramAndroid\n    | MutationCreateBillingProgramReportingDetailsAndroidArgs,\n  developerBillingType?: DeveloperBillingTypeAndroid | null,\n): Promise<BillingProgramReportingDetailsAndroid> {\n  const args =\n    typeof programOrArgs === 'string'\n      ? {program: programOrArgs, developerBillingType}\n      : programOrArgs;\n  return createBillingProgramReportingDetailsAndroidField(args);\n}\n\n/**\n * Show Google's mandatory information dialog before a developer-rendered,\n * in-app Billing Choice screen.\n * Available in Google Play Billing Library 9.1.0+.\n *\n * @param params - Dialog parameters with the external transaction token\n * @returns Promise resolving to BillingResult\n *\n * @see {@link https://openiap.dev/docs/apis/android/show-billing-program-information-dialog-android}\n */\nexport const showBillingProgramInformationDialogAndroid: MutationField<\n  'showBillingProgramInformationDialogAndroid'\n> = async (\n  params: BillingProgramInformationDialogParamsAndroid,\n): Promise<BillingResultAndroid> => {\n  requireAndroidPlatform('showBillingProgramInformationDialogAndroid');\n  return ExpoIapModule.showBillingProgramInformationDialogAndroid({\n    billingProgram: params.billingProgram ?? 'billing-choice',\n    externalTransactionToken: params.externalTransactionToken,\n  });\n};\n\n/**\n * Show Play Billing in-app messages, such as transactional subscription updates.\n * Available in Google Play Billing Library 4.1.0+.\n *\n * @param params - Optional in-app message categories\n * @returns Promise resolving to in-app message result\n *\n * @see {@link https://openiap.dev/docs/apis/android/show-in-app-messages-android}\n */\nexport const showInAppMessagesAndroid: MutationField<\n  'showInAppMessagesAndroid'\n> = async (\n  params?: InAppMessageParamsAndroid | null,\n): Promise<InAppMessageResultAndroid> => {\n  requireAndroidPlatform('showInAppMessagesAndroid');\n  return ExpoIapModule.showInAppMessagesAndroid(params ?? null);\n};\n"]}

package/build/modules/ios.d.ts

@@ -116,6 +116,8 @@ export declare const getReceiptIOS: () => Promise<string | null>;
  *   alias so consumers who previously imported `getStorefrontIOS` do not break.
  *
  * @returns {Promise<string>} ISO 3166-1 alpha-3 country code (e.g. "USA")
+ * @throws Error if called on non-iOS platform — Android callers must use the
+ *   cross-platform `getStorefront` from the main index instead
  *
  * @platform iOS
  *

package/build/modules/ios.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ios.d.ts","sourceRoot":"","sources":["../../src/modules/ios.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ios.d.ts","sourceRoot":"","sources":["../../src/modules/ios.ts"],"names":[],"mappings":"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"}

package/build/modules/ios.js

@@ -4,7 +4,18 @@
 import ExpoIapModule from '../ExpoIapModule';
 import { ErrorCode } from '../types';
 import { createPurchaseError, createPurchaseErrorFromNativeException, } from '../utils/errorMapping';
-import { Linking } from 'react-native';
+import { Linking, Platform } from 'react-native';
+/**
+ * Enforce the documented iOS-only contract. Without this, calling a
+ * suffixed wrapper on another platform falls through to the native proxy
+ * and surfaces as an opaque `TypeError: ExpoIapModule.<name> is not a
+ * function` instead of the promised platform error.
+ */
+const requireIosPlatform = (methodName) => {
+    if (Platform.OS !== 'ios') {
+        throw new Error(`${methodName} is only available on iOS`);
+    }
+};
 // Listeners
 // Type guards
 export function isProductIOS(item) {
@@ -27,6 +38,7 @@ export function isProductIOS(item) {
  * @see {@link https://openiap.dev/docs/apis/ios/sync-ios}
  */
 export const syncIOS = async () => {
+    requireIosPlatform('syncIOS');
     return !!(await ExpoIapModule.syncIOS());
 };
 /**
@@ -41,6 +53,7 @@ export const syncIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/ios/is-eligible-for-intro-offer-ios}
  */
 export const isEligibleForIntroOfferIOS = async (groupId) => {
+    requireIosPlatform('isEligibleForIntroOfferIOS');
     if (!groupId) {
         throw new Error('isEligibleForIntroOfferIOS requires a groupId');
     }
@@ -58,6 +71,7 @@ export const isEligibleForIntroOfferIOS = async (groupId) => {
  * @see {@link https://openiap.dev/docs/apis/ios/subscription-status-ios}
  */
 export const subscriptionStatusIOS = async (sku) => {
+    requireIosPlatform('subscriptionStatusIOS');
     if (!sku) {
         throw new Error('subscriptionStatusIOS requires a SKU');
     }
@@ -76,6 +90,7 @@ export const subscriptionStatusIOS = async (sku) => {
  * @see {@link https://openiap.dev/docs/apis/ios/current-entitlement-ios}
  */
 export const currentEntitlementIOS = async (sku) => {
+    requireIosPlatform('currentEntitlementIOS');
     if (!sku) {
         throw new Error('currentEntitlementIOS requires a SKU');
     }
@@ -94,6 +109,7 @@ export const currentEntitlementIOS = async (sku) => {
  * @see {@link https://openiap.dev/docs/apis/ios/latest-transaction-ios}
  */
 export const latestTransactionIOS = async (sku) => {
+    requireIosPlatform('latestTransactionIOS');
     if (!sku) {
         throw new Error('latestTransactionIOS requires a SKU');
     }
@@ -112,6 +128,7 @@ export const latestTransactionIOS = async (sku) => {
  * @see {@link https://openiap.dev/docs/apis/ios/begin-refund-request-ios}
  */
 export const beginRefundRequestIOS = async (sku) => {
+    requireIosPlatform('beginRefundRequestIOS');
     if (!sku) {
         throw new Error('beginRefundRequestIOS requires a SKU');
     }
@@ -130,6 +147,7 @@ export const beginRefundRequestIOS = async (sku) => {
  * @see {@link https://openiap.dev/docs/apis/ios/show-manage-subscriptions-ios}
  */
 export const showManageSubscriptionsIOS = async () => {
+    requireIosPlatform('showManageSubscriptionsIOS');
     const purchases = await ExpoIapModule.showManageSubscriptionsIOS();
     return (purchases ?? []);
 };
@@ -146,6 +164,7 @@ export const showManageSubscriptionsIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/ios/get-receipt-data-ios}
  */
 export const getReceiptDataIOS = async () => {
+    requireIosPlatform('getReceiptDataIOS');
     return ExpoIapModule.getReceiptDataIOS();
 };
 export const getReceiptIOS = getReceiptDataIOS;
@@ -158,12 +177,15 @@ export const getReceiptIOS = getReceiptDataIOS;
  *   alias so consumers who previously imported `getStorefrontIOS` do not break.
  *
  * @returns {Promise<string>} ISO 3166-1 alpha-3 country code (e.g. "USA")
+ * @throws Error if called on non-iOS platform — Android callers must use the
+ *   cross-platform `getStorefront` from the main index instead
  *
  * @platform iOS
  *
  * @see {@link https://openiap.dev/docs/apis/ios/get-storefront-ios}
  */
 export const getStorefrontIOS = async () => {
+    requireIosPlatform('getStorefrontIOS');
     if (typeof ExpoIapModule.getStorefront !== 'function') {
         throw createPurchaseError({
             code: ErrorCode.FeatureNotSupported,
@@ -203,6 +225,7 @@ export const getStorefrontIOS = async () => {
  * @platform iOS
  */
 export const requestReceiptRefreshIOS = async () => {
+    requireIosPlatform('requestReceiptRefreshIOS');
     return ExpoIapModule.requestReceiptRefreshIOS();
 };
 /**
@@ -218,6 +241,7 @@ export const requestReceiptRefreshIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/ios/is-transaction-verified-ios}
  */
 export const isTransactionVerifiedIOS = async (sku) => {
+    requireIosPlatform('isTransactionVerifiedIOS');
     if (!sku) {
         throw new Error('isTransactionVerifiedIOS requires a SKU');
     }
@@ -236,6 +260,7 @@ export const isTransactionVerifiedIOS = async (sku) => {
  * @see {@link https://openiap.dev/docs/apis/ios/get-transaction-jws-ios}
  */
 export const getTransactionJwsIOS = async (sku) => {
+    requireIosPlatform('getTransactionJwsIOS');
     if (!sku) {
         throw new Error('getTransactionJwsIOS requires a SKU');
     }
@@ -261,6 +286,7 @@ export const getTransactionJwsIOS = async (sku) => {
  * @see {@link https://openiap.dev/docs/apis/ios/validate-receipt-ios}
  */
 const validateReceiptIOSImpl = async (props) => {
+    requireIosPlatform('validateReceiptIOS');
     const sku = typeof props === 'string'
         ? props
         : props?.apple?.sku;
@@ -284,6 +310,7 @@ export const validateReceiptIOS = validateReceiptIOSImpl;
  * @see {@link https://openiap.dev/docs/apis/ios/present-code-redemption-sheet-ios}
  */
 export const presentCodeRedemptionSheetIOS = async () => {
+    requireIosPlatform('presentCodeRedemptionSheetIOS');
     return !!(await ExpoIapModule.presentCodeRedemptionSheetIOS());
 };
 /**
@@ -303,6 +330,7 @@ export const presentCodeRedemptionSheetIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/ios/get-app-transaction-ios}
  */
 export const getAppTransactionIOS = async () => {
+    requireIosPlatform('getAppTransactionIOS');
     return (await ExpoIapModule.getAppTransactionIOS()) ?? null;
 };
 /**
@@ -318,6 +346,7 @@ export const getAppTransactionIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/ios/get-promoted-product-ios}
  */
 export const getPromotedProductIOS = async () => {
+    requireIosPlatform('getPromotedProductIOS');
     const product = await ExpoIapModule.getPromotedProductIOS();
     return (product ?? null);
 };
@@ -336,6 +365,7 @@ export const getPromotedProductIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/ios/request-purchase-on-promoted-product-ios}
  */
 export const requestPurchaseOnPromotedProductIOS = async () => {
+    requireIosPlatform('requestPurchaseOnPromotedProductIOS');
     const result = await ExpoIapModule.requestPurchaseOnPromotedProductIOS();
     return result ?? true;
 };
@@ -348,6 +378,7 @@ export const requestPurchaseOnPromotedProductIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/ios/get-pending-transactions-ios}
  */
 export const getPendingTransactionsIOS = async () => {
+    requireIosPlatform('getPendingTransactionsIOS');
     const transactions = await ExpoIapModule.getPendingTransactionsIOS();
     return (transactions ?? []);
 };
@@ -357,6 +388,7 @@ export const getPendingTransactionsIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/ios/get-all-transactions-ios}
  */
 export const getAllTransactionsIOS = async () => {
+    requireIosPlatform('getAllTransactionsIOS');
     const transactions = await ExpoIapModule.getAllTransactionsIOS();
     return (transactions ?? []);
 };
@@ -369,6 +401,7 @@ export const getAllTransactionsIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/ios/clear-transaction-ios}
  */
 export const clearTransactionIOS = async () => {
+    requireIosPlatform('clearTransactionIOS');
     return !!(await ExpoIapModule.clearTransactionIOS());
 };
 /**
@@ -391,6 +424,7 @@ export const deepLinkToSubscriptionsIOS = () => Linking.openURL('https://apps.ap
  * @see {@link https://openiap.dev/docs/apis/ios/can-present-external-purchase-notice-ios}
  */
 export const canPresentExternalPurchaseNoticeIOS = async () => {
+    requireIosPlatform('canPresentExternalPurchaseNoticeIOS');
     return !!(await ExpoIapModule.canPresentExternalPurchaseNoticeIOS());
 };
 /**
@@ -404,6 +438,7 @@ export const canPresentExternalPurchaseNoticeIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/ios/present-external-purchase-notice-sheet-ios}
  */
 export const presentExternalPurchaseNoticeSheetIOS = async () => {
+    requireIosPlatform('presentExternalPurchaseNoticeSheetIOS');
     const result = await ExpoIapModule.presentExternalPurchaseNoticeSheetIOS();
     return result;
 };
@@ -417,6 +452,7 @@ export const presentExternalPurchaseNoticeSheetIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/ios/present-external-purchase-link-ios}
  */
 export const presentExternalPurchaseLinkIOS = async (url) => {
+    requireIosPlatform('presentExternalPurchaseLinkIOS');
     const result = await ExpoIapModule.presentExternalPurchaseLinkIOS(url);
     return result;
 };
@@ -431,6 +467,7 @@ export const presentExternalPurchaseLinkIOS = async (url) => {
  * @see {@link https://openiap.dev/docs/apis/ios/is-eligible-for-external-purchase-custom-link-ios}
  */
 export const isEligibleForExternalPurchaseCustomLinkIOS = async () => {
+    requireIosPlatform('isEligibleForExternalPurchaseCustomLinkIOS');
     return !!(await ExpoIapModule.isEligibleForExternalPurchaseCustomLinkIOS());
 };
 /**
@@ -445,6 +482,7 @@ export const isEligibleForExternalPurchaseCustomLinkIOS = async () => {
  * @see {@link https://openiap.dev/docs/apis/ios/get-external-purchase-custom-link-token-ios}
  */
 export const getExternalPurchaseCustomLinkTokenIOS = async (tokenType) => {
+    requireIosPlatform('getExternalPurchaseCustomLinkTokenIOS');
     if (!tokenType) {
         throw new Error("getExternalPurchaseCustomLinkTokenIOS requires a tokenType ('acquisition' or 'services')");
     }
@@ -464,6 +502,7 @@ export const getExternalPurchaseCustomLinkTokenIOS = async (tokenType) => {
  * @see {@link https://openiap.dev/docs/apis/ios/show-external-purchase-custom-link-notice-ios}
  */
 export const showExternalPurchaseCustomLinkNoticeIOS = async (noticeType) => {
+    requireIosPlatform('showExternalPurchaseCustomLinkNoticeIOS');
     if (!noticeType) {
         throw new Error("showExternalPurchaseCustomLinkNoticeIOS requires a noticeType ('browser')");
     }