react-native-iap 15.5.0 → 15.5.2

package/src/hooks/useIAP.ts

@@ -505,7 +505,9 @@ export function useIAP(options?: UseIapOptions): UseIap {
           onlyIncludeActiveItemsIOS: options?.onlyIncludeActiveItemsIOS ?? true,
           includeSuspendedAndroid: options?.includeSuspendedAndroid ?? false,
         });
-        setAvailablePurchases(result);
+        if (isMountedRef.current) {
+          setAvailablePurchases(result);
+        }
       } catch (error) {
         RnIapConsole.error('Error fetching available purchases:', error);
         invokeOnError(error);
@@ -518,7 +520,9 @@ export function useIAP(options?: UseIapOptions): UseIap {
     async (subscriptionIds?: string[]): Promise<ActiveSubscription[]> => {
       try {
         const result = await getActiveSubscriptions(subscriptionIds);
-        setActiveSubscriptions(result);
+        if (isMountedRef.current) {
+          setActiveSubscriptions(result);
+        }
         return result;
       } catch (error) {
         RnIapConsole.error('Error getting active subscriptions:', error);

package/src/index.kepler.ts

@@ -32,6 +32,19 @@ export * from './vega';
 export {useIAP, type UseIapOptions} from './hooks/useIAP';
 export {connectWebhookStream, parseWebhookEventData} from './webhook-client';
 export {kitApi, KitApiError} from './kit-api';
+export type {
+  EntitlementsResponse,
+  KitApiOptions,
+  KitClientPayloadResponse,
+  KitProduct,
+  KitProductClientPayload,
+  KitProductOffer,
+  KitProductPlatform,
+  KitProductsOptions,
+  KitProductsResponse,
+  KitSubscription,
+  StatusResponse,
+} from './kit-api';
 
 export type ProductTypeInput = 'inapp' | 'in-app' | 'subs';
 

package/src/index.ts

@@ -165,6 +165,13 @@ export type {
 export {kitApi, KitApiError} from './kit-api';
 export type {
   KitApiOptions,
+  KitClientPayloadResponse,
+  KitProduct,
+  KitProductClientPayload,
+  KitProductOffer,
+  KitProductPlatform,
+  KitProductsOptions,
+  KitProductsResponse,
   KitSubscription,
   EntitlementsResponse,
   StatusResponse,
@@ -2337,7 +2344,13 @@ export const verifyPurchaseWithProvider: MutationField<
       provider: result.provider,
       iapkit: result.iapkit
         ? {
+            ...(result.iapkit.clientPayload == null
+              ? {}
+              : {clientPayload: result.iapkit.clientPayload}),
             isValid: result.iapkit.isValid,
+            ...(result.iapkit.productId == null
+              ? {}
+              : {productId: result.iapkit.productId}),
             state: result.iapkit.state,
             store: result.iapkit.store,
           }

package/src/kit-api.ts

@@ -40,6 +40,71 @@ export type StatusResponse = {
   subscription: KitSubscription | null;
 };
 
+export type KitProductPlatform = "IOS" | "Android";
+
+export type KitProductClientPayload = {
+  format: "toml" | "json" | "text";
+  body: string;
+  version: number;
+  updatedAt: number;
+};
+
+export type KitProductOffer = {
+  id: string;
+  kind:
+    | "FreeTrial"
+    | "IntroPayUpFront"
+    | "IntroPayAsYouGo"
+    | "PromotionalOffer"
+    | "BasePlan";
+  duration?: string;
+  numberOfPeriods?: number;
+  priceAmountMicros?: number;
+  currency?: string;
+};
+
+export type KitProduct = {
+  productId: string;
+  platform: KitProductPlatform;
+  type: "Subscription" | "NonConsumable" | "Consumable";
+  title: string;
+  description?: string;
+  priceAmountMicros?: number;
+  currency?: string;
+  state: "Draft" | "Ready" | "Active" | "Removed";
+  storeRef?: string;
+  subscriptionGroupId?: string;
+  subscriptionGroupName?: string;
+  billingPeriod?: "P1W" | "P1M" | "P2M" | "P3M" | "P6M" | "P1Y";
+  offers?: KitProductOffer[];
+  updatedAt: number;
+  clientPayload?: KitProductClientPayload;
+};
+
+export type KitProductsOptions = {
+  platform?: KitProductPlatform;
+  /** Include public client payload bodies in a bounded platform page. */
+  includeClientPayload?: boolean;
+  /** Page size for payload-inclusive reads (default 25, maximum 50).
+   * Ignored by the legacy non-payload catalog path. */
+  limit?: number;
+  /** Opaque cursor returned as `nextCursor` by the previous payload page.
+   * Ignored by the legacy non-payload catalog path. */
+  cursor?: string;
+};
+
+export type KitProductsResponse = {
+  products: KitProduct[];
+  /** Present on payload-inclusive catalog pages. */
+  hasMore?: boolean;
+  /** Present when a payload-inclusive catalog page has another page. */
+  nextCursor?: string;
+};
+
+export type KitClientPayloadResponse = {
+  clientPayload: KitProductClientPayload;
+};
+
 const DEFAULT_BASE_URL = "https://kit.openiap.dev";
 
 // Merge caller-supplied headers with kit defaults (`accept`,
@@ -210,6 +275,48 @@ export function kitApi(options: KitApiOptions) {
         `/v1/subscriptions/entitlements/${encodeURIComponent(options.apiKey)}?userId=${encodeURIComponent(userId)}`,
       ),
 
+    /** GET /v1/products — read the store-synced catalog. Client payloads
+     * are excluded unless explicitly requested because they may add up to
+     * 16 KiB per product. */
+    products: (productOptions: KitProductsOptions = {}) => {
+      if (
+        productOptions.includeClientPayload === true &&
+        !productOptions.platform
+      ) {
+        throw new Error(
+          "kitApi.products requires platform when includeClientPayload is true",
+        );
+      }
+      const query = new URLSearchParams();
+      if (productOptions.platform) {
+        query.set("platform", productOptions.platform);
+      }
+      if (productOptions.includeClientPayload !== undefined) {
+        query.set(
+          "includeClientPayload",
+          String(productOptions.includeClientPayload),
+        );
+      }
+      if (productOptions.limit !== undefined) {
+        query.set("limit", String(productOptions.limit));
+      }
+      if (productOptions.cursor !== undefined) {
+        query.set("cursor", productOptions.cursor);
+      }
+      const encodedQuery = query.toString();
+      const suffix = encodedQuery ? `?${encodedQuery}` : "";
+      return call<KitProductsResponse>(
+        `/v1/products/${encodeURIComponent(options.apiKey)}${suffix}`,
+      );
+    },
+
+    /** GET one public client payload by its store-specific natural key.
+     * Payloads are app-facing data; never store secrets in them. */
+    clientPayload: (productId: string, platform: KitProductPlatform) =>
+      call<KitClientPayloadResponse>(
+        `/v1/products/${encodeURIComponent(options.apiKey)}/${encodeURIComponent(productId)}/client-payload?platform=${encodeURIComponent(platform)}`,
+      ),
+
     /** POST /v1/subscriptions/bind-user — call after a successful
      * verifyReceipt so kit knows which userId owns the verified
      * `purchaseToken`. Idempotent. */

package/src/specs/RnIap.nitro.ts

@@ -17,6 +17,13 @@ import type {HybridObject} from 'react-native-nitro-modules';
 // ║    - Interface types from types.ts can be imported and used directly     ║
 // ║    - Union types with 2+ values can be imported from types.ts            ║
 // ║    - Single-value unions must be redefined locally with extra values     ║
+// ║                                                                          ║
+// ║ 3. WRITE `null` FIRST IN NULLABLE UNIONS OF BOOLEANS AND ENUM ARRAYS     ║
+// ║    - Use `null | boolean`, not `boolean | null` (same for enum arrays)   ║
+// ║    - Since nitrogen 0.36 variant operands keep source order when their   ║
+// ║      "looseness" ties (boolean/enum-array tie with null), so null-last   ║
+// ║      would rename generated types (Variant_NullType_Bool →               ║
+// ║      Variant_Bool_NullType) and break hand-written Swift/Kotlin          ║
 // ╚══════════════════════════════════════════════════════════════════════════╝
 
 // NOTE: This Nitro spec re-exports types from the generated schema (src/types.ts)
@@ -93,6 +100,8 @@ export type IapkitPurchaseState =
   | 'unknown'
   | 'inauthentic';
 
+export type IapkitClientPayloadFormat = 'toml' | 'json' | 'text';
+
 // Store identifier for purchase origin
 // Defined locally for Nitro codegen (not in GQL schema)
 export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon' | 'amazon';
@@ -278,8 +287,8 @@ export interface NitroPurchaseRequest {
  * iOS-specific options for getting available purchases
  */
 export interface NitroAvailablePurchasesIosOptions extends PurchaseOptions {
-  alsoPublishToEventListener?: boolean | null;
-  onlyIncludeActiveItems?: boolean | null;
+  alsoPublishToEventListener?: null | boolean;
+  onlyIncludeActiveItems?: null | boolean;
 }
 
 type NitroAvailablePurchasesAndroidType = 'inapp' | 'subs';
@@ -292,7 +301,7 @@ export interface NitroAvailablePurchasesAndroidOptions {
    * Users should be directed to the subscription center to resolve payment issues.
    * Default: false (only active subscriptions are returned)
    */
-  includeSuspended?: boolean | null;
+  includeSuspended?: null | boolean;
 }
 
 export interface NitroAvailablePurchasesOptions {
@@ -358,7 +367,7 @@ export interface NitroBillingProgramInformationDialogParamsAndroid {
 }
 
 export interface NitroInAppMessageParamsAndroid {
-  categories?: InAppMessageCategoryAndroid[] | null;
+  categories?: null | InAppMessageCategoryAndroid[];
 }
 
 // ╔══════════════════════════════════════════════════════════════════════════╗
@@ -450,7 +459,7 @@ export interface NitroVerifyPurchaseWithIapkitAmazonProps {
   /** Amazon Appstore receipt id returned by PurchaseResponse.getReceipt().getReceiptId(). */
   receiptId: string;
   /** Use Amazon RVS Cloud Sandbox for App Tester receipts. */
-  sandbox?: boolean | null;
+  sandbox?: null | boolean;
   /** Amazon Appstore user id returned by PurchaseResponse.getUserData().getUserId(). */
   userId?: string | null;
 }
@@ -466,6 +475,11 @@ export interface NitroVerifyPurchaseWithIapkitProps {
    */
   baseUrl?: string | null;
   google?: NitroVerifyPurchaseWithIapkitGoogleProps | null;
+  /**
+   * Available in OpenIAP Spec 2.4.0 / openiap-apple 2.4.1 / openiap-google 2.4.1.
+   * Include the product's public IAPKit client payload when available.
+   */
+  includeClientPayload?: boolean | null;
 }
 
 export interface NitroVerifyPurchaseWithProviderProps {
@@ -474,11 +488,22 @@ export interface NitroVerifyPurchaseWithProviderProps {
 }
 
 export interface NitroVerifyPurchaseWithIapkitResult {
+  /** Available in OpenIAP Spec 2.4.0 / openiap-apple 2.4.1 / openiap-google 2.4.1. */
+  clientPayload?: NitroIapkitProductClientPayload | null;
   isValid: boolean;
+  /** Available in OpenIAP Spec 2.4.0 / openiap-apple 2.4.1 / openiap-google 2.4.1. */
+  productId?: string | null;
   state: IapkitPurchaseState;
   store: IapStore;
 }
 
+export interface NitroIapkitProductClientPayload {
+  body: string;
+  format: IapkitClientPayloadFormat;
+  updatedAt: number;
+  version: number;
+}
+
 export interface NitroVerifyPurchaseWithProviderError {
   code?: string | null;
   message: string;
@@ -501,7 +526,7 @@ export interface NitroBillingProgramAvailabilityResultAndroid {
   /** Whether the billing program is available for the user */
   isAvailable: boolean;
   /** Whether external-link payment is available for Billing Choice. */
-  isExternalLinkAvailable?: boolean | null;
+  isExternalLinkAvailable?: null | boolean;
 }
 
 /**
@@ -610,7 +635,7 @@ export interface NitroPurchase {
   currencySymbolIOS?: string | null;
   environmentIOS?: string | null;
   expirationDateIOS?: number | null;
-  isUpgradedIOS?: boolean | null;
+  isUpgradedIOS?: null | boolean;
   offerIOS?: string | null;
   ownershipTypeIOS?: string | null;
   reasonIOS?: string | null;
@@ -626,14 +651,14 @@ export interface NitroPurchase {
   purchaseTokenAndroid?: string | null;
   dataAndroid?: string | null;
   signatureAndroid?: string | null;
-  autoRenewingAndroid?: boolean | null;
+  autoRenewingAndroid?: null | boolean;
   purchaseStateAndroid?: number | null;
-  isAcknowledgedAndroid?: boolean | null;
+  isAcknowledgedAndroid?: null | boolean;
   packageNameAndroid?: string | null;
   obfuscatedAccountIdAndroid?: string | null;
   obfuscatedProfileIdAndroid?: string | null;
   developerPayloadAndroid?: string | null;
-  isSuspendedAndroid?: boolean | null;
+  isSuspendedAndroid?: null | boolean;
   pendingPurchaseUpdateAndroid?: PendingPurchaseUpdateAndroid | null;
 }
 
@@ -670,7 +695,7 @@ export interface NitroRenewalInfoIOS {
   pendingUpgradeProductId?: string | null;
   renewalDate?: number | null;
   expirationReason?: string | null;
-  isInBillingRetry?: boolean | null;
+  isInBillingRetry?: null | boolean;
   gracePeriodExpirationDate?: number | null;
   priceIncreaseStatus?: string | null;
   renewalBillingPlanType?: SubscriptionBillingPlanTypeIOS | null;
@@ -692,7 +717,7 @@ export interface NitroProduct {
   platform: IapPlatform;
   // iOS specific fields
   typeIOS?: string | null;
-  isFamilyShareableIOS?: boolean | null;
+  isFamilyShareableIOS?: null | boolean;
   jsonRepresentationIOS?: string | null;
   pricingTermsIOS?: string | null;
   subscriptionInfoIOS?: string | null;

package/src/types.ts

@@ -617,6 +617,20 @@ export type IapPlatform = 'ios' | 'android';
 
 export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon' | 'amazon';
 
+/** Serialization format of a public IAPKit product client payload. */
+export type IapkitClientPayloadFormat = 'toml' | 'json' | 'text';
+
+/**
+ * Public app-facing data attached to one store product in IAPKit.
+ * Never place credentials, signing keys, or server-authoritative rules here.
+ */
+export interface IapkitProductClientPayload {
+  body: string;
+  format: IapkitClientPayloadFormat;
+  updatedAt: number;
+  version: number;
+}
+
 /** Unified purchase states from IAPKit verification response. */
 export type IapkitPurchaseState = 'entitled' | 'pending-acknowledgment' | 'pending' | 'canceled' | 'expired' | 'ready-to-consume' | 'consumed' | 'unknown' | 'inauthentic';
 
@@ -1987,11 +2001,34 @@ export interface RequestVerifyPurchaseWithIapkitProps {
   baseUrl?: (string | null);
   /** Google Play Store verification parameters. */
   google?: (RequestVerifyPurchaseWithIapkitGoogleProps | null);
+  /**
+   * Available in OpenIAP Spec 2.4.0 / openiap-apple 2.4.1 / openiap-google 2.4.1.
+   * Include the product's public IAPKit client payload in a valid Apple or
+   * Google verification response. Defaults to false so existing response
+   * shapes and bandwidth remain unchanged.
+   */
+  includeClientPayload?: (boolean | null);
 }
 
 export interface RequestVerifyPurchaseWithIapkitResult {
-  /** Whether the purchase is valid (not falsified). */
+  /**
+   * Available in OpenIAP Spec 2.4.0 / openiap-apple 2.4.1 / openiap-google 2.4.1.
+   * Public product payload when includeClientPayload was requested, the
+   * Apple or Google receipt is valid, and a payload exists for that product.
+   */
+  clientPayload?: (IapkitProductClientPayload | null);
+  /**
+   * True when the purchase is valid and actionable.
+   * Only entitled, pending-acknowledgment, or ready-to-consume return true.
+   * Callers must still match productId and use the platform plus app-owned product
+   * type to choose the fulfillment path.
+   */
   isValid: boolean;
+  /**
+   * Available in OpenIAP Spec 2.4.0 / openiap-apple 2.4.1 / openiap-google 2.4.1.
+   * Store-verified product identifier when the provider returns one.
+   */
+  productId?: (string | null);
   /** The current state of the purchase. */
   state: IapkitPurchaseState;
   store: IapStore;

package/src/vega-adapter.ts

@@ -4,6 +4,7 @@ import type {
   NitroProduct,
   NitroPurchase,
   NitroPurchaseResult,
+  NitroVerifyPurchaseWithIapkitResult,
   NitroVerifyPurchaseWithProviderProps,
   NitroVerifyPurchaseWithProviderResult,
   RnIap,
@@ -155,8 +156,7 @@ function isValidIpv4Address(address: string): boolean {
   return (
     octets.length === 4 &&
     octets.every(
-      (octet) =>
-        /^(?:0|[1-9]\d{0,2})$/.test(octet) && Number(octet) <= 255,
+      (octet) => /^(?:0|[1-9]\d{0,2})$/.test(octet) && Number(octet) <= 255,
     )
   );
 }
@@ -1236,10 +1236,7 @@ export function createVegaIapModule(service: VegaPurchasingService): RnIap {
     function readIapkitResult(
       json: Record<string, unknown>,
       status: number,
-    ): {
-      isValid: boolean;
-      state: IapkitPurchaseState;
-    } {
+    ): NitroVerifyPurchaseWithIapkitResult {
       if (
         typeof json.isValid !== 'boolean' ||
         typeof json.state !== 'string' ||
@@ -1251,9 +1248,19 @@ export function createVegaIapModule(service: VegaPurchasingService): RnIap {
         );
       }
 
+      const productId = json.productId;
+      if (productId != null && typeof productId !== 'string') {
+        throw createVegaError(
+          ErrorCode.ReceiptFailed,
+          `IAPKit returned malformed response (HTTP ${status}).`,
+        );
+      }
+
       return {
         isValid: json.isValid,
+        ...(productId == null ? {} : {productId}),
         state: normalizeIapkitState(json.state),
+        store: 'amazon',
       };
     }
 
@@ -1374,11 +1381,7 @@ export function createVegaIapModule(service: VegaPurchasingService): RnIap {
     const result = readIapkitResult(json, response.status);
     return {
       provider: 'iapkit',
-      iapkit: {
-        isValid: result.isValid,
-        state: result.state,
-        store: 'amazon',
-      },
+      iapkit: result,
     };
   };