react-native-iap 14.3.9 → 14.4.0

package/nitrogen/generated/shared/c++/PurchaseIOS.hpp

@@ -67,12 +67,13 @@ namespace margelo::nitro::iap {
     std::optional<std::string> storefrontCountryCodeIOS     SWIFT_PRIVATE;
     std::optional<std::string> subscriptionGroupIdIOS     SWIFT_PRIVATE;
     double transactionDate     SWIFT_PRIVATE;
+    std::string transactionId     SWIFT_PRIVATE;
     std::optional<std::string> transactionReasonIOS     SWIFT_PRIVATE;
     std::optional<std::string> webOrderLineItemIdIOS     SWIFT_PRIVATE;
 
   public:
     PurchaseIOS() = default;
-    explicit PurchaseIOS(std::optional<std::string> appAccountToken, std::optional<std::string> appBundleIdIOS, std::optional<std::string> countryCodeIOS, std::optional<std::string> currencyCodeIOS, std::optional<std::string> currencySymbolIOS, std::optional<std::string> environmentIOS, std::optional<double> expirationDateIOS, std::string id, std::optional<std::vector<std::string>> ids, bool isAutoRenewing, std::optional<bool> isUpgradedIOS, std::optional<PurchaseOfferIOS> offerIOS, std::optional<double> originalTransactionDateIOS, std::optional<std::string> originalTransactionIdentifierIOS, std::optional<std::string> ownershipTypeIOS, IapPlatform platform, std::string productId, PurchaseState purchaseState, std::optional<std::string> purchaseToken, double quantity, std::optional<double> quantityIOS, std::optional<std::string> reasonIOS, std::optional<std::string> reasonStringRepresentationIOS, std::optional<double> revocationDateIOS, std::optional<std::string> revocationReasonIOS, std::optional<std::string> storefrontCountryCodeIOS, std::optional<std::string> subscriptionGroupIdIOS, double transactionDate, std::optional<std::string> transactionReasonIOS, std::optional<std::string> webOrderLineItemIdIOS): appAccountToken(appAccountToken), appBundleIdIOS(appBundleIdIOS), countryCodeIOS(countryCodeIOS), currencyCodeIOS(currencyCodeIOS), currencySymbolIOS(currencySymbolIOS), environmentIOS(environmentIOS), expirationDateIOS(expirationDateIOS), id(id), ids(ids), isAutoRenewing(isAutoRenewing), isUpgradedIOS(isUpgradedIOS), offerIOS(offerIOS), originalTransactionDateIOS(originalTransactionDateIOS), originalTransactionIdentifierIOS(originalTransactionIdentifierIOS), ownershipTypeIOS(ownershipTypeIOS), platform(platform), productId(productId), purchaseState(purchaseState), purchaseToken(purchaseToken), quantity(quantity), quantityIOS(quantityIOS), reasonIOS(reasonIOS), reasonStringRepresentationIOS(reasonStringRepresentationIOS), revocationDateIOS(revocationDateIOS), revocationReasonIOS(revocationReasonIOS), storefrontCountryCodeIOS(storefrontCountryCodeIOS), subscriptionGroupIdIOS(subscriptionGroupIdIOS), transactionDate(transactionDate), transactionReasonIOS(transactionReasonIOS), webOrderLineItemIdIOS(webOrderLineItemIdIOS) {}
+    explicit PurchaseIOS(std::optional<std::string> appAccountToken, std::optional<std::string> appBundleIdIOS, std::optional<std::string> countryCodeIOS, std::optional<std::string> currencyCodeIOS, std::optional<std::string> currencySymbolIOS, std::optional<std::string> environmentIOS, std::optional<double> expirationDateIOS, std::string id, std::optional<std::vector<std::string>> ids, bool isAutoRenewing, std::optional<bool> isUpgradedIOS, std::optional<PurchaseOfferIOS> offerIOS, std::optional<double> originalTransactionDateIOS, std::optional<std::string> originalTransactionIdentifierIOS, std::optional<std::string> ownershipTypeIOS, IapPlatform platform, std::string productId, PurchaseState purchaseState, std::optional<std::string> purchaseToken, double quantity, std::optional<double> quantityIOS, std::optional<std::string> reasonIOS, std::optional<std::string> reasonStringRepresentationIOS, std::optional<double> revocationDateIOS, std::optional<std::string> revocationReasonIOS, std::optional<std::string> storefrontCountryCodeIOS, std::optional<std::string> subscriptionGroupIdIOS, double transactionDate, std::string transactionId, std::optional<std::string> transactionReasonIOS, std::optional<std::string> webOrderLineItemIdIOS): appAccountToken(appAccountToken), appBundleIdIOS(appBundleIdIOS), countryCodeIOS(countryCodeIOS), currencyCodeIOS(currencyCodeIOS), currencySymbolIOS(currencySymbolIOS), environmentIOS(environmentIOS), expirationDateIOS(expirationDateIOS), id(id), ids(ids), isAutoRenewing(isAutoRenewing), isUpgradedIOS(isUpgradedIOS), offerIOS(offerIOS), originalTransactionDateIOS(originalTransactionDateIOS), originalTransactionIdentifierIOS(originalTransactionIdentifierIOS), ownershipTypeIOS(ownershipTypeIOS), platform(platform), productId(productId), purchaseState(purchaseState), purchaseToken(purchaseToken), quantity(quantity), quantityIOS(quantityIOS), reasonIOS(reasonIOS), reasonStringRepresentationIOS(reasonStringRepresentationIOS), revocationDateIOS(revocationDateIOS), revocationReasonIOS(revocationReasonIOS), storefrontCountryCodeIOS(storefrontCountryCodeIOS), subscriptionGroupIdIOS(subscriptionGroupIdIOS), transactionDate(transactionDate), transactionId(transactionId), transactionReasonIOS(transactionReasonIOS), webOrderLineItemIdIOS(webOrderLineItemIdIOS) {}
   };
 
 } // namespace margelo::nitro::iap
