react-native-iap 14.0.1 → 14.1.1-rc.1

package/src/specs/RnIap.nitro.ts

@@ -198,6 +198,9 @@ export interface NitroPurchase {
   transactionDate: number
   purchaseToken?: string
   platform: string
+  quantity: number
+  purchaseState: string
+  isAutoRenewing: boolean
 
   // iOS specific fields
   quantityIOS?: number
@@ -233,8 +236,9 @@ export interface NitroProduct {
   platform: string
 
   // iOS specific fields
-  isFamilyShareable?: boolean
-  jsonRepresentation?: string
+  typeIOS?: string
+  isFamilyShareableIOS?: boolean
+  jsonRepresentationIOS?: string
   subscriptionPeriodUnitIOS?: string
   subscriptionPeriodNumberIOS?: number
   introductoryPriceIOS?: string
@@ -244,13 +248,13 @@ export interface NitroProduct {
   introductoryPriceSubscriptionPeriodIOS?: string
 
   // Android specific fields
-  originalPrice?: string
-  originalPriceAmountMicros?: number
-  introductoryPriceValue?: number
-  introductoryPriceCycles?: number
-  introductoryPricePeriod?: string
-  subscriptionPeriod?: string
-  freeTrialPeriod?: string
+  originalPriceAndroid?: string
+  originalPriceAmountMicrosAndroid?: number
+  introductoryPriceValueAndroid?: number
+  introductoryPriceCyclesAndroid?: number
+  introductoryPricePeriodAndroid?: string
+  subscriptionPeriodAndroid?: string
+  freeTrialPeriodAndroid?: string
   subscriptionOfferDetailsAndroid?: string // Android subscription offer details as JSON string
 }
 
@@ -452,10 +456,10 @@ export interface RnIap
 
   /**
    * Show manage subscriptions screen (iOS only)
-   * @returns Promise<boolean> - Success flag
+   * @returns Promise<NitroPurchase[]> - Array of updated subscriptions with renewal info
    * @platform iOS
    */
-  showManageSubscriptionsIOS(): Promise<boolean>
+  showManageSubscriptionsIOS(): Promise<NitroPurchase[]>
 
   /**
    * Check if user is eligible for intro offer (iOS only)

package/src/types.ts

@@ -16,7 +16,13 @@ export type ChangeEventPayload = {
   value: string
 }
 
-export type ProductType = 'inapp' | 'subs'
+// iOS detailed product types (4 types)
+export enum ProductTypeIOS {
+  consumable = 'consumable',
+  nonConsumable = 'nonConsumable',
+  autoRenewableSubscription = 'autoRenewableSubscription',
+  nonRenewingSubscription = 'nonRenewingSubscription',
+}
 
 // ============================================================================
 // COMMON TYPES (Base types shared across all platforms)
@@ -32,8 +38,8 @@ export type ProductCommon = {
   title: string
   /** Product description */
   description: string
-  /** Product type: 'inapp' for one-time purchases (consumable/non-consumable), 'subs' for subscriptions */
-  type: ProductType
+  /** Product type: 'inapp' or 'subs' for Android compatibility */
+  type: 'inapp' | 'subs' // Note: this is the actual product type, not for filtering
   /** Display name for the product */
   displayName?: string
   /** Formatted price string for display (e.g., "$9.99") */
@@ -69,6 +75,21 @@ export type PurchaseCommon = {
   purchaseToken?: string
   /** Platform identifier ('ios' or 'android') */
   platform?: string
+  /** Purchase quantity (defaults to 1) */
+  quantity: number
+  /** Purchase state (common field) */
+  purchaseState: PurchaseState
+  /** Auto-renewable subscription flag (common field) */
+  isAutoRenewing: boolean
+}
+
+export enum PurchaseState {
+  pending = 'pending',
+  purchased = 'purchased',
+  failed = 'failed',
+  restored = 'restored', // iOS only
+  deferred = 'deferred', // iOS only
+  unknown = 'unknown',
 }
 
 export type ProductSubscriptionCommon = ProductCommon & {
@@ -128,6 +149,7 @@ export type ProductIOS = ProductCommon & {
   jsonRepresentationIOS: string
   platform: 'ios'
   subscriptionInfoIOS?: SubscriptionInfo
+  typeIOS: ProductTypeIOS // Detailed iOS product type
   // deprecated fields
   displayName?: string
   isFamilyShareable?: boolean
@@ -245,12 +267,6 @@ export type ProductSubscriptionAndroid = ProductAndroid & {
   subscriptionOfferDetails?: ProductSubscriptionAndroidOfferDetails[]
 }
 
-export enum PurchaseAndroidState {
-  UNSPECIFIED_STATE = 0,
-  PURCHASED = 1,
-  PENDING = 2,
-}
-
 export type PurchaseAndroid = PurchaseCommon & {
   platform: 'android'
   /**
@@ -259,8 +275,8 @@ export type PurchaseAndroid = PurchaseCommon & {
   purchaseTokenAndroid?: string
   dataAndroid?: string
   signatureAndroid?: string
+  /** @deprecated Use the common `isAutoRenewing` field instead */
   autoRenewingAndroid?: boolean
-  purchaseStateAndroid?: PurchaseAndroidState
   isAcknowledgedAndroid?: boolean
   packageNameAndroid?: string
   developerPayloadAndroid?: string
@@ -322,13 +338,21 @@ export type Purchase =
 // REQUEST TYPES
 // ============================================================================
 
+// Product request parameters for fetching products from the store
+export interface ProductRequest {
+  /** Product SKUs to fetch */
+  skus: string[]
+  /** Filter type: "inapp" (default), "subs", or "all" */
+  type?: 'inapp' | 'subs' | 'all'
+}
+
 // iOS-specific purchase request parameters
 export interface RequestPurchaseIosProps {
   readonly sku: string
   readonly andDangerouslyFinishTransactionAutomatically?: boolean
   readonly appAccountToken?: string
   readonly quantity?: number
-  readonly withOffer?: PaymentDiscount
+  readonly withOffer?: DiscountOffer
 }
 
 // Android-specific purchase request parameters
@@ -418,7 +442,7 @@ export type PurchaseResult = {
 }
 
 // Additional iOS types
-export type PaymentDiscount = {
+export type DiscountOffer = {
   identifier: string
   keyIdentifier: string
   nonce: string
@@ -447,22 +471,12 @@ export type AppTransactionIOS = {
 // ============================================================================
 
 /**
- * Options for getAvailablePurchases methods
+ * Options for getAvailablePurchases and getPurchaseHistories methods
  */
 export interface PurchaseOptions {
-  /**
-   * @deprecated Use alsoPublishToEventListenerIOS instead
-   * Whether to also publish purchases to event listener (iOS only)
-   */
-  alsoPublishToEventListener?: boolean
-  /**
-   * @deprecated Use onlyIncludeActiveItemsIOS instead
-   * Whether to only include active items (iOS only)
-   */
-  onlyIncludeActiveItems?: boolean
-  /** Whether to also publish purchases to event listener (iOS only) */
+  /** Whether to also publish purchases to event listener */
   alsoPublishToEventListenerIOS?: boolean
-  /** Whether to only include active items (subscriptions that are still active) (iOS only) */
+  /** Whether to only include active items (subscriptions that are still active) */
   onlyIncludeActiveItemsIOS?: boolean
 }
 
@@ -513,7 +527,7 @@ export interface IapContext {
   /** Initialize connection to the store */
   initConnection(): Promise<boolean>
   /** End connection to the store */
-  endConnection(): Promise<void>
+  endConnection(): Promise<boolean>
   /** Sync purchases (iOS only) */
   sync(): Promise<void>
 
@@ -521,11 +535,11 @@ export interface IapContext {
   /**
    * Fetch products from the store
    * @param params.skus - Array of product SKUs to fetch
-   * @param params.type - Type of products: 'inapp' for regular products or 'subs' for subscriptions
+   * @param params.type - Type of products: 'inapp' for regular products, 'subs' for subscriptions, 'all' to fetch both. Defaults to 'inapp'
    */
   fetchProducts(params: {
     skus: string[]
-    type?: ProductType // 'inapp' | 'subs', defaults to 'inapp'
+    type?: 'inapp' | 'subs' | 'all' // Defaults to 'inapp'
   }): Promise<Product[] | SubscriptionProduct[]>
 
   // Purchase methods
@@ -561,7 +575,13 @@ export interface IapContext {
   // Receipt validation
   /** Validate a receipt (server-side validation recommended) */
   validateReceipt(
-    options: ValidateReceiptProps
+    sku: string,
+    androidOptions?: {
+      packageName: string
+      productToken: string
+      accessToken: string
+      isSub?: boolean
+    }
   ): Promise<ReceiptValidationResult>
 }
 
@@ -580,7 +600,7 @@ export interface PurchaseError {
 /**
  * Validation options for receipt validation
  */
-export interface ValidateReceiptProps {
+export interface ReceiptValidationProps {
   /** Product SKU to validate */
   sku: string
   /** Android-specific validation options */
@@ -595,7 +615,7 @@ export interface ValidateReceiptProps {
 /**
  * iOS receipt validation result
  */
-export interface ReceiptIOS {
+export interface ReceiptValidationResultIOS {
   /** Whether the receipt is valid */
   isValid: boolean
   /** Receipt data string */
@@ -609,35 +629,6 @@ export interface ReceiptIOS {
 /**
  * Android receipt validation result
  */
-export interface ReceiptAndroid {
-  /** Whether the receipt is valid */
-  isValid: boolean
-  /** Receipt data string */
-  receiptData: string
-  /** JWS representation */
-  jwsRepresentation: string
-  /** Latest transaction if available */
-  latestTransaction?: Purchase
-}
-
-/**
- * Receipt validation result from receipt validation
- */
-export type ReceiptValidationResult = ReceiptAndroid | ReceiptIOS
-
-/**
- * New iOS receipt validation result (matches user specification)
- */
-export interface ReceiptValidationResultIOS {
-  isValid: boolean
-  receiptData: string
-  jwsRepresentation: string
-  latestTransaction?: Purchase
-}
-
-/**
- * New Android receipt validation result (matches user specification)
- */
 export interface ReceiptValidationResultAndroid {
   autoRenewing: boolean
   betaProduct: boolean
@@ -649,7 +640,7 @@ export interface ReceiptValidationResultAndroid {
   gracePeriodEndDate: number
   parentProductId: string
   productId: string
-  productType: string
+  productType: 'inapp' | 'subs'
   purchaseDate: number
   quantity: number
   receiptId: string
@@ -659,6 +650,13 @@ export interface ReceiptValidationResultAndroid {
   testTransaction: boolean
 }
 
+/**
+ * Receipt validation result from receipt validation
+ */
+export type ReceiptValidationResult =
+  | ReceiptValidationResultAndroid
+  | ReceiptValidationResultIOS
+
 /**
  * Represents an active subscription with platform-specific details
  */
@@ -667,9 +665,15 @@ export interface ActiveSubscription {
   productId: string
   /** Whether the subscription is currently active */
   isActive: boolean
+  /** Transaction identifier for backend validation */
+  transactionId: string
+  /** JWT token (iOS) or purchase token (Android) for backend validation */
+  purchaseToken?: string
+  /** Transaction timestamp */
+  transactionDate: number
   /** iOS: Subscription expiration date */
   expirationDateIOS?: Date
-  /** Android: Whether the subscription auto-renews */
+  /** @deprecated Use the common `isAutoRenewing` field instead */
   autoRenewingAndroid?: boolean
   /** iOS: Environment where the subscription was purchased (Production/Sandbox) */
   environmentIOS?: string

package/src/utils/error.ts

@@ -2,15 +2,15 @@
  * Error utilities for parsing platform-specific error responses
  */
 
-import { ErrorCode } from '../types'
+import {ErrorCode} from '../types';
 
 export interface IapError {
-  code: string
-  message: string
-  responseCode?: number
-  debugMessage?: string
-  productId?: string
-  [key: string]: any // Allow additional platform-specific fields
+  code: string;
+  message: string;
+  responseCode?: number;
+  debugMessage?: string;
+  productId?: string;
+  [key: string]: any; // Allow additional platform-specific fields
 }
 
 /**
@@ -25,11 +25,11 @@ export interface IapError {
  * @returns Parsed error object with code and message
  */
 export function parseErrorStringToJsonObj(
-  errorString: string | Error | unknown
+  errorString: string | Error | unknown,
 ): IapError {
   // Handle Error objects
   if (errorString instanceof Error) {
-    errorString = errorString.message
+    errorString = errorString.message;
   }
 
   // Handle non-string inputs
@@ -37,35 +37,35 @@ export function parseErrorStringToJsonObj(
     return {
       code: ErrorCode.E_UNKNOWN,
       message: 'Unknown error occurred',
-    }
+    };
   }
 
   // Try to parse as JSON first
   try {
-    const parsed = JSON.parse(errorString)
+    const parsed = JSON.parse(errorString);
     if (typeof parsed === 'object' && parsed !== null) {
       // Ensure it has at least code and message
       return {
         code: parsed.code || ErrorCode.E_UNKNOWN,
         message: parsed.message || errorString,
         ...parsed,
-      }
+      };
     }
   } catch {
     // Not JSON, continue with other formats
   }
 
   // Try to parse "CODE: message" format
-  const colonIndex = errorString.indexOf(':')
+  const colonIndex = errorString.indexOf(':');
   if (colonIndex > 0 && colonIndex < 50) {
     // Reasonable position for error code
-    const potentialCode = errorString.substring(0, colonIndex).trim()
+    const potentialCode = errorString.substring(0, colonIndex).trim();
     // Check if it looks like an error code (starts with E_ or contains uppercase)
     if (potentialCode.startsWith('E_') || /^[A-Z_]+$/.test(potentialCode)) {
       return {
         code: potentialCode,
         message: errorString.substring(colonIndex + 1).trim(),
-      }
+      };
     }
   }
 
@@ -73,7 +73,7 @@ export function parseErrorStringToJsonObj(
   return {
     code: ErrorCode.E_UNKNOWN,
     message: errorString,
-  }
+  };
 }
 
 /**
@@ -82,16 +82,16 @@ export function parseErrorStringToJsonObj(
  * @returns true if the error is a user cancellation
  */
 export function isUserCancelledError(
-  error: IapError | string | Error | unknown
+  error: IapError | string | Error | unknown,
 ): boolean {
   const errorObj =
     typeof error === 'object' && error !== null && 'code' in error
       ? (error as IapError)
-      : parseErrorStringToJsonObj(error)
+      : parseErrorStringToJsonObj(error);
 
   return (
     errorObj.code === ErrorCode.E_USER_CANCELLED ||
     errorObj.code === 'E_USER_CANCELED' || // Alternative spelling
     errorObj.responseCode === 1
-  ) // Android BillingClient.BillingResponseCode.USER_CANCELED
+  ); // Android BillingClient.BillingResponseCode.USER_CANCELED
 }