react-native-iap 16.0.2 → 16.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "16.0.2",
+  "version": "16.2.0",
   "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",
@@ -47,11 +47,11 @@
     "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}'",
+    "lint:eslint": "eslint --no-warn-ignored --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",
+    "prepare": "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",
@@ -61,7 +61,7 @@
     "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 nitro.json",
-    "prepare:husky": "husky install",
+    "prepare:husky": "husky",
     "precommit": "lint-staged",
     "ci:check": "./scripts/ci-check.sh",
     "generate:types": "node scripts/update-types.mjs",
@@ -87,39 +87,40 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@babel/plugin-proposal-private-methods": "^7.18.6",
-    "@commitlint/cli": "^19.8.1",
-    "@commitlint/config-conventional": "^19.8.1",
-    "@react-native/eslint-config": "0.81.0",
-    "@testing-library/react": "^16.3.0",
-    "@testing-library/react-hooks": "^8.0.1",
-    "@types/jest": "^29.5.12",
-    "@types/node": "^24.4.0",
-    "@types/react": "^19.1.12",
-    "babel-jest": "^30.1.1",
-    "eslint": "^8.57.0",
-    "eslint-config-expo": "^9.2.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-prettier": "^5.2.1",
-    "expo": "^53.0.20",
-    "husky": "^8.0.3",
-    "jest": "^30.1.1",
-    "lint-staged": "^15.2.0",
-    "nitrogen": "^0.36.1",
-    "prettier": "^3.3.3",
-    "react": "19.1.0",
-    "react-native": "0.81.1",
-    "react-native-builder-bob": "^0.38.4",
-    "react-native-nitro-modules": "^0.36.1",
-    "react-test-renderer": "^19.1.1",
-    "typescript": "^5.9.2"
+    "@babel/core": "^7.29.7",
+    "@commitlint/cli": "^21.2.1",
+    "@commitlint/config-conventional": "^21.2.0",
+    "@react-native/babel-preset": "0.86.2",
+    "@react-native/jest-preset": "0.86.2",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^26.2.0",
+    "@types/react": "^19.2.18",
+    "babel-jest": "^29.7.0",
+    "eslint": "^9.39.5",
+    "eslint-config-expo": "^57.0.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.6",
+    "expo": "^57.0.11",
+    "globals": "^17.9.0",
+    "husky": "^9.1.7",
+    "jest": "^29.7.0",
+    "lint-staged": "^17.3.0",
+    "nitrogen": "^0.36.5",
+    "prettier": "^3.9.6",
+    "react": "19.2.8",
+    "react-native": "0.86.2",
+    "react-native-builder-bob": "^0.43.0",
+    "react-native-nitro-modules": "^0.36.5",
+    "test-renderer": "^1.2.0",
+    "tsx": "^4.23.11",
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@amazon-devices/keplerscript-appstore-iap-lib": "~2.12.13",
+    "@amazon-devices/keplerscript-appstore-iap-lib": "~2.13.0",
     "@amazon-devices/package-manager-lib": "~1.0.1767254401",
     "react": "*",
     "react-native": "*",