@@ -113,6 +114,7 @@ namespace margelo::nitro {
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "storefrontCountryCodeIOS")),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "subscriptionGroupIdIOS")),
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "transactionDate")),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "transactionId")),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "transactionReasonIOS")),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "webOrderLineItemIdIOS"))
       );
@@ -147,6 +149,7 @@ namespace margelo::nitro {
       obj.setProperty(runtime, "storefrontCountryCodeIOS", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.storefrontCountryCodeIOS));
       obj.setProperty(runtime, "subscriptionGroupIdIOS", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.subscriptionGroupIdIOS));
       obj.setProperty(runtime, "transactionDate", JSIConverter<double>::toJSI(runtime, arg.transactionDate));
+      obj.setProperty(runtime, "transactionId", JSIConverter<std::string>::toJSI(runtime, arg.transactionId));
       obj.setProperty(runtime, "transactionReasonIOS", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.transactionReasonIOS));
       obj.setProperty(runtime, "webOrderLineItemIdIOS", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.webOrderLineItemIdIOS));
       return obj;
@@ -184,6 +187,7 @@ namespace margelo::nitro {
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "storefrontCountryCodeIOS"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "subscriptionGroupIdIOS"))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "transactionDate"))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "transactionId"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "transactionReasonIOS"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "webOrderLineItemIdIOS"))) return false;
       return true;

package/nitrogen/generated/shared/c++/PurchaseState.hpp

