react-native-iap 15.3.6 → 15.4.0-rc.1

package/src/index.kepler.ts

@@ -0,0 +1,311 @@
+import {getVegaIapModule} from './vega';
+import type {
+  MutationField,
+  Product,
+  ProductQueryType,
+  ProductSubscription,
+  Purchase,
+  PurchaseError,
+  PurchaseUpdatedListenerOptions,
+  QueryField,
+  RequestPurchasePropsByPlatforms,
+  RequestSubscriptionPropsByPlatforms,
+} from './types';
+import type {
+  NitroAvailablePurchasesOptions,
+  NitroFinishTransactionParams,
+  NitroProduct,
+  NitroPurchase,
+  NitroPurchaseRequest,
+} from './specs/RnIap.nitro';
+import {
+  convertNitroProductToProduct,
+  convertNitroPurchaseToPurchase,
+  convertProductToProductSubscription,
+  validateNitroProduct,
+  validateNitroPurchase,
+} from './utils/type-bridge';
+
+export * from './types';
+export * from './utils/error';
+export * from './vega';
+export {useIAP, type UseIapOptions} from './hooks/useIAP';
+export {connectWebhookStream, parseWebhookEventData} from './webhook-client';
+export {kitApi, KitApiError} from './kit-api';
+
+export type ProductTypeInput = 'inapp' | 'in-app' | 'subs';
+
+export interface EventSubscription {
+  remove(): void;
+}
+
+type VegaModuleExtras = {
+  acknowledgePurchaseAndroid(purchaseToken: string): Promise<boolean>;
+  consumePurchaseAndroid(purchaseToken: string): Promise<boolean>;
+  restorePurchases?: () => Promise<void>;
+};
+
+const unsupported = (feature: string): never => {
+  throw new Error(`${feature} is not supported on Amazon Vega.`);
+};
+
+const getModule = () => {
+  const module = getVegaIapModule();
+  if (!module) {
+    throw new Error(
+      'Amazon Vega IAP module is unavailable. Install @amazon-devices/keplerscript-appstore-iap-lib in the Vega app target and build with the React Native for Vega kepler platform.',
+    );
+  }
+  return module;
+};
+
+const getVegaModule = () =>
+  getModule() as ReturnType<typeof getModule> & VegaModuleExtras;
+
+const normalizeProductQueryType = (
+  type?: ProductQueryType | ProductTypeInput | null,
+): ProductTypeInput | 'all' => {
+  if (type === 'subs') return 'subs';
+  if (type === 'all') return 'all';
+  return 'inapp';
+};
+
+const mapProducts = (
+  nitroProducts: NitroProduct[],
+  type: ProductTypeInput | 'all',
+) => {
+  const converted = nitroProducts
+    .filter(validateNitroProduct)
+    .map(convertNitroProductToProduct);
+
+  if (type === 'subs') {
+    return converted.map(convertProductToProductSubscription);
+  }
+
+  return converted;
+};
+
+export const isNitroReady = (): boolean => false;
+export const isTVOS = (): boolean => false;
+export const isMacOS = (): boolean => false;
+export const isStandardIOS = (): boolean => false;
+
+export const initConnection: MutationField<'initConnection'> = async (
+  config,
+) => {
+  return getModule().initConnection(config ?? null);
+};
+
+export const endConnection: MutationField<'endConnection'> = async () => {
+  return getModule().endConnection();
+};
+
+export const fetchProducts: QueryField<'fetchProducts'> = async (request) => {
+  const {skus, type} = request;
+  const normalizedType = normalizeProductQueryType(type);
+  const nitroProducts = await getModule().fetchProducts(skus, normalizedType);
+  return mapProducts(nitroProducts, normalizedType) as
+    | Product[]
+    | ProductSubscription[];
+};
+
+export const requestPurchase: MutationField<'requestPurchase'> = async (
+  request,
+) => {
+  const perPlatformRequest = request.request as
+    | RequestPurchasePropsByPlatforms
+    | RequestSubscriptionPropsByPlatforms
+    | undefined;
+  const androidRequest =
+    perPlatformRequest?.google ?? perPlatformRequest?.android;
+
+  if (!androidRequest?.skus?.length) {
+    throw new Error(
+      'Invalid request for Amazon Vega. The `request.google.skus` or `request.android.skus` property is required and must be a non-empty array.',
+    );
+  }
+
+  const nitroRequest: NitroPurchaseRequest = {
+    google: androidRequest,
+    android: androidRequest,
+  };
+  const result = await getModule().requestPurchase(nitroRequest);
+  if (!Array.isArray(result)) return null;
+  const purchases = result as unknown as NitroPurchase[];
+  return purchases
+    .filter(validateNitroPurchase)
+    .map((purchase) => convertNitroPurchaseToPurchase(purchase));
+};
+
+export const getAvailablePurchases: QueryField<
+  'getAvailablePurchases'
+> = async (options) => {
+  const nitroOptions: NitroAvailablePurchasesOptions = {
+    android: {
+      includeSuspended: options?.includeSuspendedAndroid ?? false,
+    },
+  };
+  return getModule()
+    .getAvailablePurchases(nitroOptions)
+    .then((purchases) =>
+      purchases
+        .filter(validateNitroPurchase)
+        .map(convertNitroPurchaseToPurchase),
+    );
+};
+
+export const finishTransaction: MutationField<'finishTransaction'> = async (
+  args,
+) => {
+  const token = args.purchase.purchaseToken ?? undefined;
+  if (!token) {
+    throw new Error('purchaseToken required to finish Amazon Vega transaction');
+  }
+
+  const params: NitroFinishTransactionParams = {
+    android: {
+      purchaseToken: token,
+      isConsumable: args.isConsumable ?? false,
+    },
+  };
+  await getModule().finishTransaction(params);
+};
+
+export const restorePurchases: MutationField<'restorePurchases'> = async () => {
+  await getVegaModule().restorePurchases?.();
+};
+
+export const getActiveSubscriptions: QueryField<
+  'getActiveSubscriptions'
+> = async (args) => {
+  return getModule().getActiveSubscriptions(args ?? undefined);
+};
+
+export const hasActiveSubscriptions: QueryField<
+  'hasActiveSubscriptions'
+> = async (args) => {
+  return getModule().hasActiveSubscriptions(args ?? undefined);
+};
+
+export const purchaseUpdatedListener = (
+  listener: (purchase: Purchase) => void,
+  options?: PurchaseUpdatedListenerOptions | null,
+): EventSubscription => {
+  const token = getModule().addPurchaseUpdatedListener((purchase) => {
+    if (validateNitroPurchase(purchase)) {
+      listener(convertNitroPurchaseToPurchase(purchase));
+    }
+  }, options ?? undefined);
+
+  return {
+    remove: () => {
+      if (typeof token === 'number') {
+        getModule().removePurchaseUpdatedListener(token);
+      }
+    },
+  };
+};
+
+export const purchaseErrorListener = (
+  listener: (error: PurchaseError) => void,
+): EventSubscription => {
+  const nativeListener = (error: {code?: string; message?: string}) => {
+    listener({
+      code: (error.code ?? 'service-error') as PurchaseError['code'],
+      message: error.message ?? 'Amazon Vega purchase failed',
+    });
+  };
+
+  getModule().addPurchaseErrorListener(nativeListener);
+  return {
+    remove: () => getModule().removePurchaseErrorListener(nativeListener),
+  };
+};
+
+export const getStorefront: QueryField<'getStorefront'> = async () => {
+  return getModule().getStorefront();
+};
+
+export const verifyPurchaseWithProvider: MutationField<
+  'verifyPurchaseWithProvider'
+> = async (params) => {
+  return getModule().verifyPurchaseWithProvider(params) as ReturnType<
+    MutationField<'verifyPurchaseWithProvider'>
+  >;
+};
+
+export const validateReceipt: MutationField<'validateReceipt'> = async () => {
+  return unsupported('validateReceipt');
+};
+
+export const verifyPurchase: MutationField<'verifyPurchase'> = validateReceipt;
+export const validateReceiptIOS: QueryField<'validateReceiptIOS'> = async () =>
+  unsupported('validateReceiptIOS');
+export const syncIOS: MutationField<'syncIOS'> = async () =>
+  unsupported('syncIOS');
+export const getAppTransactionIOS: QueryField<
+  'getAppTransactionIOS'
+> = async () => null;
+export const getPromotedProductIOS: QueryField<
+  'getPromotedProductIOS'
+> = async () => null;
+export const requestPromotedProductIOS = getPromotedProductIOS;
+export const requestPurchaseOnPromotedProductIOS = async (): Promise<void> =>
+  unsupported('requestPurchaseOnPromotedProductIOS');
+export const showManageSubscriptionsIOS: MutationField<
+  'showManageSubscriptionsIOS'
+> = async () => [];
+export const presentCodeRedemptionSheetIOS: MutationField<
+  'presentCodeRedemptionSheetIOS'
+> = async () => false;
+export const presentExternalPurchaseLinkIOS: MutationField<
+  'presentExternalPurchaseLinkIOS'
+> = async () => unsupported('presentExternalPurchaseLinkIOS');
+export const deepLinkToSubscriptions: MutationField<
+  'deepLinkToSubscriptions'
+> = async () => unsupported('deepLinkToSubscriptions');
+export const promotedProductListenerIOS = (): EventSubscription => ({
+  remove: () => {},
+});
+
+export const acknowledgePurchaseAndroid: MutationField<
+  'acknowledgePurchaseAndroid'
+> = async (purchaseToken) => {
+  return getVegaModule().acknowledgePurchaseAndroid(purchaseToken);
+};
+export const consumePurchaseAndroid: MutationField<
+  'consumePurchaseAndroid'
+> = async (purchaseToken) => {
+  return getVegaModule().consumePurchaseAndroid(purchaseToken);
+};
+export const acknowledgePurchase = acknowledgePurchaseAndroid;
+export const consumePurchase = consumePurchaseAndroid;
+
+export const checkAlternativeBillingAvailabilityAndroid: MutationField<
+  'checkAlternativeBillingAvailabilityAndroid'
+> = async () => unsupported('checkAlternativeBillingAvailabilityAndroid');
+export const showAlternativeBillingDialogAndroid: MutationField<
+  'showAlternativeBillingDialogAndroid'
+> = async () => unsupported('showAlternativeBillingDialogAndroid');
+export const createAlternativeBillingTokenAndroid: MutationField<
+  'createAlternativeBillingTokenAndroid'
+> = async () => unsupported('createAlternativeBillingTokenAndroid');
+export const isBillingProgramAvailableAndroid: MutationField<
+  'isBillingProgramAvailableAndroid'
+> = async () => unsupported('isBillingProgramAvailableAndroid');
+export const launchExternalLinkAndroid: MutationField<
+  'launchExternalLinkAndroid'
+> = async () => unsupported('launchExternalLinkAndroid');
+export const createBillingProgramReportingDetailsAndroid: MutationField<
+  'createBillingProgramReportingDetailsAndroid'
+> = async () => unsupported('createBillingProgramReportingDetailsAndroid');
+export const userChoiceBillingListenerAndroid = (): EventSubscription => ({
+  remove: () => {},
+});
+export const developerProvidedBillingListenerAndroid =
+  (): EventSubscription => ({
+    remove: () => {},
+  });
+export const subscriptionBillingIssueListener = (): EventSubscription => ({
+  remove: () => {},
+});

