react-native-iap 16.1.0 → 16.2.1

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

@@ -0,0 +1,88 @@
+///
+/// SubscriptionPeriodIOS.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::iap {
+
+  /**
+   * An enum which can be represented as a JavaScript union (SubscriptionPeriodIOS).
+   */
+  enum class SubscriptionPeriodIOS {
+    EMPTY      SWIFT_NAME(empty) = 0,
+    DAY      SWIFT_NAME(day) = 1,
+    WEEK      SWIFT_NAME(week) = 2,
+    MONTH      SWIFT_NAME(month) = 3,
+    YEAR      SWIFT_NAME(year) = 4,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ SubscriptionPeriodIOS <> JS SubscriptionPeriodIOS (union)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::SubscriptionPeriodIOS> final {
+    static inline margelo::nitro::iap::SubscriptionPeriodIOS 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("empty"): return margelo::nitro::iap::SubscriptionPeriodIOS::EMPTY;
+        case hashString("day"): return margelo::nitro::iap::SubscriptionPeriodIOS::DAY;
+        case hashString("week"): return margelo::nitro::iap::SubscriptionPeriodIOS::WEEK;
+        case hashString("month"): return margelo::nitro::iap::SubscriptionPeriodIOS::MONTH;
+        case hashString("year"): return margelo::nitro::iap::SubscriptionPeriodIOS::YEAR;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum SubscriptionPeriodIOS - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::iap::SubscriptionPeriodIOS arg) {
+      switch (arg) {
+        case margelo::nitro::iap::SubscriptionPeriodIOS::EMPTY: return JSIConverter<std::string>::toJSI(runtime, "empty");
+        case margelo::nitro::iap::SubscriptionPeriodIOS::DAY: return JSIConverter<std::string>::toJSI(runtime, "day");
+        case margelo::nitro::iap::SubscriptionPeriodIOS::WEEK: return JSIConverter<std::string>::toJSI(runtime, "week");
+        case margelo::nitro::iap::SubscriptionPeriodIOS::MONTH: return JSIConverter<std::string>::toJSI(runtime, "month");
+        case margelo::nitro::iap::SubscriptionPeriodIOS::YEAR: return JSIConverter<std::string>::toJSI(runtime, "year");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert SubscriptionPeriodIOS to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("empty"):
+        case hashString("day"):
+        case hashString("week"):
+        case hashString("month"):
+        case hashString("year"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -0,0 +1,88 @@
+///
+/// SubscriptionPeriodValueIOS.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `SubscriptionPeriodIOS` to properly resolve imports.
+namespace margelo::nitro::iap { enum class SubscriptionPeriodIOS; }
+
+#include "SubscriptionPeriodIOS.hpp"
+
+namespace margelo::nitro::iap {
+
+  /**
+   * A struct which can be represented as a JavaScript object (SubscriptionPeriodValueIOS).
+   */
+  struct SubscriptionPeriodValueIOS final {
+  public:
+    SubscriptionPeriodIOS unit     SWIFT_PRIVATE;
+    double value     SWIFT_PRIVATE;
+
+  public:
+    SubscriptionPeriodValueIOS() = default;
+    explicit SubscriptionPeriodValueIOS(SubscriptionPeriodIOS unit, double value): unit(unit), value(value) {}
+
+  public:
+    friend bool operator==(const SubscriptionPeriodValueIOS& lhs, const SubscriptionPeriodValueIOS& rhs) = default;
+  };
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ SubscriptionPeriodValueIOS <> JS SubscriptionPeriodValueIOS (object)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::SubscriptionPeriodValueIOS> final {
+    static inline margelo::nitro::iap::SubscriptionPeriodValueIOS fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::iap::SubscriptionPeriodValueIOS(
+        JSIConverter<margelo::nitro::iap::SubscriptionPeriodIOS>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "unit"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "value")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::SubscriptionPeriodValueIOS& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "unit"), JSIConverter<margelo::nitro::iap::SubscriptionPeriodIOS>::toJSI(runtime, arg.unit));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "value"), JSIConverter<double>::toJSI(runtime, arg.value));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<margelo::nitro::iap::SubscriptionPeriodIOS>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "unit")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "value")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/openiap-versions.json

@@ -1,5 +1,5 @@
 {
-  "spec": "3.0.1",
-  "google": "3.1.0",
-  "apple": "3.0.1"
+  "spec": "3.1.1",
+  "google": "3.2.1",
+  "apple": "3.1.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "16.1.0",
+  "version": "16.2.1",
   "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",

package/src/index.ts

@@ -2258,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,13 @@ export interface AdvancedCommerceInfoIOS {
   estimatedTax?: (string | null);
   /** The items purchased as part of this transaction */
   items: AdvancedCommerceItemIOS[];
+  /**
+   * Subscription period for this transaction.
+   * Available in OpenIAP Spec 3.1.0 / openiap-apple 3.1.0
+   * (requires iOS 18.4+, macOS 15.4+, tvOS 18.4+, watchOS 11.4+,
+   * or visionOS 2.4+).
+   */
+  period?: (SubscriptionPeriodValueIOS | null);
   /** Request reference identifier for tracking */
   requestReferenceId?: (string | null);
   /** Tax code for the transaction */
@@ -809,11 +816,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 +1438,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 +1880,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;