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

package/package.json

@@ -1,24 +1,21 @@
 {
   "name": "react-native-iap",
-  "version": "15.3.6",
+  "version": "15.4.0-rc.2",
   "description": "React Native In-App Purchases module for iOS and Android using Nitro",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
   "exports": {
     ".": {
       "source": "./src/index.ts",
+      "react-native": "./src/index.ts",
       "types": "./lib/typescript/src/index.d.ts",
-      "default": "./lib/module/index.js",
-      "react-native": "./src/index.ts"
+      "default": "./lib/module/index.js"
     },
-    "./plugin": "./app.plugin.js",
-    "./app.plugin.js": "./app.plugin.js",
     "./package.json": "./package.json"
   },
   "files": [
     "src",
     "lib",
-    "plugin",
     "android",
     "ios",
     "cpp",
@@ -26,7 +23,6 @@
     "nitro.json",
     "openiap-versions.json",
     "*.podspec",
-    "app.plugin.js",
     "react-native.config.js",
     "!ios/build",
     "!android/build",
@@ -34,13 +30,15 @@
     "!android/gradlew",
     "!android/gradlew.bat",
     "!android/local.properties",
+    "!android/src/androidTest",
+    "!android/src/test",
     "!**/__tests__",
     "!**/__fixtures__",
     "!**/__mocks__",
+    "!**/*.tsbuildinfo",
     "!**/.*"
   ],
   "scripts": {
-    "build:plugin": "tsc --build plugin",
     "example": "yarn workspace rn-iap-example",
     "example:ios": "yarn workspace rn-iap-example ios",
     "example:android": "yarn workspace rn-iap-example android",
@@ -49,21 +47,20 @@
     "typecheck:lib": "yarn tsc --noEmit",
     "clean": "rm -rf android/build node_modules/**/android/build lib nitrogen/generated",
     "lint": "eslint --ext .ts,.tsx,.js,.jsx src",
-    "lint:eslint": "eslint --fix 'src/**/*.{ts,tsx}' 'plugin/src/**/*.{ts,tsx}'",
+    "lint:eslint": "eslint --fix 'src/**/*.{ts,tsx}'",
     "lint:prettier": "prettier --write \"**/*.{md,js,jsx,ts,tsx}\"",
     "lint:tsc": "tsc -p tsconfig.json --noEmit --skipLibCheck",
     "lint:ci": "yarn lint:tsc && yarn lint:eslint && yarn lint:prettier",
-    "prepare": "npx tsx scripts/check-nitro-versions.ts && bob build && yarn nitrogen && yarn build:plugin",
+    "prepare": "npx tsx scripts/check-nitro-versions.ts && bob build && yarn nitrogen",
     "nitrogen": "node --stack-size=65536 node_modules/nitrogen/lib/index.js",
     "specs": "yarn nitrogen --logLevel=\"debug\"",
     "test": "jest --coverage",
     "test:library": "jest --coverage",
     "test:example": "yarn workspace rn-iap-example test --coverage",
-    "test:plugin": "jest plugin --coverage",
     "test:all": "yarn test:library && yarn test:example",
     "test:ci": "jest --maxWorkers=2 --coverage",
     "test:ci:example": "yarn workspace rn-iap-example test --coverage",
-    "verify:consumer-install": "node ../../scripts/verify-npm-consumer-install.mjs --package . --package-name react-native-iap --required openiap-versions.json --required lib/module/index.js --required lib/typescript/src/index.d.ts --required android/build.gradle --required NitroIap.podspec --required app.plugin.js --required nitro.json",
+    "verify:consumer-install": "node ../../scripts/verify-npm-consumer-install.mjs --package . --package-name react-native-iap --required openiap-versions.json --required lib/module/index.js --required lib/typescript/src/index.d.ts --required android/build.gradle --required NitroIap.podspec --required nitro.json",
     "prepare:husky": "husky install",
     "precommit": "lint-staged",
     "ci:check": "./scripts/ci-check.sh",
@@ -118,10 +115,20 @@
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
+    "@amazon-devices/keplerscript-appstore-iap-lib": "~2.12.13",
+    "@amazon-devices/package-manager-lib": "~1.0.1767254401",
     "react": "*",
     "react-native": "*",
     "react-native-nitro-modules": "^0.35.0"
   },
+  "peerDependenciesMeta": {
+    "@amazon-devices/keplerscript-appstore-iap-lib": {
+      "optional": true
+    },
+    "@amazon-devices/package-manager-lib": {
+      "optional": true
+    }
+  },
   "workspaces": [
     "example"
   ],

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>;
+  };
+}