react-native-iap 16.3.0 → 16.3.2

package/nitrogen/generated/ios/swift/{Variant_NitroPurchaseVerificationResultIOS_NitroPurchaseVerificationResultAndroid.swift → Variant_NitroPurchaseVerificationResultIOS_NitroPurchaseVerificationResultAndroid_NitroPurchaseVerificationResultHorizon.swift}

@@ -1,5 +1,5 @@
 ///
-/// Variant_NitroPurchaseVerificationResultIOS_NitroPurchaseVerificationResultAndroid.swift
+/// Variant_NitroPurchaseVerificationResultIOS_NitroPurchaseVerificationResultAndroid_NitroPurchaseVerificationResultHorizon.swift
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
 /// Copyright © Marc Rousavy @ Margelo
@@ -9,19 +9,21 @@
 
 /**
  * An Swift enum with associated values representing a Variant/Union type.
- * JS type: `struct | struct`
+ * JS type: `struct | struct | struct`
  */
 @frozen
-public indirect enum Variant_NitroPurchaseVerificationResultIOS_NitroPurchaseVerificationResultAndroid {
+public indirect enum Variant_NitroPurchaseVerificationResultIOS_NitroPurchaseVerificationResultAndroid_NitroPurchaseVerificationResultHorizon {
   case first(NitroPurchaseVerificationResultIOS)
   case second(NitroPurchaseVerificationResultAndroid)
+  case third(NitroPurchaseVerificationResultHorizon)
 }
 
-public extension Variant_NitroPurchaseVerificationResultIOS_NitroPurchaseVerificationResultAndroid {
+public extension Variant_NitroPurchaseVerificationResultIOS_NitroPurchaseVerificationResultAndroid_NitroPurchaseVerificationResultHorizon {
   func asType<T>(_ type: T.Type = T.self) -> T? {
     switch self {
       case .first(let value): return value as? T
       case .second(let value): return value as? T
+      case .third(let value): return value as? T
     }
   }
   func isType<T>(_ type: T.Type = T.self) -> Bool {

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

@@ -41,6 +41,8 @@ namespace margelo::nitro::iap { struct NitroSubscriptionStatus; }
 namespace margelo::nitro::iap { struct NitroPurchaseVerificationResultIOS; }
 // Forward declaration of `NitroPurchaseVerificationResultAndroid` to properly resolve imports.
 namespace margelo::nitro::iap { struct NitroPurchaseVerificationResultAndroid; }
+// Forward declaration of `NitroPurchaseVerificationResultHorizon` to properly resolve imports.
+namespace margelo::nitro::iap { struct NitroPurchaseVerificationResultHorizon; }
 // Forward declaration of `NitroPurchaseVerificationParams` to properly resolve imports.
 namespace margelo::nitro::iap { struct NitroPurchaseVerificationParams; }
 // Forward declaration of `NitroVerifyPurchaseWithProviderResult` to properly resolve imports.
@@ -109,6 +111,7 @@ namespace margelo::nitro::iap { enum class ExternalPurchaseCustomLinkNoticeTypeI
 #include "NitroSubscriptionStatus.hpp"
 #include "NitroPurchaseVerificationResultIOS.hpp"
 #include "NitroPurchaseVerificationResultAndroid.hpp"
+#include "NitroPurchaseVerificationResultHorizon.hpp"
 #include "NitroPurchaseVerificationParams.hpp"
 #include "NitroVerifyPurchaseWithProviderResult.hpp"
 #include "NitroVerifyPurchaseWithProviderProps.hpp"
@@ -196,7 +199,7 @@ namespace margelo::nitro::iap {
       virtual std::shared_ptr<Promise<std::string>> requestReceiptRefreshIOS() = 0;
       virtual std::shared_ptr<Promise<bool>> isTransactionVerifiedIOS(const std::string& sku) = 0;
       virtual std::shared_ptr<Promise<std::variant<nitro::NullType, std::string>>> getTransactionJwsIOS(const std::string& sku) = 0;
-      virtual std::shared_ptr<Promise<std::variant<NitroPurchaseVerificationResultIOS, NitroPurchaseVerificationResultAndroid>>> verifyPurchase(const NitroPurchaseVerificationParams& params) = 0;
+      virtual std::shared_ptr<Promise<std::variant<NitroPurchaseVerificationResultIOS, NitroPurchaseVerificationResultAndroid, NitroPurchaseVerificationResultHorizon>>> verifyPurchase(const NitroPurchaseVerificationParams& params) = 0;
       virtual std::shared_ptr<Promise<NitroVerifyPurchaseWithProviderResult>> verifyPurchaseWithProvider(const NitroVerifyPurchaseWithProviderProps& params) = 0;
       virtual std::shared_ptr<Promise<std::string>> getStorefront() = 0;
       virtual std::shared_ptr<Promise<void>> deepLinkToSubscriptionsAndroid(const NitroDeepLinkOptionsAndroid& options) = 0;

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

@@ -42,6 +42,7 @@ namespace margelo::nitro::iap {
    */
   struct NitroPurchaseVerificationResultAndroid final {
   public:
+    bool isValid     SWIFT_PRIVATE;
     bool autoRenewing     SWIFT_PRIVATE;
     bool betaProduct     SWIFT_PRIVATE;
     std::optional<std::variant<nitro::NullType, double>> cancelDate     SWIFT_PRIVATE;
@@ -63,7 +64,7 @@ namespace margelo::nitro::iap {
 
   public:
     NitroPurchaseVerificationResultAndroid() = default;
-    explicit NitroPurchaseVerificationResultAndroid(bool autoRenewing, bool betaProduct, std::optional<std::variant<nitro::NullType, double>> cancelDate, std::optional<std::variant<nitro::NullType, std::string>> cancelReason, std::optional<std::variant<nitro::NullType, double>> deferredDate, std::optional<std::variant<nitro::NullType, std::string>> deferredSku, double freeTrialEndDate, double gracePeriodEndDate, std::string parentProductId, std::string productId, std::string productType, double purchaseDate, double quantity, std::string receiptId, double renewalDate, std::string term, std::string termSku, bool testTransaction): autoRenewing(autoRenewing), betaProduct(betaProduct), cancelDate(cancelDate), cancelReason(cancelReason), deferredDate(deferredDate), deferredSku(deferredSku), freeTrialEndDate(freeTrialEndDate), gracePeriodEndDate(gracePeriodEndDate), parentProductId(parentProductId), productId(productId), productType(productType), purchaseDate(purchaseDate), quantity(quantity), receiptId(receiptId), renewalDate(renewalDate), term(term), termSku(termSku), testTransaction(testTransaction) {}
+    explicit NitroPurchaseVerificationResultAndroid(bool isValid, bool autoRenewing, bool betaProduct, std::optional<std::variant<nitro::NullType, double>> cancelDate, std::optional<std::variant<nitro::NullType, std::string>> cancelReason, std::optional<std::variant<nitro::NullType, double>> deferredDate, std::optional<std::variant<nitro::NullType, std::string>> deferredSku, double freeTrialEndDate, double gracePeriodEndDate, std::string parentProductId, std::string productId, std::string productType, double purchaseDate, double quantity, std::string receiptId, double renewalDate, std::string term, std::string termSku, bool testTransaction): isValid(isValid), autoRenewing(autoRenewing), betaProduct(betaProduct), cancelDate(cancelDate), cancelReason(cancelReason), deferredDate(deferredDate), deferredSku(deferredSku), freeTrialEndDate(freeTrialEndDate), gracePeriodEndDate(gracePeriodEndDate), parentProductId(parentProductId), productId(productId), productType(productType), purchaseDate(purchaseDate), quantity(quantity), receiptId(receiptId), renewalDate(renewalDate), term(term), termSku(termSku), testTransaction(testTransaction) {}
 
   public:
     friend bool operator==(const NitroPurchaseVerificationResultAndroid& lhs, const NitroPurchaseVerificationResultAndroid& rhs) = default;
@@ -79,6 +80,7 @@ namespace margelo::nitro {
     static inline margelo::nitro::iap::NitroPurchaseVerificationResultAndroid fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
       jsi::Object obj = arg.asObject(runtime);
       return margelo::nitro::iap::NitroPurchaseVerificationResultAndroid(
+        JSIConverter<bool>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "isValid"))),
         JSIConverter<bool>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "autoRenewing"))),
         JSIConverter<bool>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "betaProduct"))),
         JSIConverter<std::optional<std::variant<nitro::NullType, double>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "cancelDate"))),