-    "react-native-nitro-modules": "^0.36.1"
+    "react-native-nitro-modules": "^0.36.5"
   },
   "peerDependenciesMeta": {
     "@amazon-devices/keplerscript-appstore-iap-lib": {
@@ -132,10 +133,6 @@
   "workspaces": [
     "example"
   ],
-  "eslintIgnore": [
-    "node_modules/",
-    "lib/"
-  ],
   "react-native-builder-bob": {
     "source": "src",
     "output": "lib",
@@ -176,6 +173,6 @@
   },
   "packageManager": "yarn@3.6.1",
   "resolutions": {
-    "nitrogen@^0.36.1": "patch:nitrogen@npm%3A0.36.1#./.yarn/patches/nitrogen-npm-0.36.1-abe3b64156.patch"
+    "nitrogen@^0.36.5": "patch:nitrogen@npm%3A0.36.5#./.yarn/patches/nitrogen-npm-0.36.5-array-equatable.patch"
   }
 }

package/src/hooks/useIAP.ts

@@ -47,8 +47,6 @@ import type {
   VerifyPurchaseWithProviderProps,
   VerifyPurchaseWithProviderResult,
   PurchaseOptions,
-} from '../types';
-import type {
   ActiveSubscription,
   Product,
   Purchase,
@@ -57,8 +55,8 @@ import type {
   ProductSubscription,
   MutationField,
   QueryField,
+  MutationFinishTransactionArgs,
 } from '../types';
-import type {MutationFinishTransactionArgs} from '../types';
 
 // Types for event subscriptions
 interface EventSubscription {
@@ -354,7 +352,8 @@ export function useIAP(options?: UseIapOptions): UseIap {
   }>({});
 
   // Track if component is mounted to prevent listener leaks on early unmount
-  const isMountedRef = useRef<boolean>(true);
+  const isMountedRef = useRef<boolean>(false);
+  const initializationGenerationRef = useRef(0);
 
   const subscriptionsRefState = useRef<ProductSubscription[]>([]);
 
@@ -693,37 +692,56 @@ export function useIAP(options?: UseIapOptions): UseIap {
     subscriptionsRef.current.subscriptionBillingIssue = undefined;
   }, []);
 
-  const initIapWithSubscriptions = useCallback(async (): Promise<void> => {
-    const config = buildAndroidConfig();
-
-    try {
-      const result = await initConnection(config);
-
-      if (!isMountedRef.current) {
+  const initIapWithSubscriptions = useCallback(
+    async (generation: number): Promise<void> => {
+      if (
+        !isMountedRef.current ||
+        initializationGenerationRef.current !== generation
+      ) {
         return;
       }
 
-      if (!result) {
-        cleanupListeners();
-        setConnected(false);
-        RnIapConsole.warn('[useIAP] initConnection returned false');
-        return;
-      }
+      const config = buildAndroidConfig();
 
-      // Android retains events emitted during connection setup in bounded
-      // native queues; registration flushes that backlog after Nitro is ready.
-      // Other platforms preserve the existing post-init listener ordering.
-      registerListeners();
-      setConnected(true);
-    } catch (error) {
-      RnIapConsole.error('initConnection failed:', error);
-      cleanupListeners();
-      if (isMountedRef.current) {
-        setConnected(false);
+      try {
+        const result = await initConnection(config);
+
+        if (
+          !isMountedRef.current ||
+          initializationGenerationRef.current !== generation
+        ) {
+          return;
+        }
+
+        if (!result) {
+          cleanupListeners();
+          setConnected(false);
+          RnIapConsole.warn('[useIAP] initConnection returned false');
+          return;
+        }
+
+        // Android retains events emitted during connection setup in bounded
+        // native queues; registration flushes that backlog after Nitro is ready.
+        // Other platforms preserve the existing post-init listener ordering.
+        registerListeners();
+        setConnected(true);
+      } catch (error) {
+        if (
+          !isMountedRef.current ||
+          initializationGenerationRef.current !== generation
+        ) {
+          return;
+        }
+        RnIapConsole.error('initConnection failed:', error);
+        cleanupListeners();
+        if (isMountedRef.current) {
+          setConnected(false);
+        }
+        invokeOnError(error);
       }
-      invokeOnError(error);
-    }
-  }, [buildAndroidConfig, registerListeners, cleanupListeners, invokeOnError]);
+    },
+    [buildAndroidConfig, registerListeners, cleanupListeners, invokeOnError],
+  );
 
   const reconnect = useCallback(async (): Promise<boolean> => {
     const config = buildAndroidConfig();
@@ -755,8 +773,9 @@ export function useIAP(options?: UseIapOptions): UseIap {
   }, [buildAndroidConfig, registerListeners, cleanupListeners, invokeOnError]);
 
   useEffect(() => {
+    const generation = ++initializationGenerationRef.current;
     isMountedRef.current = true;
-    initIapWithSubscriptions();
+    void Promise.resolve().then(() => initIapWithSubscriptions(generation));
 
     return () => {
       isMountedRef.current = false;

package/src/index.ts

@@ -1,7 +1,6 @@
 // External dependencies
 import {Platform} from 'react-native';
-// Side-effect import ensures Nitro installs its dispatcher before IAP is used (no-op in tests)
-import 'react-native-nitro-modules';
+// Importing NitroModules installs its dispatcher before IAP is used (no-op in tests).
 import {NitroModules} from 'react-native-nitro-modules';
 
 // Internal modules
@@ -16,9 +15,21 @@ import type {
 } from './specs/RnIap.nitro';
 import {ErrorCode} from './types';
 import type {
+  AppTransaction,
   AndroidSubscriptionOfferInput,
+  ActiveSubscription,
+  BillingChoiceInfoAndroid,
+  BillingProgramAndroid,
+  BillingProgramInformationDialogParamsAndroid,
+  BillingProgramReportingDetailsAndroid,
+  BillingResultAndroid,
+  DeveloperBillingTypeAndroid,
+  DeveloperProvidedBillingDetailsAndroid,
   DiscountOfferInputIOS,
   FetchProductsResult,
+  GetBillingChoiceInfoParamsAndroid,
+  InAppMessageParamsAndroid,
+  InAppMessageResultAndroid,
   MutationField,
   Product,
   ProductIOS,
@@ -29,7 +40,6 @@ import type {
   PurchaseUpdatedListenerOptions,
   PurchaseIOS,
   QueryField,
-  AppTransaction,
   VerifyPurchaseResultAndroid,
   VerifyPurchaseResultIOS,
   RequestPurchaseAndroidProps,
@@ -38,8 +48,6 @@ import type {
   RequestSubscriptionAndroidProps,
   RequestSubscriptionIosProps,
   RequestSubscriptionPropsByPlatforms,
-  ActiveSubscription,
-  DeveloperProvidedBillingDetailsAndroid,
   UserChoiceBillingDetails,
 } from './types';
 import {
@@ -69,20 +77,8 @@ import {getVegaIapModule, isVegaOS} from './vega';
 // Billing Programs API (Android 8.2.0+)
 // ------------------------------
 
-// Note: BillingProgramAndroid, ExternalLinkLaunchModeAndroid, and ExternalLinkTypeAndroid
+// 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 {
-  BillingChoiceInfoAndroid,
-  BillingProgramAndroid,
-  BillingProgramInformationDialogParamsAndroid,
-  BillingProgramReportingDetailsAndroid,
-  BillingResultAndroid,
-  DeveloperBillingTypeAndroid,
-  GetBillingChoiceInfoParamsAndroid,
-  InAppMessageParamsAndroid,
-  InAppMessageResultAndroid,
-} from './types';
 
 // Export all types
 export type {
@@ -888,8 +884,7 @@ export const fetchProducts: QueryField<'fetchProducts'> = async (request) => {
 
     if (normalizedType === 'all') {
       const converted = (await fetchAndConvert('all')) as (
-        | Product
-        | ProductSubscription
+        Product | ProductSubscription
       )[];
 
       RnIapConsole.debug(
@@ -2263,8 +2258,10 @@ export const syncIOS: MutationField<'syncIOS'> = async () => {
 
 /**
  * Present the code redemption sheet for offer codes (iOS only)
- * @returns The verified redeemed purchase on iOS 27+, or null after the
- * legacy sheet is presented on earlier iOS versions.
+ * @returns The verified redeemed purchase when built with Xcode 27+ and
+ * running on Apple 27+. Earlier iOS/visionOS system sheets return null;
+ * Catalyst 16–26 surfaces StoreKitError.unknown, and Catalyst 15 is a no-op
+ * that returns null.
  * @platform iOS
  *
  * @see {@link https://openiap.dev/docs/apis/ios/present-code-redemption-sheet-ios}

package/src/specs/RnIap.nitro.ts

@@ -128,22 +128,16 @@ export type BillingChoiceImageLayoutAndroid =
   | 'rectangular-two-by-two';
 
 export type BillingChoiceScreenTypeAndroid =
-  | 'unspecified'
-  | 'developer-rendered'
-  | 'google-rendered';
+  'unspecified' | 'developer-rendered' | 'google-rendered';
 
 export type DeveloperBillingTypeAndroid =
-  | 'developer-billing-type-unspecified'
-  | 'in-app'
-  | 'external-link';
+  'developer-billing-type-unspecified' | 'in-app' | 'external-link';
 
 export type InAppMessageCategoryAndroid =
-  | 'unknown-in-app-message-category-id'
-  | 'transactional';
+  'unknown-in-app-message-category-id' | 'transactional';
 
 export type InAppMessageResponseCodeAndroid =
-  | 'no-action-needed'
-  | 'subscription-status-updated';
+  'no-action-needed' | 'subscription-status-updated';
 
 // Developer Billing Launch Mode (Android 8.3.0+)
 // Defined locally for Nitro codegen
@@ -162,9 +156,7 @@ export type ExternalLinkLaunchModeAndroid =
 // External Link Type (Android 8.2.0+)
 // Defined locally for Nitro codegen
 export type ExternalLinkTypeAndroid =
-  | 'unspecified'
-  | 'link-to-digital-content-offer'
-  | 'link-to-app-download';
+  'unspecified' | 'link-to-digital-content-offer' | 'link-to-app-download';
 
 // ╔══════════════════════════════════════════════════════════════════════════╗
 // ║                                  PARAMS                                  ║
@@ -836,8 +828,10 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
 
   /**
    * Present the code redemption sheet for offer codes (iOS only)
-   * @returns The verified redeemed purchase on iOS 27+, or null after the
-   * legacy sheet is presented on earlier iOS versions.
+   * @returns The verified redeemed purchase when built with Xcode 27+ and
+   * running on Apple 27+. Earlier iOS/visionOS system sheets return null;
+   * Catalyst 16–26 surfaces StoreKitError.unknown, and Catalyst 15 is a no-op
+   * that returns null.
    * @platform iOS
    */
   presentCodeRedemptionSheetIOS(): Promise<NitroPurchase | null>;

package/src/types.ts

@@ -46,6 +46,8 @@ export interface AdvancedCommerceInfoIOS {
   estimatedTax?: (string | null);
   /** The items purchased as part of this transaction */
   items: AdvancedCommerceItemIOS[];
+  /** Subscription period for this transaction */
+  period?: (SubscriptionPeriodValueIOS | null);
   /** Request reference identifier for tracking */
   requestReferenceId?: (string | null);
   /** Tax code for the transaction */
@@ -809,11 +811,15 @@ export interface Mutation {
   openRedeemOfferCodeAndroid: Promise<boolean>;
   /**
    * Show the App Store offer code redemption sheet.
-   * On iOS 27+, Mac Catalyst 27+, and visionOS 27+, returns the verified
-   * transaction produced by the redemption. Earlier iOS and Mac Catalyst
-   * versions present the legacy sheet and return null; reconcile purchases
-   * through the normal transaction listener or an explicit available-purchases
-   * refresh.
+   * When built with Xcode 27+ and running on iOS 27+, Mac Catalyst 27+, or
+   * visionOS 27+, returns the verified transaction produced by the redemption.
+   * StoreKit 2's scene-based sheet returns null after presentation on iOS 16–26,
+   * visionOS 1–26, and those platforms on Apple 27 when built with an older SDK.
+   * iOS 15 uses the StoreKit 1 sheet and also returns null. On Mac Catalyst, the
+   * scene-based API throws StoreKitError.unknown, while the Catalyst 15 StoreKit 1
+   * call has no effect and returns null. Reconcile null results from a presented
+   * sheet through the normal transaction listener or an explicit
+   * available-purchases refresh.
    * See: https://openiap.dev/docs/apis/ios/present-code-redemption-sheet-ios
    */
   presentCodeRedemptionSheetIOS?: Promise<(PurchaseIOS | null)>;
@@ -1427,7 +1433,12 @@ export interface Query {
    */
   getPendingTransactionsIOS: Promise<PurchaseIOS[]>;
   /**
-   * Read the App Store-promoted product, if any (iOS 11+).
+   * Read the App Store-promoted product, if any (iOS 15+).
+   * OpenIAP consumes PurchaseIntent.intents on iOS 16.4+ and uses the
+   * StoreKit 1 observer only on iOS 15–16.3. When PurchaseIntent carries an
+   * externally redeemed win-back offer, OpenIAP preserves it for the next
+   * matching requestPurchase unless the caller supplies an explicit win-back or
+   * promotional offer.
    * See: https://openiap.dev/docs/apis/ios/get-promoted-product-ios
    */
   getPromotedProductIOS?: Promise<(ProductIOS | null)>;
@@ -1864,7 +1875,12 @@ export interface Subscription {
    * openiap-google 2.3.0 (requires Play Billing 9.1.0+).
    */
   developerProvidedBillingAndroid: DeveloperProvidedBillingDetailsAndroid;
-  /** Fires when the App Store surfaces a promoted product (iOS only) */
+  /**
+   * Fires when the App Store surfaces a promoted product (iOS only).
+   * A win-back offer attached to PurchaseIntent is preserved for the next
+   * matching requestPurchase unless the caller supplies an explicit win-back or
+   * promotional offer.
+   */
   promotedProductIOS: string;
   /** Fires when a purchase fails or is cancelled */
   purchaseError: PurchaseError;

package/src/utils/type-bridge.ts

@@ -19,8 +19,6 @@ import type {
   ProductTypeIOS,
   PurchaseState,
   SubscriptionPeriodIOS,
-} from '../types';
-import type {
   Product,
   ProductSubscription,
   Purchase,

package/lib/module/types/react-test-renderer.d.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=react-test-renderer.d.js.map

package/lib/module/types/react-test-renderer.d.js.map

@@ -1 +0,0 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/react-test-renderer.d.ts"],"mappings":"","ignoreList":[]}

package/src/types/react-test-renderer.d.ts

@@ -1,7 +0,0 @@
-declare module 'react-test-renderer' {
-  export function act(
-    callback: () => void | Promise<void>,
-  ): void | Promise<void>;
-  const TestRenderer: any;
-  export default TestRenderer;
-}