package/src/index.ts

@@ -64,6 +64,7 @@ import {
 import {RnIapConsole} from './utils/debug';
 import {getSuccessFromPurchaseVariant} from './utils/purchase';
 import {parseAppTransactionPayload} from './utils';
+import {getVegaIapModule, isVegaOS} from './vega';
 
 // ------------------------------
 // Billing Programs API (Android 8.2.0+)
@@ -72,9 +73,7 @@ import {parseAppTransactionPayload} from './utils';
 // Note: BillingProgramAndroid, ExternalLinkLaunchModeAndroid, and ExternalLinkTypeAndroid
 // are exported from './types' (auto-generated from openiap-gql).
 // Import them here for use in this file's interfaces and functions.
-import type {
-  BillingProgramAndroid,
-} from './types';
+import type {BillingProgramAndroid} from './types';
 
 // Export all types
 export type {
@@ -85,6 +84,7 @@ export type {
 } from './specs/RnIap.nitro';
 export * from './types';
 export * from './utils/error';
+export * from './vega';
 
 export type ProductTypeInput = 'inapp' | 'in-app' | 'subs';
 
@@ -178,6 +178,10 @@ let iapRef: RnIap | null = null;
  */
 export const isNitroReady = (): boolean => {
   if (iapRef) return true;
+  if (isVegaOS()) {
+    iapRef = getVegaIapModule();
+    return Boolean(iapRef);
+  }
   try {
     iapRef = NitroModules.createHybridObject<RnIap>('RnIap');
     return true;
@@ -212,10 +216,25 @@ export const isStandardIOS = (): boolean => {
   return Platform.OS === 'ios' && !isTVOS() && !isMacOS();
 };
 
+const isAndroidStoreRuntime = (): boolean => {
+  return Platform.OS === 'android' || isVegaOS();
+};
+
 const IAP = {
   get instance(): RnIap {
     if (iapRef) return iapRef;
 
+    if (isVegaOS()) {
+      const vegaModule = getVegaIapModule();
+      if (!vegaModule) {
+        throw new Error(
+          'Amazon Vega IAP module is unavailable. Install @amazon-devices/keplerscript-appstore-iap-lib in the Vega app target and build with the React Native for Vega kepler platform.',
+        );
+      }
+      iapRef = vegaModule;
+      return iapRef;
+    }
+
     // Attempt to create the HybridObject and map common Nitro/JSI readiness errors
     try {
       iapRef = NitroModules.createHybridObject<RnIap>('RnIap');
@@ -754,7 +773,7 @@ function tryAttachSubscriptionBillingIssueNative(): void {
     const msg = toErrorMessage(e);
     if (msg.includes('Nitro runtime not installed')) {
       RnIapConsole.warn(
-        '[subscriptionBillingIssueListener] Nitro not ready yet; will retry on next registration after initConnection()',
+        '[subscriptionBillingIssueListener] Nitro not ready yet; will retry after initConnection()',
       );
     } else {
       throw e;
@@ -863,7 +882,7 @@ export const fetchProducts: QueryField<'fetchProducts'> = async (request) => {
         // item.type === 'subs' case
         // For Android, check if subscription items have actual offers
         if (
-          Platform.OS === 'android' &&
+          isAndroidStoreRuntime() &&
           item.platform === 'android' &&
           item.type === 'subs'
         ) {
@@ -984,11 +1003,26 @@ export const getAvailablePurchases: QueryField<
       }
 
       return validPurchases.map(convertNitroPurchaseToPurchase);
-    } else if (Platform.OS === 'android') {
-      // For Android, we need to call twice for inapp and subs
+    } else if (isAndroidStoreRuntime()) {
       const includeSuspended = Boolean(
         options?.includeSuspendedAndroid ?? false,
       );
+
+      if (isVegaOS()) {
+        const nitroPurchases = await IAP.instance.getAvailablePurchases({
+          android: {includeSuspended},
+        });
+        const validPurchases = nitroPurchases.filter(validateNitroPurchase);
+        if (validPurchases.length !== nitroPurchases.length) {
+          RnIapConsole.warn(
+            `[getAvailablePurchases] Some Vega purchases failed validation: ${nitroPurchases.length - validPurchases.length} invalid`,
+          );
+        }
+
+        return validPurchases.map(convertNitroPurchaseToPurchase);
+      }
+
+      // For Android Play/Horizon/Fire OS, query in-app items and subscriptions separately.
       const inappNitroPurchases = await IAP.instance.getAvailablePurchases({
         android: {type: 'inapp', includeSuspended},
       });
@@ -1088,9 +1122,9 @@ export const getStorefrontIOS: QueryField<'getStorefrontIOS'> = async () => {
  * @see {@link https://openiap.dev/docs/apis/get-storefront}
  */
 export const getStorefront: QueryField<'getStorefront'> = async () => {
-  if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
+  if (Platform.OS !== 'ios' && !isAndroidStoreRuntime()) {
     RnIapConsole.warn(
-      '[getStorefront] Storefront lookup is only supported on iOS and Android.',
+      '[getStorefront] Storefront lookup is only supported on iOS, Android, and Vega OS.',
     );
     return '';
   }
@@ -1598,9 +1632,13 @@ export const initConnection: MutationField<'initConnection'> = async (
   config,
 ) => {
   try {
-    return await IAP.instance.initConnection(
+    const result = await IAP.instance.initConnection(
       config as Record<string, unknown> | undefined,
     );
+    if (subscriptionBillingIssueJsListeners.size > 0) {
+      tryAttachSubscriptionBillingIssueNative();
+    }
+    return result;
   } catch (error) {
     const parsedError = parseErrorAndLogIfNeeded(
       'Failed to initialize IAP connection:',
@@ -1719,7 +1757,7 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
           'Invalid request for iOS. The `sku` property is required.',
         );
       }
-    } else if (Platform.OS === 'android') {
+    } else if (isAndroidStoreRuntime()) {
       // Support both 'google' (recommended) and 'android' (deprecated) fields
       const androidRequest =
         perPlatformRequest.google ?? perPlatformRequest.android;
@@ -1787,7 +1825,7 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
     // Support both 'google' (recommended) and 'android' (deprecated) fields
     const androidRequestSource =
       perPlatformRequest.google ?? perPlatformRequest.android;
-    if (Platform.OS === 'android' && androidRequestSource) {
+    if (isAndroidStoreRuntime() && androidRequestSource) {
       const androidRequest = isSubs
         ? (androidRequestSource as RequestSubscriptionAndroidProps)
         : (androidRequestSource as RequestPurchaseAndroidProps);
@@ -1896,7 +1934,7 @@ export const finishTransaction: MutationField<'finishTransaction'> = async (
           transactionId: purchase.id,
         },
       };
-    } else if (Platform.OS === 'android') {
+    } else if (isAndroidStoreRuntime()) {
       const token = purchase.purchaseToken ?? undefined;
 
       if (!token) {
@@ -1954,9 +1992,9 @@ export const acknowledgePurchaseAndroid: MutationField<
   'acknowledgePurchaseAndroid'
 > = async (purchaseToken) => {
   try {
-    if (Platform.OS !== 'android') {
+    if (!isAndroidStoreRuntime()) {
       throw new Error(
-        'acknowledgePurchaseAndroid is only available on Android',
+        'acknowledgePurchaseAndroid is only available on Android and Vega OS',
       );
     }
 
@@ -1997,8 +2035,10 @@ export const consumePurchaseAndroid: MutationField<
   'consumePurchaseAndroid'
 > = async (purchaseToken) => {
   try {
-    if (Platform.OS !== 'android') {
-      throw new Error('consumePurchaseAndroid is only available on Android');
+    if (!isAndroidStoreRuntime()) {
+      throw new Error(
+        'consumePurchaseAndroid is only available on Android and Vega OS',
+      );
     }
 
     const result = await IAP.instance.finishTransaction({
@@ -2221,8 +2261,14 @@ export const validateReceiptIOS: QueryField<'validateReceiptIOS'> = async (
  *   provider: 'iapkit',
  *   iapkit: {
  *     apiKey: 'your-api-key',
- *     apple: { jws: purchase.purchaseToken },
- *     google: { purchaseToken: purchase.purchaseToken },
+ *     // Choose exactly one store payload.
+ *     // apple: { jws: purchase.purchaseToken },
+ *     // google: { purchaseToken: purchase.purchaseToken },
+ *     amazon: {
+ *       userId: amazonUserId,
+ *       receiptId: purchase.purchaseToken,
+ *       sandbox: __DEV__,
+ *     },
  *   },
  * });
  * ```

package/src/specs/RnIap.nitro.ts

@@ -88,7 +88,7 @@ export type IapkitPurchaseState =
 
 // Store identifier for purchase origin
 // Defined locally for Nitro codegen (not in GQL schema)
-export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon';
+export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon' | 'amazon';
 
 // Purchase verification provider selection
 // Defined locally for Nitro codegen (not in GQL schema)
@@ -149,7 +149,8 @@ export interface NitroReceiptValidationHorizonOptions {
   userId: VerifyPurchaseHorizonOptions['userId'];
 }
 
-export type NitroPurchaseUpdatedListenerOptions = PurchaseUpdatedListenerOptions;
+export type NitroPurchaseUpdatedListenerOptions =
+  PurchaseUpdatedListenerOptions;
 
 export interface NitroReceiptValidationParams {
   apple?: NitroReceiptValidationAppleOptions | null;
@@ -383,8 +384,18 @@ export interface NitroVerifyPurchaseWithIapkitGoogleProps {
   purchaseToken: string;
 }
 
+export interface NitroVerifyPurchaseWithIapkitAmazonProps {
+  /** Amazon Appstore receipt id returned by PurchaseResponse.getReceipt().getReceiptId(). */
+  receiptId: string;
+  /** Use Amazon RVS Cloud Sandbox for App Tester receipts. */
+  sandbox?: boolean | null;
+  /** Amazon Appstore user id returned by PurchaseResponse.getUserData().getUserId(). */
+  userId?: string | null;
+}
+
 export interface NitroVerifyPurchaseWithIapkitProps {
   apiKey?: string | null;
+  amazon?: NitroVerifyPurchaseWithIapkitAmazonProps | null;
   apple?: NitroVerifyPurchaseWithIapkitAppleProps | null;
   google?: NitroVerifyPurchaseWithIapkitGoogleProps | null;
 }

package/src/types/amazon-devices-kepler/index.d.ts

@@ -0,0 +1,14 @@
+declare module '@amazon-devices/keplerscript-appstore-iap-lib' {
+  export const PurchasingService: {
+    getProductData(request: {skus: string[]}): Promise<unknown>;
+    getPurchaseUpdates(request: {reset: boolean}): Promise<unknown>;
+    getUserData(request: {
+      fetchUserProfileAccessConsentStatus: boolean;
+    }): Promise<unknown>;
+    notifyFulfillment(request: {
+      fulfillmentResult: number;
+      receiptId: string;
+    }): Promise<unknown>;
+    purchase(request: {sku: string}): Promise<unknown>;
+  };
+}

package/src/types.ts

@@ -511,7 +511,7 @@ export type IapEvent = 'purchase-updated' | 'purchase-error' | 'promoted-product
 
 export type IapPlatform = 'ios' | 'android';
 
-export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon';
+export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon' | 'amazon';
 
 /** Unified purchase states from IAPKit verification response. */
 export type IapkitPurchaseState = 'entitled' | 'pending-acknowledgment' | 'pending' | 'canceled' | 'expired' | 'ready-to-consume' | 'consumed' | 'unknown' | 'inauthentic';
@@ -1614,7 +1614,8 @@ export type RequestPurchaseProps =
  *
  * Note: "Platforms" refers to the SDK/OS level (apple, google), not the store.
  * - apple: Always targets App Store
- * - google: Targets Play Store by default, or Horizon when built with horizon flavor
+ * - google: Targets Play Store by default, Horizon when built with horizon flavor,
+ *   or Fire OS when built with amazon flavor
  *   (determined at build time, not runtime)
  */
 export interface RequestPurchasePropsByPlatforms {
@@ -1713,7 +1714,8 @@ export interface RequestSubscriptionIosProps {
  *
  * Note: "Platforms" refers to the SDK/OS level (apple, google), not the store.
  * - apple: Always targets App Store
- * - google: Targets Play Store by default, or Horizon when built with horizon flavor
+ * - google: Targets Play Store by default, Horizon when built with horizon flavor,
+ *   or Fire OS when built with amazon flavor
  *   (determined at build time, not runtime)
  */
 export interface RequestSubscriptionPropsByPlatforms {
@@ -1727,6 +1729,15 @@ export interface RequestSubscriptionPropsByPlatforms {
   ios?: (RequestSubscriptionIosProps | null);
 }
 
+export interface RequestVerifyPurchaseWithIapkitAmazonProps {
+  /** Amazon Appstore receipt id returned by PurchaseResponse.getReceipt().getReceiptId(). */
+  receiptId: string;
+  /** Use Amazon RVS Cloud Sandbox for App Tester receipts. */
+  sandbox?: (boolean | null);
+  /** Amazon Appstore user id returned by PurchaseResponse.getUserData().getUserId(). */
+  userId?: (string | null);
+}
+
 export interface RequestVerifyPurchaseWithIapkitAppleProps {
   /** The JWS token returned with the purchase response. */
   jws: string;
@@ -1742,8 +1753,11 @@ export interface RequestVerifyPurchaseWithIapkitGoogleProps {
  *
  * - apple: Verifies via App Store (JWS token)
  * - google: Verifies via Play Store (purchase token)
+ * - amazon: Verifies via Amazon Appstore RVS (userId + receiptId)
  */
 export interface RequestVerifyPurchaseWithIapkitProps {
+  /** Amazon Appstore verification parameters. */
+  amazon?: (RequestVerifyPurchaseWithIapkitAmazonProps | null);
   /** API key used for the Authorization header (Bearer {apiKey}). */
   apiKey?: (string | null);
   /** Apple App Store verification parameters. */

package/src/utils/error.ts

@@ -116,12 +116,12 @@ const parseStructuredError = (error: Error): IapError | null => {
       unknown
     >;
 
-  if (typeof errorWithCode.code === 'string' && errorWithCode.code.length > 0) {
+  if (errorWithCode.code != null) {
     const {code, message, ...extraFields} = errorWithCode;
 
     return {
       ...extraFields,
-      code,
+      code: String(code),
       message: typeof message === 'string' ? message : error.message,
     };
   }

package/src/utils/type-bridge.ts

@@ -35,6 +35,7 @@ const STORE_UNKNOWN: IapStore = 'unknown';
 const STORE_APPLE: IapStore = 'apple';
 const STORE_GOOGLE: IapStore = 'google';
 const STORE_HORIZON: IapStore = 'horizon';
+const STORE_AMAZON: IapStore = 'amazon';
 const PRODUCT_TYPE_SUBS: ProductType = 'subs';
 const PRODUCT_TYPE_IN_APP: ProductType = 'in-app';
 const PURCHASE_STATE_PENDING: PurchaseState = 'pending';
@@ -67,6 +68,8 @@ function normalizeStore(value?: Nullable<string>): IapStore {
       return STORE_GOOGLE;
     case 'horizon':
       return STORE_HORIZON;
+    case 'amazon':
+      return STORE_AMAZON;
     default:
       return STORE_UNKNOWN;
   }
@@ -191,7 +194,7 @@ function toNullableBoolean(value: unknown): boolean | null {
 function parseSubscriptionOffers(value?: Nullable<string> | any[]) {
   if (!value) return undefined;
 
-  // If it's already an array (from mocks), return it as-is
+  // Keep pre-normalized native values intact.
   if (Array.isArray(value)) {
     return value;
   }