@@ -101,6 +103,7 @@ namespace margelo::nitro {
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::NitroPurchaseVerificationResultAndroid& arg) {
       jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "isValid"), JSIConverter<bool>::toJSI(runtime, arg.isValid));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "autoRenewing"), JSIConverter<bool>::toJSI(runtime, arg.autoRenewing));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "betaProduct"), JSIConverter<bool>::toJSI(runtime, arg.betaProduct));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "cancelDate"), JSIConverter<std::optional<std::variant<nitro::NullType, double>>>::toJSI(runtime, arg.cancelDate));
@@ -129,6 +132,7 @@ namespace margelo::nitro {
       if (!nitro::isPlainObject(runtime, obj)) {
         return false;
       }
+      if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "isValid")))) return false;
       if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "autoRenewing")))) return false;
       if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "betaProduct")))) return false;
       if (!JSIConverter<std::optional<std::variant<nitro::NullType, double>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "cancelDate")))) return false;

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

@@ -0,0 +1,93 @@
+///
+/// NitroPurchaseVerificationResultHorizon.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
+
+
+
+#include <NitroModules/Null.hpp>
+#include <variant>
+#include <optional>
+
+namespace margelo::nitro::iap {
+
+  /**
+   * A struct which can be represented as a JavaScript object (NitroPurchaseVerificationResultHorizon).
+   */
+  struct NitroPurchaseVerificationResultHorizon final {
+  public:
+    bool isValid     SWIFT_PRIVATE;
+    std::optional<std::variant<nitro::NullType, double>> grantTime     SWIFT_PRIVATE;
+    bool success     SWIFT_PRIVATE;
+
+  public:
+    NitroPurchaseVerificationResultHorizon() = default;
+    explicit NitroPurchaseVerificationResultHorizon(bool isValid, std::optional<std::variant<nitro::NullType, double>> grantTime, bool success): isValid(isValid), grantTime(grantTime), success(success) {}
+
+  public:
+    friend bool operator==(const NitroPurchaseVerificationResultHorizon& lhs, const NitroPurchaseVerificationResultHorizon& rhs) = default;
+  };
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ NitroPurchaseVerificationResultHorizon <> JS NitroPurchaseVerificationResultHorizon (object)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::NitroPurchaseVerificationResultHorizon> final {
+    static inline margelo::nitro::iap::NitroPurchaseVerificationResultHorizon fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::iap::NitroPurchaseVerificationResultHorizon(
+        JSIConverter<bool>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "isValid"))),
+        JSIConverter<std::optional<std::variant<nitro::NullType, double>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "grantTime"))),
+        JSIConverter<bool>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "success")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::NitroPurchaseVerificationResultHorizon& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "isValid"), JSIConverter<bool>::toJSI(runtime, arg.isValid));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "grantTime"), JSIConverter<std::optional<std::variant<nitro::NullType, double>>>::toJSI(runtime, arg.grantTime));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "success"), JSIConverter<bool>::toJSI(runtime, arg.success));
+      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<bool>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "isValid")))) return false;
+      if (!JSIConverter<std::optional<std::variant<nitro::NullType, double>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "grantTime")))) return false;
+      if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "success")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/openiap-versions.json