@@ -29,11 +29,11 @@ namespace margelo::nitro::iap {
    * An enum which can be represented as a JavaScript union (PurchaseState).
    */
   enum class PurchaseState {
-    DEFERRED      SWIFT_NAME(deferred) = 0,
-    FAILED      SWIFT_NAME(failed) = 1,
-    PENDING      SWIFT_NAME(pending) = 2,
-    PURCHASED      SWIFT_NAME(purchased) = 3,
-    RESTORED      SWIFT_NAME(restored) = 4,
+    PENDING      SWIFT_NAME(pending) = 0,
+    PURCHASED      SWIFT_NAME(purchased) = 1,
+    FAILED      SWIFT_NAME(failed) = 2,
+    RESTORED      SWIFT_NAME(restored) = 3,
+    DEFERRED      SWIFT_NAME(deferred) = 4,
     UNKNOWN      SWIFT_NAME(unknown) = 5,
   } CLOSED_ENUM;
 
@@ -47,11 +47,11 @@ namespace margelo::nitro {
     static inline margelo::nitro::iap::PurchaseState fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
       std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
       switch (hashString(unionValue.c_str(), unionValue.size())) {
-        case hashString("deferred"): return margelo::nitro::iap::PurchaseState::DEFERRED;
-        case hashString("failed"): return margelo::nitro::iap::PurchaseState::FAILED;
         case hashString("pending"): return margelo::nitro::iap::PurchaseState::PENDING;
         case hashString("purchased"): return margelo::nitro::iap::PurchaseState::PURCHASED;
+        case hashString("failed"): return margelo::nitro::iap::PurchaseState::FAILED;
         case hashString("restored"): return margelo::nitro::iap::PurchaseState::RESTORED;
+        case hashString("deferred"): return margelo::nitro::iap::PurchaseState::DEFERRED;
         case hashString("unknown"): return margelo::nitro::iap::PurchaseState::UNKNOWN;
         default: [[unlikely]]
           throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum PurchaseState - invalid value!");
@@ -59,11 +59,11 @@ namespace margelo::nitro {
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::iap::PurchaseState arg) {
       switch (arg) {
-        case margelo::nitro::iap::PurchaseState::DEFERRED: return JSIConverter<std::string>::toJSI(runtime, "deferred");
-        case margelo::nitro::iap::PurchaseState::FAILED: return JSIConverter<std::string>::toJSI(runtime, "failed");
         case margelo::nitro::iap::PurchaseState::PENDING: return JSIConverter<std::string>::toJSI(runtime, "pending");
         case margelo::nitro::iap::PurchaseState::PURCHASED: return JSIConverter<std::string>::toJSI(runtime, "purchased");
+        case margelo::nitro::iap::PurchaseState::FAILED: return JSIConverter<std::string>::toJSI(runtime, "failed");
         case margelo::nitro::iap::PurchaseState::RESTORED: return JSIConverter<std::string>::toJSI(runtime, "restored");
+        case margelo::nitro::iap::PurchaseState::DEFERRED: return JSIConverter<std::string>::toJSI(runtime, "deferred");
         case margelo::nitro::iap::PurchaseState::UNKNOWN: return JSIConverter<std::string>::toJSI(runtime, "unknown");
         default: [[unlikely]]
           throw std::invalid_argument("Cannot convert PurchaseState to JS - invalid value: "
@@ -76,11 +76,11 @@ namespace margelo::nitro {
       }
       std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
       switch (hashString(unionValue.c_str(), unionValue.size())) {
-        case hashString("deferred"):
-        case hashString("failed"):
         case hashString("pending"):
         case hashString("purchased"):
+        case hashString("failed"):
         case hashString("restored"):
+        case hashString("deferred"):
         case hashString("unknown"):
           return true;
         default:

package/openiap-versions.json

@@ -0,0 +1,5 @@
+{
+  "apple": "1.2.2",
+  "google": "1.2.6",
+  "gql": "1.0.8"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "14.3.9",
+  "version": "14.4.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",
@@ -24,6 +24,7 @@
     "cpp",
     "nitrogen",
     "nitro.json",
+    "openiap-versions.json",
     "*.podspec",
     "app.plugin.js",
     "react-native.config.js",
@@ -67,7 +68,7 @@
     "prepare:husky": "husky install",
     "precommit": "lint-staged",
     "ci:check": "./scripts/ci-check.sh",
-    "generate:types": "node scripts/update-types.mjs --tag 1.0.6",
+    "generate:types": "node scripts/update-types.mjs",
     "generate:icon": "cd docs/static/img && npx sharp-cli resize 32 32 --input icon.png --output favicon-32x32.png && npx sharp-cli resize 16 16 --input icon.png --output favicon-16x16.png && npx sharp-cli resize 192 192 --input icon.png --output android-chrome-192x192.png && npx sharp-cli resize 512 512 --input icon.png --output android-chrome-512x512.png && npx sharp-cli resize 180 180 --input icon.png --output apple-touch-icon.png && npx sharp-cli resize 1200 630 --input icon.png --output og-image.png && npx sharp-cli resize 150 150 --input icon.png --output favicon.png && npx sharp-cli --input favicon-32x32.png --output favicon.ico",
     "commitlint": "commitlint"
   },

package/plugin/build/withIAP.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = exports.modifyProjectBuildGradle = void 0;
 const config_plugins_1 = require("expo/config-plugins");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
 const pkg = require('../../package.json');
 // Global flag to prevent duplicate logs
 let hasLoggedPluginExecution = false;
@@ -31,16 +33,46 @@ const modifyProjectBuildGradle = (gradle) => {
 };
 exports.modifyProjectBuildGradle = modifyProjectBuildGradle;
 const OPENIAP_COORD = 'io.github.hyochan.openiap:openiap-google';
-const OPENIAP_VERSION = '1.1.12';
+function loadOpenIapConfig() {
+    const versionsPath = (0, node_path_1.resolve)(__dirname, '../../openiap-versions.json');
+    try {
+        const raw = (0, node_fs_1.readFileSync)(versionsPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const googleVersion = typeof parsed?.google === 'string' ? parsed.google.trim() : '';
+        if (!googleVersion) {
+            throw new Error('react-native-iap: "google" version missing or invalid in openiap-versions.json');
+        }
+        return { google: googleVersion };
+    }
+    catch (error) {
+        throw new Error(`react-native-iap: Unable to load openiap-versions.json (${error instanceof Error ? error.message : error})`);
+    }
+}
+let cachedOpenIapVersion = null;
+const getOpenIapVersion = () => {
+    if (cachedOpenIapVersion) {
+        return cachedOpenIapVersion;
+    }
+    cachedOpenIapVersion = loadOpenIapConfig().google;
+    return cachedOpenIapVersion;
+};
 const modifyAppBuildGradle = (gradle) => {
     let modified = gradle;
+    let openiapVersion;
+    try {
+        openiapVersion = getOpenIapVersion();
+    }
+    catch (error) {
+        config_plugins_1.WarningAggregator.addWarningAndroid('react-native-iap', `react-native-iap: Failed to resolve OpenIAP version (${error instanceof Error ? error.message : error})`);
+        return gradle;
+    }
     // Replace legacy Billing/GMS instructions with OpenIAP Google library
     // Remove any old billingclient or play-services-base lines we may have added previously
     modified = modified
         .replace(/^[ \t]*(implementation|api)[ \t]+["']com\.android\.billingclient:billing-ktx:[^"']+["'][ \t]*$/gim, '')
         .replace(/^[ \t]*(implementation|api)[ \t]+["']com\.google\.android\.gms:play-services-base:[^"']+["'][ \t]*$/gim, '')
         .replace(/\n{3,}/g, '\n\n');
-    const openiapDep = `    implementation "${OPENIAP_COORD}:${OPENIAP_VERSION}"`;
+    const openiapDep = `    implementation "${OPENIAP_COORD}:${openiapVersion}"`;
     if (!modified.includes(OPENIAP_COORD)) {
         if (!/dependencies\s*{/.test(modified)) {
             modified += `\n\ndependencies {\n${openiapDep}\n}\n`;
@@ -49,7 +81,7 @@ const modifyAppBuildGradle = (gradle) => {
             modified = addLineToGradle(modified, /dependencies\s*{/, openiapDep);
         }
         if (!hasLoggedPluginExecution) {
-            console.log(`🛠️ react-native-iap: Added OpenIAP (${OPENIAP_VERSION}) to build.gradle`);
+            console.log(`🛠️ react-native-iap: Added OpenIAP (${openiapVersion}) to build.gradle`);
         }
     }
     return modified;

package/plugin/src/withIAP.ts

@@ -7,6 +7,8 @@ import {
 } from 'expo/config-plugins';
 import type {ConfigPlugin} from 'expo/config-plugins';
 import type {ExpoConfig} from '@expo/config-types';
+import {readFileSync} from 'node:fs';
+import {resolve as resolvePath} from 'node:path';
 
 const pkg = require('../../package.json');
 
@@ -46,11 +48,50 @@ export const modifyProjectBuildGradle = (gradle: string): string => {
 };
 
 const OPENIAP_COORD = 'io.github.hyochan.openiap:openiap-google';
-const OPENIAP_VERSION = '1.1.12';
+
+function loadOpenIapConfig(): {google: string} {
+  const versionsPath = resolvePath(__dirname, '../../openiap-versions.json');
+  try {
+    const raw = readFileSync(versionsPath, 'utf8');
+    const parsed = JSON.parse(raw);
+    const googleVersion =
+      typeof parsed?.google === 'string' ? parsed.google.trim() : '';
+    if (!googleVersion) {
+      throw new Error(
+        'react-native-iap: "google" version missing or invalid in openiap-versions.json',
+      );
+    }
+    return {google: googleVersion};
+  } catch (error) {
+    throw new Error(
+      `react-native-iap: Unable to load openiap-versions.json (${error instanceof Error ? error.message : error})`,
+    );
+  }
+}
+
+let cachedOpenIapVersion: string | null = null;
+const getOpenIapVersion = (): string => {
+  if (cachedOpenIapVersion) {
+    return cachedOpenIapVersion;
+  }
+  cachedOpenIapVersion = loadOpenIapConfig().google;
+  return cachedOpenIapVersion;
+};
 
 const modifyAppBuildGradle = (gradle: string): string => {
   let modified = gradle;
 
+  let openiapVersion: string;
+  try {
+    openiapVersion = getOpenIapVersion();
+  } catch (error) {
+    WarningAggregator.addWarningAndroid(
+      'react-native-iap',
+      `react-native-iap: Failed to resolve OpenIAP version (${error instanceof Error ? error.message : error})`,
+    );
+    return gradle;
+  }
+
   // Replace legacy Billing/GMS instructions with OpenIAP Google library
   // Remove any old billingclient or play-services-base lines we may have added previously
   modified = modified
@@ -64,7 +105,7 @@ const modifyAppBuildGradle = (gradle: string): string => {
     )
     .replace(/\n{3,}/g, '\n\n');
 
-  const openiapDep = `    implementation "${OPENIAP_COORD}:${OPENIAP_VERSION}"`;
+  const openiapDep = `    implementation "${OPENIAP_COORD}:${openiapVersion}"`;
 
   if (!modified.includes(OPENIAP_COORD)) {
     if (!/dependencies\s*{/.test(modified)) {
@@ -74,7 +115,7 @@ const modifyAppBuildGradle = (gradle: string): string => {
     }
     if (!hasLoggedPluginExecution) {
       console.log(
-        `🛠️ react-native-iap: Added OpenIAP (${OPENIAP_VERSION}) to build.gradle`,
+        `🛠️ react-native-iap: Added OpenIAP (${openiapVersion}) to build.gradle`,
       );
     }
   }

package/src/hooks/useIAP.ts

@@ -45,8 +45,6 @@ interface EventSubscription {
 type UseIap = {
   connected: boolean;
   products: Product[];
-  promotedProductsIOS: Purchase[];
-  promotedProductIdIOS?: string;
   subscriptions: ProductSubscription[];
   availablePurchases: Purchase[];
   promotedProductIOS?: Product;
@@ -57,16 +55,6 @@ type UseIap = {
     skus: string[];
     type?: ProductQueryType | null;
   }) => Promise<void>;
-  /**
-   * @deprecated Use fetchProducts({ skus, type: 'in-app' }) instead. This method will be removed in version 3.0.0.
-   * Note: This method internally uses fetchProducts, so no deprecation warning is shown.
-   */
-  getProducts: (skus: string[]) => Promise<void>;
-  /**
-   * @deprecated Use fetchProducts({ skus, type: 'subs' }) instead. This method will be removed in version 3.0.0.
-   * Note: This method internally uses fetchProducts, so no deprecation warning is shown.
-   */
-  getSubscriptions: (skus: string[]) => Promise<void>;
   requestPurchase: (
     params: RequestPurchaseProps,
   ) => Promise<RequestPurchaseResult | null>;
@@ -103,11 +91,9 @@ export interface UseIapOptions {
 export function useIAP(options?: UseIapOptions): UseIap {
   const [connected, setConnected] = useState<boolean>(false);
   const [products, setProducts] = useState<Product[]>([]);
-  const [promotedProductsIOS] = useState<Purchase[]>([]);
   const [subscriptions, setSubscriptions] = useState<ProductSubscription[]>([]);
   const [availablePurchases, setAvailablePurchases] = useState<Purchase[]>([]);
   const [promotedProductIOS, setPromotedProductIOS] = useState<Product>();
-  const [promotedProductIdIOS] = useState<string>();
   const [activeSubscriptions, setActiveSubscriptions] = useState<
     ActiveSubscription[]
   >([]);
@@ -147,7 +133,6 @@ export function useIAP(options?: UseIapOptions): UseIap {
   const subscriptionsRef = useRef<{
     purchaseUpdate?: EventSubscription;
     purchaseError?: EventSubscription;
-    promotedProductsIOS?: EventSubscription;
     promotedProductIOS?: EventSubscription;
   }>({});
 
@@ -157,54 +142,6 @@ export function useIAP(options?: UseIapOptions): UseIap {
     subscriptionsRefState.current = subscriptions;
   }, [subscriptions]);
 
-  const getProductsInternal = useCallback(
-    async (skus: string[]): Promise<void> => {
-      try {
-        const result = await fetchProducts({
-          skus,
-          type: 'in-app',
-        });
-        const newProducts = (result ?? []).filter(
-          (item): item is Product => item.type === 'in-app',
-        );
-        setProducts((prevProducts: Product[]) =>
-          mergeWithDuplicateCheck(
-            prevProducts,
-            newProducts,
-            (product: Product) => product.id,
-          ),
-        );
-      } catch (error) {
-        console.error('Error fetching products:', error);
-      }
-    },
-    [mergeWithDuplicateCheck],
-  );
-
-  const getSubscriptionsInternal = useCallback(
-    async (skus: string[]): Promise<void> => {
-      try {
-        const result = await fetchProducts({
-          skus,
-          type: 'subs',
-        });
-        const newSubscriptions = (result ?? []).filter(
-          (item): item is ProductSubscription => item.type === 'subs',
-        );
-        setSubscriptions((prevSubscriptions: ProductSubscription[]) =>
-          mergeWithDuplicateCheck(
-            prevSubscriptions,
-            newSubscriptions,
-            (subscription: ProductSubscription) => subscription.id,
-          ),
-        );
-      } catch (error) {
-        console.error('Error fetching subscriptions:', error);
-      }
-    },
-    [mergeWithDuplicateCheck],
-  );
-
   const fetchProductsInternal = useCallback(
     async (params: {
       skus: string[];
@@ -395,9 +332,11 @@ export function useIAP(options?: UseIapOptions): UseIap {
     });
 
     if (Platform.OS === 'ios') {
-      subscriptionsRef.current.promotedProductsIOS = promotedProductListenerIOS(
+      // iOS promoted products listener
+      subscriptionsRef.current.promotedProductIOS = promotedProductListenerIOS(
         (product: Product) => {
           setPromotedProductIOS(product);
+
           if (optionsRef.current?.onPromotedProductIOS) {
             optionsRef.current.onPromotedProductIOS(product);
           }
@@ -410,9 +349,7 @@ export function useIAP(options?: UseIapOptions): UseIap {
     if (!result) {
       // Clean up some listeners but leave purchaseError for potential retries
       subscriptionsRef.current.purchaseUpdate?.remove();
-      subscriptionsRef.current.promotedProductsIOS?.remove();
       subscriptionsRef.current.purchaseUpdate = undefined;
-      subscriptionsRef.current.promotedProductsIOS = undefined;
       return;
     }
   }, [getActiveSubscriptionsInternal, getAvailablePurchasesInternal]);
@@ -424,7 +361,6 @@ export function useIAP(options?: UseIapOptions): UseIap {
     return () => {
       currentSubscriptions.purchaseUpdate?.remove();
       currentSubscriptions.purchaseError?.remove();
-      currentSubscriptions.promotedProductsIOS?.remove();
       currentSubscriptions.promotedProductIOS?.remove();
       // Keep connection alive across screens to avoid race conditions
       setConnected(false);
@@ -434,8 +370,6 @@ export function useIAP(options?: UseIapOptions): UseIap {
   return {
     connected,
     products,
-    promotedProductsIOS,
-    promotedProductIdIOS,
     subscriptions,
     finishTransaction,
     availablePurchases,
@@ -453,8 +387,6 @@ export function useIAP(options?: UseIapOptions): UseIap {
         console.warn('Failed to restore purchases:', e);
       }
     },
-    getProducts: getProductsInternal,
-    getSubscriptions: getSubscriptionsInternal,
     getPromotedProductIOS,
     requestPurchaseOnPromotedProductIOS,
     getActiveSubscriptions: getActiveSubscriptionsInternal,

package/src/index.ts

@@ -443,7 +443,10 @@ export const getPromotedProductIOS: QueryField<
   }
 
   try {
-    const nitroProduct = await IAP.instance.requestPromotedProductIOS();
+    const nitroProduct =
+      typeof IAP.instance.getPromotedProductIOS === 'function'
+        ? await IAP.instance.getPromotedProductIOS()
+        : await IAP.instance.requestPromotedProductIOS();
     if (!nitroProduct) {
       return null;
     }
@@ -638,6 +641,40 @@ export const getReceiptDataIOS: QueryField<'getReceiptDataIOS'> = async () => {
   }
 };
 
+export const getReceiptIOS = async (): Promise<string> => {
+  if (Platform.OS !== 'ios') {
+    throw new Error('getReceiptIOS is only available on iOS');
+  }
+
+  try {
+    if (typeof IAP.instance.getReceiptIOS === 'function') {
+      return await IAP.instance.getReceiptIOS();
+    }
+    return await IAP.instance.getReceiptDataIOS();
+  } catch (error) {
+    console.error('[getReceiptIOS] Failed:', error);
+    const errorJson = parseErrorStringToJsonObj(error);
+    throw new Error(errorJson.message);
+  }
+};
+
+export const requestReceiptRefreshIOS = async (): Promise<string> => {
+  if (Platform.OS !== 'ios') {
+    throw new Error('requestReceiptRefreshIOS is only available on iOS');
+  }
+
+  try {
+    if (typeof IAP.instance.requestReceiptRefreshIOS === 'function') {
+      return await IAP.instance.requestReceiptRefreshIOS();
+    }
+    return await IAP.instance.getReceiptDataIOS();
+  } catch (error) {
+    console.error('[requestReceiptRefreshIOS] Failed:', error);
+    const errorJson = parseErrorStringToJsonObj(error);
+    throw new Error(errorJson.message);
+  }
+};
+
 export const isTransactionVerifiedIOS: QueryField<
   'isTransactionVerifiedIOS'
 > = async (sku) => {
@@ -1258,13 +1295,35 @@ export const deepLinkToSubscriptions: MutationField<
   }
   if (Platform.OS === 'ios') {
     try {
-      await IAP.instance.showManageSubscriptionsIOS();
+      if (typeof IAP.instance.deepLinkToSubscriptionsIOS === 'function') {
+        await IAP.instance.deepLinkToSubscriptionsIOS();
+      } else {
+        await IAP.instance.showManageSubscriptionsIOS();
+      }
     } catch (error) {
       console.warn('[deepLinkToSubscriptions] Failed on iOS:', error);
     }
   }
 };
 
+export const deepLinkToSubscriptionsIOS = async (): Promise<boolean> => {
+  if (Platform.OS !== 'ios') {
+    throw new Error('deepLinkToSubscriptionsIOS is only available on iOS');
+  }
+
+  try {
+    if (typeof IAP.instance.deepLinkToSubscriptionsIOS === 'function') {
+      return await IAP.instance.deepLinkToSubscriptionsIOS();
+    }
+    await IAP.instance.showManageSubscriptionsIOS();
+    return true;
+  } catch (error) {
+    console.error('[deepLinkToSubscriptionsIOS] Failed:', error);
+    const errorJson = parseErrorStringToJsonObj(error);
+    throw new Error(errorJson.message);
+  }
+};
+
 /**
  * iOS only - Gets the original app transaction ID if the app was purchased from the App Store
  * @platform iOS

package/src/specs/RnIap.nitro.ts

@@ -369,6 +369,13 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
    */
   requestPromotedProductIOS(): Promise<NitroProduct | null>;
 
+  /**
+   * Retrieve the currently promoted product without initiating a purchase flow (iOS only)
+   * @returns Promise<NitroProduct | null> - The promoted product or null if none available
+   * @platform iOS
+   */
+  getPromotedProductIOS(): Promise<NitroProduct | null>;
+
   /**
    * Buy the promoted product from the App Store (iOS only)
    * @returns Promise<void>
@@ -443,6 +450,13 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
    */
   showManageSubscriptionsIOS(): Promise<NitroPurchase[]>;
 
+  /**
+   * Deep link to the native subscription management UI (iOS only)
+   * @returns Promise<boolean> - True if the deep link request succeeded
+   * @platform iOS
+   */
+  deepLinkToSubscriptionsIOS(): Promise<boolean>;
+
   /**
    * Check if user is eligible for intro offer (iOS only)
    * @param groupID - The subscription group ID
@@ -458,6 +472,20 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
    */
   getReceiptDataIOS(): Promise<string>;
 
+  /**
+   * Alias for getReceiptDataIOS maintained for compatibility (iOS only)
+   * @returns Promise<string> - Base64 encoded receipt data
+   * @platform iOS
+   */
+  getReceiptIOS(): Promise<string>;
+
+  /**
+   * Request a refreshed receipt from the App Store (iOS only)
+   * @returns Promise<string> - Updated Base64 encoded receipt data
+   * @platform iOS
+   */
+  requestReceiptRefreshIOS(): Promise<string>;
+
   /**
    * Check if transaction is verified (iOS only)
    * @param sku - The product SKU

package/src/types.ts

@@ -128,9 +128,9 @@ export enum ErrorCode {
 
 export type FetchProductsResult = Product[] | ProductSubscription[] | null;
 
-export type IapEvent = 'promoted-product-ios' | 'purchase-error' | 'purchase-updated';
+export type IapEvent = 'purchase-updated' | 'purchase-error' | 'promoted-product-ios';
 
-export type IapPlatform = 'android' | 'ios';
+export type IapPlatform = 'ios' | 'android';
 
 export interface Mutation {
   /** Acknowledge a non-consumable purchase or subscription */
@@ -266,7 +266,7 @@ export interface ProductIOS extends ProductCommon {
   typeIOS: ProductTypeIOS;
 }
 
-export type ProductQueryType = 'all' | 'in-app' | 'subs';
+export type ProductQueryType = 'in-app' | 'subs' | 'all';
 
 export interface ProductRequest {
   skus: string[];
@@ -327,7 +327,7 @@ export interface ProductSubscriptionIOS extends ProductCommon {
 
 export type ProductType = 'in-app' | 'subs';
 
-export type ProductTypeIOS = 'auto-renewable-subscription' | 'consumable' | 'non-consumable' | 'non-renewing-subscription';
+export type ProductTypeIOS = 'consumable' | 'non-consumable' | 'auto-renewable-subscription' | 'non-renewing-subscription';
 
 export type Purchase = PurchaseAndroid | PurchaseIOS;
 
@@ -349,6 +349,7 @@ export interface PurchaseAndroid extends PurchaseCommon {
   quantity: number;
   signatureAndroid?: (string | null);
   transactionDate: number;
+  transactionId?: (string | null);
 }
 
 export interface PurchaseCommon {
@@ -399,6 +400,7 @@ export interface PurchaseIOS extends PurchaseCommon {
   storefrontCountryCodeIOS?: (string | null);
   subscriptionGroupIdIOS?: (string | null);
   transactionDate: number;
+  transactionId: string;
   transactionReasonIOS?: (string | null);
   webOrderLineItemIdIOS?: (string | null);
 }
@@ -428,7 +430,7 @@ export interface PurchaseOptions {
   onlyIncludeActiveItemsIOS?: (boolean | null);
 }
 
-export type PurchaseState = 'deferred' | 'failed' | 'pending' | 'purchased' | 'restored' | 'unknown';
+export type PurchaseState = 'pending' | 'purchased' | 'failed' | 'restored' | 'deferred' | 'unknown';
 
 export interface Query {
   /** Get current StoreKit 2 entitlements (iOS 15+) */
@@ -654,7 +656,7 @@ export interface SubscriptionOfferIOS {
 
 export type SubscriptionOfferTypeIOS = 'introductory' | 'promotional';
 
-export type SubscriptionPeriodIOS = 'day' | 'empty' | 'month' | 'week' | 'year';
+export type SubscriptionPeriodIOS = 'day' | 'week' | 'month' | 'year' | 'empty';
 
 export interface SubscriptionPeriodValueIOS {
   unit: SubscriptionPeriodIOS;