react-native-iap 14.4.45 → 14.4.47

package/src/types.ts

@@ -28,6 +28,11 @@ export interface ActiveSubscription {
   renewalInfoIOS?: (RenewalInfoIOS | null);
   transactionDate: number;
   transactionId: string;
+  /**
+   * @deprecated iOS only - use daysUntilExpirationIOS instead.
+   * Whether the subscription will expire soon (within 7 days).
+   * Consider using daysUntilExpirationIOS for more precise control.
+   */
   willExpireSoon?: (boolean | null);
 }
 
@@ -131,6 +136,9 @@ export enum ErrorCode {
   NotPrepared = 'not-prepared',
   Pending = 'pending',
   PurchaseError = 'purchase-error',
+  PurchaseVerificationFailed = 'purchase-verification-failed',
+  PurchaseVerificationFinishFailed = 'purchase-verification-finish-failed',
+  PurchaseVerificationFinished = 'purchase-verification-finished',
   QueryProduct = 'query-product',
   ReceiptFailed = 'receipt-failed',
   ReceiptFinished = 'receipt-finished',
@@ -172,6 +180,11 @@ export type IapEvent = 'purchase-updated' | 'purchase-error' | 'promoted-product
 
 export type IapPlatform = 'ios' | 'android';
 
+/** Unified purchase states from IAPKit verification response. */
+export type IapkitPurchaseState = 'entitled' | 'pending-acknowledgment' | 'pending' | 'canceled' | 'expired' | 'ready-to-consume' | 'consumed' | 'unknown' | 'inauthentic';
+
+export type IapkitStore = 'apple' | 'google';
+
 /** Connection initialization configuration */
 export interface InitConnectionConfig {
   /**
@@ -241,8 +254,15 @@ export interface Mutation {
   showManageSubscriptionsIOS: Promise<PurchaseIOS[]>;
   /** Force a StoreKit sync for transactions (iOS 15+) */
   syncIOS: Promise<boolean>;
-  /** Validate purchase receipts with the configured providers */
-  validateReceipt: Promise<ReceiptValidationResult>;
+  /**
+   * Validate purchase receipts with the configured providers
+   * @deprecated Use verifyPurchase
+   */
+  validateReceipt: Promise<VerifyPurchaseResult>;
+  /** Verify purchases with the configured providers */
+  verifyPurchase: Promise<VerifyPurchaseResult>;
+  /** Verify purchases with a specific provider (e.g., IAPKit) */
+  verifyPurchaseWithProvider: Promise<VerifyPurchaseWithProviderResult>;
 }
 
 
@@ -282,7 +302,11 @@ export type MutationRequestPurchaseArgs =
     };
 
 
-export type MutationValidateReceiptArgs = ReceiptValidationProps;
+export type MutationValidateReceiptArgs = VerifyPurchaseProps;
+
+export type MutationVerifyPurchaseArgs = VerifyPurchaseProps;
+
+export type MutationVerifyPurchaseWithProviderArgs = VerifyPurchaseWithProviderProps;
 
 export type PaymentModeIOS = 'empty' | 'free-trial' | 'pay-as-you-go' | 'pay-up-front';
 