@@ -1,5 +1,5 @@
 {
-  "spec": "3.2.0",
-  "google": "3.3.0",
-  "apple": "3.2.0"
+  "spec": "3.2.1",
+  "google": "3.3.2",
+  "apple": "3.2.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "16.3.0",
+  "version": "16.3.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",
@@ -173,6 +173,7 @@
   },
   "packageManager": "yarn@3.6.1",
   "resolutions": {
-    "nitrogen@^0.36.5": "patch:nitrogen@npm%3A0.36.5#./.yarn/patches/nitrogen-npm-0.36.5-array-equatable.patch"
+    "nitrogen@^0.36.5": "patch:nitrogen@npm%3A0.36.5#./.yarn/patches/nitrogen-npm-0.36.5-array-equatable.patch",
+    "uuid@^7.0.3": "11.1.1"
   }
 }

package/src/index.kepler.ts

@@ -1,4 +1,5 @@
 import {getVegaIapModule} from './vega';
+import {ErrorCode} from './types';
 import type {
   MutationField,
   Product,
@@ -27,6 +28,7 @@ import {
   validateNitroPurchase,
 } from './utils/type-bridge';
 import {convertAndroidPurchasesOrThrow} from './utils/available-purchases';
+import {createPurchaseError} from './utils/errorMapping';
 
 export * from './types';
 export * from './utils/error';
@@ -129,13 +131,19 @@ export const fetchProducts = async (
   const normalizedType = normalizeProductQueryType(type);
   const nitroProducts = await getModule().fetchProducts(skus, normalizedType);
   return mapProducts(nitroProducts, normalizedType) as
-    | Product[]
-    | ProductSubscription[];
+    Product[] | ProductSubscription[];
 };
 
 export const requestPurchase: MutationField<'requestPurchase'> = async (
   request,
 ) => {
+  const type = normalizeProductQueryType(request.type);
+  if (type === 'all') {
+    throw createPurchaseError({
+      code: ErrorCode.DeveloperError,
+      message: 'Product type all is only supported for product queries.',
+    });
+  }
   const perPlatformRequest = request.request as
     | RequestPurchasePropsByPlatforms
     | RequestSubscriptionPropsByPlatforms

package/src/index.ts

@@ -9,6 +9,7 @@ import type {
   NitroPurchaseVerificationParams,
   NitroPurchaseVerificationResultIOS,
   NitroPurchaseVerificationResultAndroid,
+  NitroPurchaseVerificationResultHorizon,
   NitroPurchaseUpdatedListenerOptions,
   NitroSubscriptionStatus,
   RnIap,
@@ -41,6 +42,7 @@ import type {
   PurchaseIOS,
   QueryField,
   VerifyPurchaseResultAndroid,
+  VerifyPurchaseResultHorizon,
   VerifyPurchaseResultIOS,
   RequestPurchaseAndroidProps,
   RequestPurchaseIosProps,
@@ -884,7 +886,10 @@ export const fetchProducts: QueryField<'fetchProducts'> = async (request) => {
 
   try {
     if (!skus?.length) {
-      throw new Error('No SKUs provided');
+      throw createPurchaseError({
+        message: 'No SKUs provided',
+        code: ErrorCode.EmptySkuList,
+      });
     }
 
     const normalizedType = normalizeProductQueryType(type);
@@ -1673,6 +1678,12 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
   try {
     const {request: platformRequest, type} = request;
     const normalizedType = normalizeProductQueryType(type ?? 'in-app');
+    if (normalizedType === 'all') {
+      throw createPurchaseError({
+        code: ErrorCode.DeveloperError,
+        message: 'Product type all is only supported for product queries.',
+      });
+    }
     const isSubs = isSubscriptionQuery(normalizedType);
     const perPlatformRequest = platformRequest as
       | RequestPurchasePropsByPlatforms
@@ -1691,15 +1702,23 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
 
     if (Platform.OS === 'ios') {
       if (!iosRequestSource?.sku) {
-        throw new Error(
-          'Invalid request for iOS. The `sku` property is required.',
-        );
+        throw createPurchaseError({
+          message: 'Invalid request for iOS. The `sku` property is required.',
+          code: ErrorCode.EmptySkuList,
+        });
       }
     } else if (isAndroidStoreRuntime()) {
-      if (!androidRequestSource?.skus?.length) {
-        throw new Error(
-          'Invalid request for Android. The `skus` property is required and must be a non-empty array.',
-        );
+      const skus = androidRequestSource?.skus as unknown;
+      if (
+        !Array.isArray(skus) ||
+        skus.length === 0 ||
+        skus.some((sku) => typeof sku !== 'string' || sku.trim() === '')
+      ) {
+        throw createPurchaseError({
+          message:
+            'Invalid request for Android. The `skus` property must contain only non-empty strings.',
+          code: ErrorCode.EmptySkuList,
+        });
       }
     } else {
       throw unsupportedPlatformError();
@@ -1756,6 +1775,29 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
     }
 
     if (isAndroidStoreRuntime() && androidRequestSource) {
+      const rawAndroidRequest = androidRequestSource as unknown as Record<
+        string,
+        unknown
+      >;
+      const subscriptionOnlyFields = [
+        'subscriptionOffers',
+        'subscriptionProductReplacementParams',
+        'purchaseToken',
+        'originalExternalTransactionId',
+      ];
+      if (
+        (!isSubs &&
+          subscriptionOnlyFields.some(
+            (field) => rawAndroidRequest[field] != null,
+          )) ||
+        (isSubs && rawAndroidRequest.offerToken != null)
+      ) {
+        throw createPurchaseError({
+          message:
+            'Invalid request for Android. Purchase options must match the selected product type.',
+          code: ErrorCode.DeveloperError,
+        });
+      }
       const androidRequest = isSubs
         ? (androidRequestSource as RequestSubscriptionAndroidProps)
         : (androidRequestSource as RequestPurchaseAndroidProps);
@@ -1788,6 +1830,29 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
 
       if (isSubs) {
         const subsRequest = androidRequest as RequestSubscriptionAndroidProps;
+        const subscriptionOffers = subsRequest.subscriptionOffers as unknown;
+        if (
+          subscriptionOffers != null &&
+          (!Array.isArray(subscriptionOffers) ||
+            subscriptionOffers.some((offer) => {
+              if (offer == null || typeof offer !== 'object') {
+                return true;
+              }
+              const candidate = offer as Record<string, unknown>;
+              return (
+                typeof candidate.sku !== 'string' ||
+                candidate.sku.trim() === '' ||
+                typeof candidate.offerToken !== 'string' ||
+                candidate.offerToken.trim() === ''
+              );
+            }))
+        ) {
+          throw createPurchaseError({
+            message:
+              'Invalid request for Android. Every subscription offer must include non-empty `sku` and `offerToken` strings.',
+            code: ErrorCode.DeveloperError,
+          });
+        }
         if (subsRequest.purchaseToken) {
           androidPayload.purchaseToken = subsRequest.purchaseToken;
         }
@@ -1800,15 +1865,11 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
             subsRequest.subscriptionProductReplacementParams;
         }
         androidPayload.subscriptionOffers = (
-          subsRequest.subscriptionOffers ?? []
-        )
-          .filter(
-            (offer): offer is AndroidSubscriptionOfferInput => offer != null,
-          )
-          .map((offer) => ({
-            sku: offer.sku,
-            offerToken: offer.offerToken,
-          }));
+          (subscriptionOffers ?? []) as AndroidSubscriptionOfferInput[]
+        ).map((offer) => ({
+          sku: offer.sku,
+          offerToken: offer.offerToken,
+        }));
       }
 
       unifiedRequest.google = androidPayload;
@@ -2135,11 +2196,20 @@ export const verifyPurchase: MutationField<'verifyPurchase'> = async (
           : undefined,
       };
       return result;
+    } else if (params.horizon !== null) {
+      const horizonResult =
+        nitroResult as NitroPurchaseVerificationResultHorizon;
+      const result: VerifyPurchaseResultHorizon = {
+        isValid: horizonResult.isValid,
+        grantTime: horizonResult.grantTime,
+        success: horizonResult.success,
+      };
+      return result;
     } else {
-      // Android
       const androidResult =
         nitroResult as NitroPurchaseVerificationResultAndroid;
       const result: VerifyPurchaseResultAndroid = {
+        isValid: androidResult.isValid,
         autoRenewing: androidResult.autoRenewing,
         betaProduct: androidResult.betaProduct,
         cancelDate: androidResult.cancelDate,

package/src/kit-api.ts

@@ -31,7 +31,15 @@ export type KitSubscription = {
   id: string;
   productId: string;
   platform: "IOS" | "Android";
-  state: string;
+  state:
+    | "Active"
+    | "InGracePeriod"
+    | "InBillingRetry"
+    | "Expired"
+    | "Revoked"
+    | "Refunded"
+    | "Paused"
+    | "Unknown";
   expiresAt?: number;
   renewsAt?: number;
   willRenew?: boolean;
@@ -41,6 +49,7 @@ export type KitSubscription = {
   startedAt: number;
   updatedAt: number;
   purchaseToken: string;
+  originalTransactionId?: string;
   userId?: string;
 };
 
@@ -58,7 +67,8 @@ export type StatusResponse = {
 export type KitProductPlatform = "IOS" | "Android";
 
 export type KitProductClientPayload = {
-  format: "toml" | "json" | "text";
+  /** Current values are toml, json, and text; preserve unknown values. */
+  format: string;
   body: string;
   version: number;
   updatedAt: number;
@@ -84,6 +94,13 @@ export type KitProduct = {
   type: "Subscription" | "NonConsumable" | "Consumable";
   title: string;
   description?: string;
+  baseLocale?: string;
+  localizations?: Array<{
+    locale: string;
+    title: string;
+    description?: string;
+  }>;
+  regions?: "all" | string[];
   priceAmountMicros?: number;
   currency?: string;
   state: "Draft" | "Ready" | "Active" | "Removed";
@@ -113,6 +130,108 @@ export type KitProductsResponse = {
   nextCursor?: string;
 };
 
+export type KitSubscriptionsResponse = {
+  items: KitSubscription[];
+  total: number;
+};
+
+export type KitMrrCurrencyEntry = {
+  currency: string;
+  mrrMicros: number;
+};
+
+export type KitMetricsResponse = {
+  activeSubs: number;
+  inGracePeriod: number;
+  inBillingRetry: number;
+  refunded30d: number;
+  canceled30d: number;
+  mrrMicros: number;
+  currency: string;
+  reportingCurrency: string;
+  mrrByCurrency: KitMrrCurrencyEntry[];
+  excludedMrrByCurrency: KitMrrCurrencyEntry[];
+};
+
+export type KitRevenueMetricsResponse = {
+  days: Array<{
+    day: string;
+    currency: string;
+    productId: string;
+    platform: KitProductPlatform;
+    activeSubs: number;
+    newSubs: number;
+    renewals: number;
+    cancellations: number;
+    refunds: number;
+    revenueMicros: number;
+  }>;
+  currencies: string[];
+  productIds: string[];
+  platforms: KitProductPlatform[];
+  truncated: boolean;
+};
+
+export type KitProductUpsertResponse = { id: string; created: boolean };
+export type KitProductStateResponse = {
+  id: string;
+  state: KitProduct["state"];
+};
+export type KitClientPayloadStateResponse = {
+  expectedVersion: number;
+  clientPayload?: KitProductClientPayload;
+};
+export type KitSetClientPayloadResponse = {
+  id: string;
+  created: boolean;
+  changed: boolean;
+  version: number;
+  updatedAt: number;
+};
+export type KitRemoveClientPayloadResponse = { ok: boolean };
+export type KitProductSyncResponse = { jobId: string; deduped: boolean };
+export type KitProductSyncJobResponse = {
+  _id: string;
+  _creationTime: number;
+  projectId: string;
+  platform: KitProductPlatform;
+  direction: "pull" | "push" | "both" | "purge-local";
+  dryRun: boolean;
+  status: "queued" | "running" | "succeeded" | "failed";
+  progress: {
+    phase: string;
+    current?: number;
+    total?: number;
+    failuresCount?: number;
+  };
+  result?: {
+    pulled: number;
+    pushed: number;
+    deleted?: number;
+    failures: Array<{ productId: string; reason: string }>;
+    failuresTruncated?: boolean;
+    plannedWrites?: Array<{
+      productId: string;
+      step: string;
+      detail?: string;
+    }>;
+    plannedWritesTruncated?: boolean;
+    manualActions?: Array<{
+      productId: string;
+      code: string;
+      message: string;
+    }>;
+    manualActionsTruncated?: boolean;
+  };
+  error?: string;
+  cancelRequested?: boolean;
+  expectedDeadline?: number;
+  createdBy?: string;
+  startedAt?: number;
+  completedAt?: number;
+  createdAt: number;
+};
+
 export type KitClientPayloadResponse = {
   clientPayload: KitProductClientPayload;
 };
@@ -135,7 +254,7 @@ const DEFAULT_BASE_URL = "https://kit.openiap.dev";
 function mergeHeaders(
   callerHeaders: Record<string, string> | undefined,
   hasBody: boolean,
-): HeadersInit {
+): RequestInit["headers"] {
   if (typeof Headers === "function") {
     const merged = new Headers(callerHeaders);
     if (!merged.has("accept")) merged.set("accept", "application/json");
@@ -283,9 +402,11 @@ export function kitApi(options: KitApiOptions) {
       if (!raw) return null;
       const candidate = JSON.parse(raw) as Partial<CachedClientPayload>;
       const payload = candidate.clientPayload;
+      // Only the invariants the cache depends on. `format` is opaque: evicting
+      // on an unknown one would kill ETag revalidation and offline reads.
       if (
         !payload ||
-        !["toml", "json", "text"].includes(payload.format) ||
+        typeof payload.format !== "string" ||
         typeof payload.body !== "string" ||
         !Number.isSafeInteger(payload.version) ||
         payload.version < 1 ||

package/src/specs/RnIap.nitro.ts

@@ -55,6 +55,7 @@ import type {
   VerifyPurchaseGoogleOptions,
   VerifyPurchaseHorizonOptions,
   VerifyPurchaseResultAndroid,
+  VerifyPurchaseResultHorizon,
   RequestPurchaseIosProps,
   RequestPurchaseResult,
   RequestSubscriptionAndroidProps,
@@ -408,6 +409,7 @@ export interface NitroPurchaseVerificationResultIOS {
 }
 
 export interface NitroPurchaseVerificationResultAndroid {
+  isValid: VerifyPurchaseResultAndroid['isValid'];
   autoRenewing: VerifyPurchaseResultAndroid['autoRenewing'];
   betaProduct: VerifyPurchaseResultAndroid['betaProduct'];
   cancelDate: VerifyPurchaseResultAndroid['cancelDate'];
@@ -428,6 +430,12 @@ export interface NitroPurchaseVerificationResultAndroid {
   testTransaction: VerifyPurchaseResultAndroid['testTransaction'];
 }
 
+export interface NitroPurchaseVerificationResultHorizon {
+  isValid: VerifyPurchaseResultHorizon['isValid'];
+  grantTime?: VerifyPurchaseResultHorizon['grantTime'];
+  success: VerifyPurchaseResultHorizon['success'];
+}
+
 // VerifyPurchaseWithProvider types
 
 export interface NitroVerifyPurchaseWithIapkitAppleProps {
@@ -994,12 +1002,14 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
   /**
    * Verify a purchase on the appropriate platform.
    * @param params - Purchase verification parameters including platform-specific options
-   * @returns Promise<NitroPurchaseVerificationResultIOS | NitroPurchaseVerificationResultAndroid>
+   * @returns Promise with the platform-specific verification result
    */
   verifyPurchase(
     params: NitroPurchaseVerificationParams,
   ): Promise<
-    NitroPurchaseVerificationResultIOS | NitroPurchaseVerificationResultAndroid
+    | NitroPurchaseVerificationResultIOS
+    | NitroPurchaseVerificationResultAndroid
+    | NitroPurchaseVerificationResultHorizon
   >;
 
   /**