@@ -330,11 +354,11 @@ export interface ProductCommon {
   displayName?: (string | null);
   displayPrice: string;
   id: string;
-  platform: IapPlatform;
+  platform: 'android' | 'ios';
   price?: (number | null);
   title: string;
-  type: ProductType;
-}
+  type: 'in-app' | 'subs';
+} 
 
 export interface ProductIOS extends ProductCommon {
   currency: string;
@@ -522,6 +546,8 @@ export interface PurchaseOptions {
 
 export type PurchaseState = 'pending' | 'purchased' | 'failed' | 'restored' | 'deferred' | 'unknown';
 
+export type PurchaseVerificationProvider = 'iapkit';
+
 export interface Query {
   /** Check if external purchase notice sheet can be presented (iOS 18.2+) */
   canPresentExternalPurchaseNoticeIOS: Promise<boolean>;
@@ -560,8 +586,11 @@ export interface Query {
   latestTransactionIOS?: Promise<(PurchaseIOS | null)>;
   /** Get StoreKit 2 subscription status details (iOS 15+) */
   subscriptionStatusIOS: Promise<SubscriptionStatusIOS[]>;
-  /** Validate a receipt for a specific product */
-  validateReceiptIOS: Promise<ReceiptValidationResultIOS>;
+  /**
+   * Validate a receipt for a specific product
+   * @deprecated Use verifyPurchase
+   */
+  validateReceiptIOS: Promise<VerifyPurchaseResultIOS>;
 }
 
 
@@ -586,55 +615,7 @@ export type QueryLatestTransactionIosArgs = string;
 
 export type QuerySubscriptionStatusIosArgs = string;
 
-export type QueryValidateReceiptIosArgs = ReceiptValidationProps;
-
-export interface ReceiptValidationAndroidOptions {
-  accessToken: string;
-  isSub?: (boolean | null);
-  packageName: string;
-  productToken: string;
-}
-
-export interface ReceiptValidationProps {
-  /** Android-specific validation options */
-  androidOptions?: (ReceiptValidationAndroidOptions | null);
-  /** Product SKU to validate */
-  sku: string;
-}
-
-export type ReceiptValidationResult = ReceiptValidationResultAndroid | ReceiptValidationResultIOS;
-
-export interface ReceiptValidationResultAndroid {
-  autoRenewing: boolean;
-  betaProduct: boolean;
-  cancelDate?: (number | null);
-  cancelReason?: (string | null);
-  deferredDate?: (number | null);
-  deferredSku?: (string | null);
-  freeTrialEndDate: number;
-  gracePeriodEndDate: number;
-  parentProductId: string;
-  productId: string;
-  productType: string;
-  purchaseDate: number;
-  quantity: number;
-  receiptId: string;
-  renewalDate: number;
-  term: string;
-  termSku: string;
-  testTransaction: boolean;
-}
-
-export interface ReceiptValidationResultIOS {
-  /** Whether the receipt is valid */
-  isValid: boolean;
-  /** JWS representation */
-  jwsRepresentation: string;
-  /** Latest transaction if available */
-  latestTransaction?: (Purchase | null);
-  /** Receipt data string */
-  receiptData: string;
-}
+export type QueryValidateReceiptIosArgs = VerifyPurchaseProps;
 
 export interface RefundResultIOS {
   message?: (string | null);
@@ -769,6 +750,33 @@ export interface RequestSubscriptionPropsByPlatforms {
   ios?: (RequestSubscriptionIosProps | null);
 }
 
+export interface RequestVerifyPurchaseWithIapkitAppleProps {
+  /** The JWS token returned with the purchase response. */
+  jws: string;
+}
+
+export interface RequestVerifyPurchaseWithIapkitGoogleProps {
+  /** The token provided to the user's device when the product or subscription was purchased. */
+  purchaseToken: string;
+}
+
+export interface RequestVerifyPurchaseWithIapkitProps {
+  /** API key used for the Authorization header (Bearer {apiKey}). */
+  apiKey?: (string | null);
+  /** Apple verification parameters. */
+  apple?: (RequestVerifyPurchaseWithIapkitAppleProps | null);
+  /** Google verification parameters. */
+  google?: (RequestVerifyPurchaseWithIapkitGoogleProps | null);
+}
+
+export interface RequestVerifyPurchaseWithIapkitResult {
+  /** Whether the purchase is valid (not falsified). */
+  isValid: boolean;
+  /** The current state of the purchase. */
+  state: IapkitPurchaseState;
+  store: IapkitStore;
+}
+
 export interface Subscription {
   /** Fires when the App Store surfaces a promoted product (iOS only) */
   promotedProductIOS: string;
@@ -826,6 +834,65 @@ export interface UserChoiceBillingDetails {
   products: string[];
 }
 
+export interface VerifyPurchaseAndroidOptions {
+  accessToken: string;
+  isSub?: (boolean | null);
+  packageName: string;
+  productToken: string;
+}
+
+export interface VerifyPurchaseProps {
+  /** Android-specific validation options */
+  androidOptions?: (VerifyPurchaseAndroidOptions | null);
+  /** Product SKU to validate */
+  sku: string;
+}
+
+export type VerifyPurchaseResult = VerifyPurchaseResultAndroid | VerifyPurchaseResultIOS;
+
+export interface VerifyPurchaseResultAndroid {
+  autoRenewing: boolean;
+  betaProduct: boolean;
+  cancelDate?: (number | null);
+  cancelReason?: (string | null);
+  deferredDate?: (number | null);
+  deferredSku?: (string | null);
+  freeTrialEndDate: number;
+  gracePeriodEndDate: number;
+  parentProductId: string;
+  productId: string;
+  productType: string;
+  purchaseDate: number;
+  quantity: number;
+  receiptId: string;
+  renewalDate: number;
+  term: string;
+  termSku: string;
+  testTransaction: boolean;
+}
+
+export interface VerifyPurchaseResultIOS {
+  /** Whether the receipt is valid */
+  isValid: boolean;
+  /** JWS representation */
+  jwsRepresentation: string;
+  /** Latest transaction if available */
+  latestTransaction?: (Purchase | null);
+  /** Receipt data string */
+  receiptData: string;
+}
+
+export interface VerifyPurchaseWithProviderProps {
+  iapkit?: (RequestVerifyPurchaseWithIapkitProps | null);
+  provider: PurchaseVerificationProvider;
+}
+
+export interface VerifyPurchaseWithProviderResult {
+  /** IAPKit verification results (can include Apple and Google entries) */
+  iapkit: RequestVerifyPurchaseWithIapkitResult[];
+  provider: PurchaseVerificationProvider;
+}
+
 export type VoidResult = void;
 
 // -- Query helper types (auto-generated)
@@ -884,6 +951,8 @@ export type MutationArgsMap = {
   showManageSubscriptionsIOS: never;
   syncIOS: never;
   validateReceipt: MutationValidateReceiptArgs;
+  verifyPurchase: MutationVerifyPurchaseArgs;
+  verifyPurchaseWithProvider: MutationVerifyPurchaseWithProviderArgs;
 };
 
 export type MutationField<K extends keyof Mutation> =

package/src/utils/errorMapping.ts

@@ -11,6 +11,18 @@ const ERROR_CODE_ALIASES: Record<string, ErrorCode> = {
   USER_CANCELED: ErrorCode.UserCancelled,
   E_USER_CANCELLED: ErrorCode.UserCancelled,
   USER_CANCELLED: ErrorCode.UserCancelled,
+  // Deprecated error code mappings (map old Receipt* codes to new PurchaseVerification* codes)
+  // These ensure backwards compatibility while preferring new codes
+  RECEIPT_FAILED: ErrorCode.PurchaseVerificationFailed,
+  E_RECEIPT_FAILED: ErrorCode.PurchaseVerificationFailed,
+  RECEIPT_FINISHED: ErrorCode.PurchaseVerificationFinished,
+  E_RECEIPT_FINISHED: ErrorCode.PurchaseVerificationFinished,
+  RECEIPT_FINISHED_FAILED: ErrorCode.PurchaseVerificationFinishFailed,
+  E_RECEIPT_FINISHED_FAILED: ErrorCode.PurchaseVerificationFinishFailed,
+  // Also handle kebab-case versions
+  'receipt-failed': ErrorCode.PurchaseVerificationFailed,
+  'receipt-finished': ErrorCode.PurchaseVerificationFinished,
+  'receipt-finished-failed': ErrorCode.PurchaseVerificationFinishFailed,
 };
 
 const toKebabCase = (str: string): string => {
@@ -86,6 +98,11 @@ const COMMON_ERROR_CODE_MAP: Record<ErrorCode, string> = {
   [ErrorCode.BillingUnavailable]: ErrorCode.BillingUnavailable,
   [ErrorCode.FeatureNotSupported]: ErrorCode.FeatureNotSupported,
   [ErrorCode.EmptySkuList]: ErrorCode.EmptySkuList,
+  [ErrorCode.PurchaseVerificationFailed]: ErrorCode.PurchaseVerificationFailed,
+  [ErrorCode.PurchaseVerificationFinishFailed]:
+    ErrorCode.PurchaseVerificationFinishFailed,
+  [ErrorCode.PurchaseVerificationFinished]:
+    ErrorCode.PurchaseVerificationFinished,
 };
 
 export const ErrorCodeMapping = {
@@ -293,8 +310,6 @@ export function getUserFriendlyErrorMessage(error: ErrorLike): string {
       return 'Purchase cancelled';
     case ErrorCode.NetworkError:
       return 'Network connection error. Please check your internet connection and try again.';
-    case ErrorCode.ReceiptFinished:
-      return 'Receipt already finished';
     case ErrorCode.ServiceDisconnected:
       return 'Billing service disconnected. Please try again.';
     case ErrorCode.BillingUnavailable:
@@ -320,7 +335,14 @@ export function getUserFriendlyErrorMessage(error: ErrorLike): string {
     case ErrorCode.TransactionValidationFailed:
       return 'Transaction could not be verified';
     case ErrorCode.ReceiptFailed:
-      return 'Receipt processing failed';
+    case ErrorCode.PurchaseVerificationFailed:
+      return 'Purchase verification failed';
+    case ErrorCode.ReceiptFinished:
+    case ErrorCode.PurchaseVerificationFinished:
+      return 'Purchase verification completed';
+    case ErrorCode.ReceiptFinishedFailed:
+    case ErrorCode.PurchaseVerificationFinishFailed:
+      return 'Failed to complete purchase verification';
     case ErrorCode.EmptySkuList:
       return 'No product IDs provided';
     case ErrorCode.InitConnection:
@@ -345,12 +367,18 @@ export const normalizeErrorCodeFromNative = (code: unknown): ErrorCode => {
   if (typeof code === 'string') {
     const upper = code.toUpperCase();
 
-    // Check aliases first
+    // Check aliases first (includes deprecated Receipt* -> PurchaseVerification* mappings)
     const alias = ERROR_CODE_ALIASES[upper];
     if (alias) {
       return alias;
     }
 
+    // Also check lowercase alias for kebab-case codes
+    const lowerAlias = ERROR_CODE_ALIASES[code];
+    if (lowerAlias) {
+      return lowerAlias;
+    }
+
     // Handle various user cancelled formats
     if (
       upper === 'USER_CANCELLED' ||