react-native-iap 14.3.2 → 14.3.3

package/src/types.ts

@@ -1,665 +1,583 @@
 // ============================================================================
-// CORE TYPES
-// ============================================================================
-//
-// ⚠️  IMPORTANT: DO NOT MODIFY THIS FILE
-//
-// This types.ts file is based on the original react-native-iap library
-// and maintains backward compatibility for existing users.
-//
-// Any changes to these types could break existing applications.
-// New Nitro-specific types are defined in src/specs/RnIap.nitro.ts
-//
+// AUTO-GENERATED TYPES — DO NOT EDIT DIRECTLY
+// Run `npm run generate` after updating any *.graphql schema file.
 // ============================================================================
 
-export type ChangeEventPayload = {
-  value: string;
-};
+export interface ActiveSubscription {
+  autoRenewingAndroid?: boolean | null;
+  daysUntilExpirationIOS?: number | null;
+  environmentIOS?: string | null;
+  expirationDateIOS?: number | null;
+  isActive: boolean;
+  productId: string;
+  purchaseToken?: string | null;
+  transactionDate: number;
+  transactionId: string;
+  willExpireSoon?: boolean | null;
+}
 
-// iOS detailed product types (4 types)
-export enum ProductTypeIOS {
-  consumable = 'consumable',
-  nonConsumable = 'nonConsumable',
-  autoRenewableSubscription = 'autoRenewableSubscription',
-  nonRenewingSubscription = 'nonRenewingSubscription',
+export interface AndroidSubscriptionOfferInput {
+  /** Offer token */
+  offerToken: string;
+  /** Product SKU */
+  sku: string;
 }
 
-// ============================================================================
-// COMMON TYPES (Base types shared across all platforms)
-// ============================================================================
+export interface AppTransaction {
+  appId: number;
+  appTransactionId?: string | null;
+  appVersion: string;
+  appVersionId: number;
+  bundleId: string;
+  deviceVerification: string;
+  deviceVerificationNonce: string;
+  environment: string;
+  originalAppVersion: string;
+  originalPlatform?: string | null;
+  originalPurchaseDate: number;
+  preorderDate?: number | null;
+  signedDate: number;
+}
 
-/**
- * Base product information shared across all platforms
- */
-export type ProductCommon = {
-  /** Product identifier (SKU) */
-  id: string;
-  /** Product title displayed to users */
-  title: string;
-  /** Product description */
-  description: string;
-  /** 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") */
-  displayPrice: string;
-  /** Currency code (e.g., "USD", "EUR") */
-  currency: string;
-  /** Raw price value as number */
-  price?: number;
-  /** Debug description for development */
-  debugDescription?: string;
-  /** Platform identifier ('ios' or 'android') */
-  platform?: string;
-};
-
-/**
- * Base purchase information shared across all platforms
- * Represents both consumables, non-consumables, and subscriptions
- */
-export type PurchaseCommon = {
-  /** Transaction identifier - used by finishTransaction */
-  id: string;
-  /** Product identifier - which product was purchased */
-  productId: string;
-  /** Product identifiers for purchases that include multiple products */
-  ids?: string[];
-  /** @deprecated - use id instead */
-  transactionId?: string;
-  /** Transaction timestamp in milliseconds */
-  transactionDate: number;
-  /** Unified purchase token (jwsRepresentation for iOS, purchaseToken for Android) */
-  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 interface DeepLinkOptions {
+  /** Android package name to target (required on Android) */
+  packageNameAndroid?: string | null;
+  /** Android SKU to open (required on Android) */
+  skuAndroid?: string | null;
+}
 
-export enum PurchaseState {
-  pending = 'pending',
-  purchased = 'purchased',
-  failed = 'failed',
-  restored = 'restored', // iOS only
-  deferred = 'deferred', // iOS only
-  unknown = 'unknown',
+export interface DiscountIOS {
+  identifier: string;
+  localizedPrice?: string | null;
+  numberOfPeriods: number;
+  paymentMode: PaymentModeIOS;
+  price: string;
+  priceAmount: number;
+  subscriptionPeriod: string;
+  type: string;
 }
 
-export type ProductSubscriptionCommon = ProductCommon & {
-  type: 'subs';
-};
+export interface DiscountOfferIOS {
+  /** Discount identifier */
+  identifier: string;
+  /** Key identifier for validation */
+  keyIdentifier: string;
+  /** Cryptographic nonce */
+  nonce: string;
+  /** Signature for validation */
+  signature: string;
+  /** Timestamp of discount offer */
+  timestamp: number;
+}
 
-// ============================================================================
-// PLATFORM TYPES
-// ============================================================================
+export interface DiscountOfferInputIOS {
+  /** Discount identifier */
+  identifier: string;
+  /** Key identifier for validation */
+  keyIdentifier: string;
+  /** Cryptographic nonce */
+  nonce: string;
+  /** Signature for validation */
+  signature: string;
+  /** Timestamp of discount offer */
+  timestamp: number;
+}
 
-export type IosPlatform = {platform: 'ios'};
-export type AndroidPlatform = {platform: 'android'};
+export interface EntitlementIOS {
+  jsonRepresentation: string;
+  sku: string;
+  transactionId: string;
+}
 
-// ============================================================================
-// IOS TYPES
-// ============================================================================
+export enum ErrorCode {
+  ActivityUnavailable = 'ACTIVITY_UNAVAILABLE',
+  AlreadyOwned = 'ALREADY_OWNED',
+  AlreadyPrepared = 'ALREADY_PREPARED',
+  BillingResponseJsonParseError = 'BILLING_RESPONSE_JSON_PARSE_ERROR',
+  BillingUnavailable = 'BILLING_UNAVAILABLE',
+  ConnectionClosed = 'CONNECTION_CLOSED',
+  DeferredPayment = 'DEFERRED_PAYMENT',
+  DeveloperError = 'DEVELOPER_ERROR',
+  EmptySkuList = 'EMPTY_SKU_LIST',
+  FeatureNotSupported = 'FEATURE_NOT_SUPPORTED',
+  IapNotAvailable = 'IAP_NOT_AVAILABLE',
+  InitConnection = 'INIT_CONNECTION',
+  Interrupted = 'INTERRUPTED',
+  ItemNotOwned = 'ITEM_NOT_OWNED',
+  ItemUnavailable = 'ITEM_UNAVAILABLE',
+  NetworkError = 'NETWORK_ERROR',
+  NotEnded = 'NOT_ENDED',
+  NotPrepared = 'NOT_PREPARED',
+  Pending = 'PENDING',
+  PurchaseError = 'PURCHASE_ERROR',
+  QueryProduct = 'QUERY_PRODUCT',
+  ReceiptFailed = 'RECEIPT_FAILED',
+  ReceiptFinished = 'RECEIPT_FINISHED',
+  ReceiptFinishedFailed = 'RECEIPT_FINISHED_FAILED',
+  RemoteError = 'REMOTE_ERROR',
+  ServiceDisconnected = 'SERVICE_DISCONNECTED',
+  ServiceError = 'SERVICE_ERROR',
+  SkuNotFound = 'SKU_NOT_FOUND',
+  SkuOfferMismatch = 'SKU_OFFER_MISMATCH',
+  SyncError = 'SYNC_ERROR',
+  TransactionValidationFailed = 'TRANSACTION_VALIDATION_FAILED',
+  Unknown = 'UNKNOWN',
+  UserCancelled = 'USER_CANCELLED',
+  UserError = 'USER_ERROR',
+}
+
+export interface FetchProductsResult {
+  products?: Product[] | null;
+  subscriptions?: ProductSubscription[] | null;
+}
+
+export enum IapEvent {
+  PromotedProductIos = 'PROMOTED_PRODUCT_IOS',
+  PurchaseError = 'PURCHASE_ERROR',
+  PurchaseUpdated = 'PURCHASE_UPDATED',
+}
 
-type SubscriptionIosPeriod = 'DAY' | 'WEEK' | 'MONTH' | 'YEAR' | '';
-type PaymentMode = '' | 'FREETRIAL' | 'PAYASYOUGO' | 'PAYUPFRONT';
+export interface Mutation {
+  /** Acknowledge a non-consumable purchase or subscription */
+  acknowledgePurchaseAndroid: Promise<VoidResult>;
+  /** Initiate a refund request for a product (iOS 15+) */
+  beginRefundRequestIOS: Promise<RefundResultIOS>;
+  /** Clear pending transactions from the StoreKit payment queue */
+  clearTransactionIOS: Promise<VoidResult>;
+  /** Consume a purchase token so it can be repurchased */
+  consumePurchaseAndroid: Promise<VoidResult>;
+  /** Open the native subscription management surface */
+  deepLinkToSubscriptions: Promise<VoidResult>;
+  /** Close the platform billing connection */
+  endConnection: Promise<boolean>;
+  /** Finish a transaction after validating receipts */
+  finishTransaction: Promise<VoidResult>;
+  /** Establish the platform billing connection */
+  initConnection: Promise<boolean>;
+  /** Present the App Store code redemption sheet */
+  presentCodeRedemptionSheetIOS: Promise<VoidResult>;
+  /** Initiate a purchase flow; rely on events for final state */
+  requestPurchase?: Promise<RequestPurchaseResult | null>;
+  /** Purchase the promoted product surfaced by the App Store */
+  requestPurchaseOnPromotedProductIOS: Promise<PurchaseIOS>;
+  /** Restore completed purchases across platforms */
+  restorePurchases: Promise<VoidResult>;
+  /** Open subscription management UI and return changed purchases (iOS 15+) */
+  showManageSubscriptionsIOS: Promise<PurchaseIOS[]>;
+  /** Force a StoreKit sync for transactions (iOS 15+) */
+  syncIOS: Promise<VoidResult>;
+  /** Validate purchase receipts with the configured providers */
+  validateReceipt: Promise<ReceiptValidationResult>;
+}
+
+export interface MutationacknowledgePurchaseAndroidArgs {
+  purchaseToken: string;
+}
+
+export interface MutationbeginRefundRequestIOSArgs {
+  sku: string;
+}
+
+export interface MutationconsumePurchaseAndroidArgs {
+  purchaseToken: string;
+}
+
+export interface MutationdeepLinkToSubscriptionsArgs {
+  options?: DeepLinkOptions | null;
+}
+
+export interface MutationfinishTransactionArgs {
+  isConsumable?: boolean | null;
+  purchase: PurchaseInput;
+}
+
+export interface MutationrequestPurchaseArgs {
+  params: PurchaseParams;
+}
+
+export interface MutationvalidateReceiptArgs {
+  options: ReceiptValidationProps;
+}
+
+export enum PaymentModeIOS {
+  Empty = 'EMPTY',
+  FreeTrial = 'FREE_TRIAL',
+  PayAsYouGo = 'PAY_AS_YOU_GO',
+  PayUpFront = 'PAY_UP_FRONT',
+}
+
+export enum Platform {
+  Android = 'ANDROID',
+  Ios = 'IOS',
+}
 
-type SubscriptionOffer = {
+export interface PricingPhaseAndroid {
+  billingCycleCount: number;
+  billingPeriod: string;
+  formattedPrice: string;
+  priceAmountMicros: string;
+  priceCurrencyCode: string;
+  recurrenceMode: number;
+}
+
+export interface PricingPhasesAndroid {
+  pricingPhaseList: PricingPhaseAndroid[];
+}
+
+export type Product = ProductAndroid | ProductIOS;
+
+export interface ProductAndroid extends ProductCommon {
+  currency: string;
+  debugDescription?: string | null;
+  description: string;
+  displayName?: string | null;
   displayPrice: string;
   id: string;
-  paymentMode: PaymentMode;
-  period: {
-    unit: SubscriptionIosPeriod;
-    value: number;
-  };
-  periodCount: number;
-  price: number;
-  type: 'introductory' | 'promotional';
-};
+  nameAndroid: string;
+  oneTimePurchaseOfferDetailsAndroid?: ProductAndroidOneTimePurchaseOfferDetail | null;
+  platform: Platform;
+  price?: number | null;
+  subscriptionOfferDetailsAndroid?:
+    | ProductSubscriptionAndroidOfferDetails[]
+    | null;
+  title: string;
+  type: ProductType;
+}
 
-type SubscriptionInfo = {
-  introductoryOffer?: SubscriptionOffer;
-  promotionalOffers?: SubscriptionOffer[];
-  subscriptionGroupId: string;
-  subscriptionPeriod: {
-    unit: SubscriptionIosPeriod;
-    value: number;
-  };
-};
+export interface ProductAndroidOneTimePurchaseOfferDetail {
+  formattedPrice: string;
+  priceAmountMicros: string;
+  priceCurrencyCode: string;
+}
 
-export type Discount = {
-  identifier: string;
-  type: string;
-  numberOfPeriods: string;
-  price: string;
-  localizedPrice: string;
-  paymentMode: PaymentMode;
-  subscriptionPeriod: string;
-};
+export interface ProductCommon {
+  currency: string;
+  debugDescription?: string | null;
+  description: string;
+  displayName?: string | null;
+  displayPrice: string;
+  id: string;
+  platform: Platform;
+  price?: number | null;
+  title: string;
+  type: ProductType;
+}
 
-export type ProductIOS = ProductCommon & {
+export interface ProductIOS extends ProductCommon {
+  currency: string;
+  debugDescription?: string | null;
+  description: string;
+  displayName?: string | null;
   displayNameIOS: string;
+  displayPrice: string;
+  id: string;
   isFamilyShareableIOS: boolean;
   jsonRepresentationIOS: string;
-  platform: 'ios';
-  subscriptionInfoIOS?: SubscriptionInfo;
-  typeIOS: ProductTypeIOS; // Detailed iOS product type
-  // deprecated fields
-  displayName?: string;
-  isFamilyShareable?: boolean;
-  jsonRepresentation?: string;
-  subscription?: SubscriptionInfo;
-  introductoryPriceNumberOfPeriodsIOS?: string;
-  introductoryPriceSubscriptionPeriodIOS?: SubscriptionIosPeriod;
-};
-
-export type ProductSubscriptionIOS = ProductIOS & {
-  discountsIOS?: Discount[];
-  introductoryPriceIOS?: string;
-  introductoryPriceAsAmountIOS?: string;
-  introductoryPricePaymentModeIOS?: PaymentMode;
-  introductoryPriceNumberOfPeriodsIOS?: string;
-  introductoryPriceSubscriptionPeriodIOS?: SubscriptionIosPeriod;
-  platform: 'ios';
-  subscriptionPeriodNumberIOS?: string;
-  subscriptionPeriodUnitIOS?: SubscriptionIosPeriod;
-  // deprecated
-  discounts?: Discount[];
-  introductoryPrice?: string;
-};
-
-export type PurchaseIOS = PurchaseCommon & {
-  platform: 'ios';
-  quantityIOS?: number;
-  originalTransactionDateIOS?: number;
-  originalTransactionIdentifierIOS?: string;
-  appAccountToken?: string;
-  // iOS additional fields from StoreKit 2
-  expirationDateIOS?: number;
-  webOrderLineItemIdIOS?: number;
-  environmentIOS?: string;
-  storefrontCountryCodeIOS?: string;
-  appBundleIdIOS?: string;
-  productTypeIOS?: string;
-  subscriptionGroupIdIOS?: string;
-  isUpgradedIOS?: boolean;
-  ownershipTypeIOS?: string;
-  reasonIOS?: string;
-  reasonStringRepresentationIOS?: string;
-  transactionReasonIOS?: 'PURCHASE' | 'RENEWAL' | string;
-  revocationDateIOS?: number;
-  revocationReasonIOS?: string;
-  offerIOS?: {
-    id: string;
-    type: string;
-    paymentMode: string;
-  };
-  // Price locale fields
-  currencyCodeIOS?: string;
-  currencySymbolIOS?: string;
-  countryCodeIOS?: string;
-  /**
-   * @deprecated Use `purchaseToken` instead. This field will be removed in a future version.
-   * iOS 15+ JWS representation is now available through the `purchaseToken` field.
-   */
-  jwsRepresentationIOS?: string;
-};
-
-/**
- * iOS subscription renewal info
- */
-export interface SubscriptionRenewalInfoIOS {
-  autoRenewStatus: boolean;
-  autoRenewPreference?: string;
-  expirationReason?: number;
-  gracePeriodExpirationDate?: number;
-  currentProductID?: string;
-  platform: 'ios';
-}
-
-/**
- * iOS subscription status entry
- */
-export interface SubscriptionStatusIOS {
-  state: number;
-  platform: 'ios';
-  renewalInfo?: SubscriptionRenewalInfoIOS;
+  platform: Platform;
+  price?: number | null;
+  subscriptionInfoIOS?: SubscriptionInfoIOS | null;
+  title: string;
+  type: ProductType;
+  typeIOS: ProductTypeIOS;
 }
 
-// ============================================================================
-// ANDROID TYPES
-// ============================================================================
+export enum ProductQueryType {
+  All = 'ALL',
+  InApp = 'IN_APP',
+  Subs = 'SUBS',
+}
 
-type ProductAndroidOneTimePurchaseOfferDetail = {
-  priceCurrencyCode: string;
-  formattedPrice: string;
-  priceAmountMicros: string;
-};
+export interface ProductRequest {
+  skus: string[];
+  type?: ProductQueryType | null;
+}
 
-type PricingPhaseAndroid = {
-  formattedPrice: string;
-  priceCurrencyCode: string;
-  billingPeriod: string; // P1W, P1M, P1Y
-  billingCycleCount: number;
-  priceAmountMicros: string;
-  recurrenceMode: number;
-};
+export type ProductSubscription =
+  | ProductSubscriptionAndroid
+  | ProductSubscriptionIOS;
 
-type PricingPhasesAndroid = {
-  pricingPhaseList: PricingPhaseAndroid[];
-};
+export interface ProductSubscriptionAndroid extends ProductCommon {
+  currency: string;
+  debugDescription?: string | null;
+  description: string;
+  displayName?: string | null;
+  displayPrice: string;
+  id: string;
+  nameAndroid: string;
+  oneTimePurchaseOfferDetailsAndroid?: ProductAndroidOneTimePurchaseOfferDetail | null;
+  platform: Platform;
+  price?: number | null;
+  subscriptionOfferDetailsAndroid: ProductSubscriptionAndroidOfferDetails[];
+  title: string;
+  type: ProductType;
+}
 
-type ProductSubscriptionAndroidOfferDetail = {
+export interface ProductSubscriptionAndroidOfferDetails {
   basePlanId: string;
-  offerId: string;
-  offerToken: string;
+  offerId?: string | null;
   offerTags: string[];
-  pricingPhases: PricingPhasesAndroid;
-};
-
-type ProductSubscriptionAndroidOfferDetails = {
-  basePlanId: string;
-  offerId: string | null;
   offerToken: string;
   pricingPhases: PricingPhasesAndroid;
-  offerTags: string[];
-};
+}
 
-export type ProductAndroid = ProductCommon & {
-  nameAndroid: string;
-  oneTimePurchaseOfferDetailsAndroid?: ProductAndroidOneTimePurchaseOfferDetail;
-  platform: 'android';
-  subscriptionOfferDetailsAndroid?: ProductSubscriptionAndroidOfferDetail[];
-  // deprecated fields
-  name?: string;
-  oneTimePurchaseOfferDetails?: ProductAndroidOneTimePurchaseOfferDetail;
-  subscriptionOfferDetails?: ProductSubscriptionAndroidOfferDetail[];
-};
-
-export type ProductSubscriptionAndroid = ProductAndroid & {
-  subscriptionOfferDetailsAndroid: ProductSubscriptionAndroidOfferDetails[];
-  // deprecated
-  subscriptionOfferDetails?: ProductSubscriptionAndroidOfferDetails[];
-};
-
-export type PurchaseAndroid = PurchaseCommon & {
-  platform: 'android';
-  /**
-   * @deprecated Use `purchaseToken` instead. This field will be removed in a future version.
-   */
-  purchaseTokenAndroid?: string;
-  dataAndroid?: string;
-  signatureAndroid?: string;
-  /** @deprecated Use the common `isAutoRenewing` field instead */
-  autoRenewingAndroid?: boolean;
-  isAcknowledgedAndroid?: boolean;
-  packageNameAndroid?: string;
-  developerPayloadAndroid?: string;
-  obfuscatedAccountIdAndroid?: string;
-  obfuscatedProfileIdAndroid?: string;
-};
+export interface ProductSubscriptionIOS extends ProductCommon {
+  currency: string;
+  debugDescription?: string | null;
+  description: string;
+  discountsIOS?: DiscountIOS[] | null;
+  displayName?: string | null;
+  displayNameIOS: string;
+  displayPrice: string;
+  id: string;
+  introductoryPriceAsAmountIOS?: string | null;
+  introductoryPriceIOS?: string | null;
+  introductoryPriceNumberOfPeriodsIOS?: string | null;
+  introductoryPricePaymentModeIOS?: PaymentModeIOS | null;
+  introductoryPriceSubscriptionPeriodIOS?: SubscriptionPeriodIOS | null;
+  isFamilyShareableIOS: boolean;
+  jsonRepresentationIOS: string;
+  platform: Platform;
+  price?: number | null;
+  subscriptionInfoIOS?: SubscriptionInfoIOS | null;
+  subscriptionPeriodNumberIOS?: string | null;
+  subscriptionPeriodUnitIOS?: SubscriptionPeriodIOS | null;
+  title: string;
+  type: ProductType;
+  typeIOS: ProductTypeIOS;
+}
 
-// ============================================================================
-// TYPE ALIASES
-// ============================================================================
+export enum ProductType {
+  InApp = 'IN_APP',
+  Subs = 'SUBS',
+}
 
-// Legacy naming for backward compatibility
-export type ProductPurchaseIOS = PurchaseIOS;
-export type ProductPurchaseAndroid = PurchaseAndroid;
+export enum ProductTypeIOS {
+  AutoRenewableSubscription = 'AUTO_RENEWABLE_SUBSCRIPTION',
+  Consumable = 'CONSUMABLE',
+  NonConsumable = 'NON_CONSUMABLE',
+  NonRenewingSubscription = 'NON_RENEWING_SUBSCRIPTION',
+}
 
-// Legacy naming for backward compatibility
-export type SubscriptionProductIOS = ProductSubscriptionIOS;
-export type SubscriptionProductAndroid = ProductSubscriptionAndroid;
+export type Purchase = PurchaseAndroid | PurchaseIOS;
 
-// ============================================================================
-// UNION TYPES
-// ============================================================================
+export interface PurchaseAndroid extends PurchaseCommon {
+  autoRenewingAndroid?: boolean | null;
+  dataAndroid?: string | null;
+  developerPayloadAndroid?: string | null;
+  id: string;
+  ids?: string[] | null;
+  isAcknowledgedAndroid?: boolean | null;
+  isAutoRenewing: boolean;
+  obfuscatedAccountIdAndroid?: string | null;
+  obfuscatedProfileIdAndroid?: string | null;
+  packageNameAndroid?: string | null;
+  platform: Platform;
+  productId: string;
+  purchaseState: PurchaseState;
+  purchaseToken?: string | null;
+  quantity: number;
+  signatureAndroid?: string | null;
+  transactionDate: number;
+}
 
-// Product Union Types
-export type Product =
-  | (ProductAndroid & AndroidPlatform)
-  | (ProductIOS & IosPlatform);
-
-export type SubscriptionProduct =
-  | (ProductSubscriptionAndroid & AndroidPlatform)
-  | (ProductSubscriptionIOS & IosPlatform);
-
-// Purchase Union Types
-/**
- * Regular product purchase (consumable or non-consumable)
- * Both types appear in getAvailablePurchases until finishTransaction is called
- */
-export type ProductPurchase =
-  | (PurchaseAndroid & AndroidPlatform)
-  | (PurchaseIOS & IosPlatform);
-
-/**
- * Active subscription purchase
- * Appears in getAvailablePurchases while subscription is active
- */
-export type SubscriptionPurchase =
-  | (PurchaseAndroid & AndroidPlatform & {autoRenewingAndroid: boolean})
-  | (PurchaseIOS & IosPlatform);
-
-/**
- * Combined purchase type that includes all purchase types
- * Used as return type for getAvailablePurchases
- */
-export type Purchase =
-  | (PurchaseAndroid & AndroidPlatform)
-  | (PurchaseIOS & IosPlatform);
+export interface PurchaseCommon {
+  id: string;
+  ids?: string[] | null;
+  isAutoRenewing: boolean;
+  platform: Platform;
+  productId: string;
+  purchaseState: PurchaseState;
+  /** Unified purchase token (iOS JWS, Android purchaseToken) */
+  purchaseToken?: string | null;
+  quantity: number;
+  transactionDate: number;
+}
 
-// ============================================================================
-// REQUEST TYPES
-// ============================================================================
+export interface PurchaseError {
+  code: ErrorCode;
+  message: string;
+  productId?: string | null;
+}
 
-// 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';
+export interface PurchaseIOS extends PurchaseCommon {
+  appAccountToken?: string | null;
+  appBundleIdIOS?: string | null;
+  countryCodeIOS?: string | null;
+  currencyCodeIOS?: string | null;
+  currencySymbolIOS?: string | null;
+  environmentIOS?: string | null;
+  expirationDateIOS?: number | null;
+  id: string;
+  ids?: string[] | null;
+  isAutoRenewing: boolean;
+  isUpgradedIOS?: boolean | null;
+  offerIOS?: PurchaseOfferIOS | null;
+  originalTransactionDateIOS?: number | null;
+  originalTransactionIdentifierIOS?: string | null;
+  ownershipTypeIOS?: string | null;
+  platform: Platform;
+  productId: string;
+  purchaseState: PurchaseState;
+  purchaseToken?: string | null;
+  quantity: number;
+  quantityIOS?: number | null;
+  reasonIOS?: string | null;
+  reasonStringRepresentationIOS?: string | null;
+  revocationDateIOS?: number | null;
+  revocationReasonIOS?: string | null;
+  storefrontCountryCodeIOS?: string | null;
+  subscriptionGroupIdIOS?: string | null;
+  transactionDate: number;
+  transactionReasonIOS?: string | null;
+  webOrderLineItemIdIOS?: string | null;
 }
 
-// iOS-specific purchase request parameters
-export interface RequestPurchaseIosProps {
-  readonly sku: string;
-  readonly andDangerouslyFinishTransactionAutomatically?: boolean;
-  readonly appAccountToken?: string;
-  readonly quantity?: number;
-  readonly withOffer?: DiscountOffer;
+export interface PurchaseInput {
+  id: string;
+  ids?: string[] | null;
+  isAutoRenewing: boolean;
+  platform: Platform;
+  productId: string;
+  purchaseState: PurchaseState;
+  purchaseToken?: string | null;
+  quantity: number;
+  transactionDate: number;
 }
 
-// Android-specific purchase request parameters
-export interface RequestPurchaseAndroidProps {
-  readonly skus: string[];
-  readonly obfuscatedAccountIdAndroid?: string;
-  readonly obfuscatedProfileIdAndroid?: string;
-  readonly isOfferPersonalized?: boolean;
+export interface PurchaseOfferIOS {
+  id: string;
+  paymentMode: string;
+  type: string;
 }
 
-// Android-specific subscription request parameters
-export interface RequestSubscriptionAndroidProps
-  extends RequestPurchaseAndroidProps {
-  readonly purchaseTokenAndroid?: string;
-  readonly replacementModeAndroid?: number;
-  readonly subscriptionOffers: {
-    sku: string;
-    offerToken: string;
-  }[];
+export interface PurchaseOptions {
+  /** Also emit results through the iOS event listeners */
+  alsoPublishToEventListenerIOS?: boolean | null;
+  /** Limit to currently active items on iOS */
+  onlyIncludeActiveItemsIOS?: boolean | null;
 }
 
-// Platform-specific request structures
-export interface RequestPurchasePropsByPlatforms {
-  readonly ios?: RequestPurchaseIosProps;
-  readonly android?: RequestPurchaseAndroidProps;
+export interface PurchaseParams {
+  /** Per-platform purchase request props */
+  requestPurchase?: RequestPurchasePropsByPlatforms | null;
+  /** Per-platform subscription request props */
+  requestSubscription?: RequestSubscriptionPropsByPlatforms | null;
+  /** Explicit purchase type hint (defaults to in-app) */
+  type?: ProductQueryType | null;
 }
 
-export interface RequestSubscriptionPropsByPlatforms {
-  readonly ios?: RequestPurchaseIosProps;
-  readonly android?: RequestSubscriptionAndroidProps;
+export enum PurchaseState {
+  Deferred = 'DEFERRED',
+  Failed = 'FAILED',
+  Pending = 'PENDING',
+  Purchased = 'PURCHASED',
+  Restored = 'RESTORED',
+  Unknown = 'UNKNOWN',
 }
 
-// Modern request types (v2.7.0+)
-export type RequestPurchaseProps = RequestPurchasePropsByPlatforms;
-export type RequestSubscriptionProps = RequestSubscriptionPropsByPlatforms;
+export interface Query {
+  /** Get current StoreKit 2 entitlements (iOS 15+) */
+  currentEntitlementIOS: Promise<EntitlementIOS[]>;
+  /** Retrieve products or subscriptions from the store */
+  fetchProducts: Promise<FetchProductsResult>;
+  /** Get active subscriptions (filters by subscriptionIds when provided) */
+  getActiveSubscriptions: Promise<ActiveSubscription[]>;
+  /** Fetch the current app transaction (iOS 16+) */
+  getAppTransactionIOS?: Promise<AppTransaction | null>;
+  /** Get all available purchases for the current user */
+  getAvailablePurchases: Promise<Purchase[]>;
+  /** Retrieve all pending transactions in the StoreKit queue */
+  getPendingTransactionsIOS: Promise<PurchaseIOS[]>;
+  /** Get the currently promoted product (iOS 11+) */
+  getPromotedProductIOS?: Promise<ProductIOS | null>;
+  /** Get base64-encoded receipt data for validation */
+  getReceiptDataIOS: Promise<string>;
+  /** Get the current App Store storefront country code */
+  getStorefrontIOS: Promise<string>;
+  /** Get the transaction JWS (StoreKit 2) */
+  getTransactionJwsIOS: Promise<string>;
+  /** Check whether the user has active subscriptions */
+  hasActiveSubscriptions: Promise<boolean>;
+  /** Check introductory offer eligibility for specific products */
+  isEligibleForIntroOfferIOS: Promise<boolean>;
+  /** Verify a StoreKit 2 transaction signature */
+  isTransactionVerifiedIOS: Promise<boolean>;
+  /** Get the latest transaction for a product using StoreKit 2 */
+  latestTransactionIOS?: Promise<PurchaseIOS | null>;
+  /** Get StoreKit 2 subscription status details (iOS 15+) */
+  subscriptionStatusIOS: Promise<SubscriptionStatusIOS[]>;
+}
 
-// ============================================================================
-// ERROR TYPES
-// ============================================================================
+export interface QuerycurrentEntitlementIOSArgs {
+  skus?: string[] | null;
+}
 
-export enum ErrorCode {
-  E_UNKNOWN = 'E_UNKNOWN',
-  E_USER_CANCELLED = 'E_USER_CANCELLED',
-  E_USER_ERROR = 'E_USER_ERROR',
-  E_ITEM_UNAVAILABLE = 'E_ITEM_UNAVAILABLE',
-  E_REMOTE_ERROR = 'E_REMOTE_ERROR',
-  E_NETWORK_ERROR = 'E_NETWORK_ERROR',
-  E_SERVICE_ERROR = 'E_SERVICE_ERROR',
-  E_RECEIPT_FAILED = 'E_RECEIPT_FAILED',
-  E_RECEIPT_FINISHED_FAILED = 'E_RECEIPT_FINISHED_FAILED',
-  E_NOT_PREPARED = 'E_NOT_PREPARED',
-  E_NOT_ENDED = 'E_NOT_ENDED',
-  E_ALREADY_OWNED = 'E_ALREADY_OWNED',
-  E_DEVELOPER_ERROR = 'E_DEVELOPER_ERROR',
-  E_BILLING_RESPONSE_JSON_PARSE_ERROR = 'E_BILLING_RESPONSE_JSON_PARSE_ERROR',
-  E_DEFERRED_PAYMENT = 'E_DEFERRED_PAYMENT',
-  E_INTERRUPTED = 'E_INTERRUPTED',
-  E_IAP_NOT_AVAILABLE = 'E_IAP_NOT_AVAILABLE',
-  E_PURCHASE_ERROR = 'E_PURCHASE_ERROR',
-  E_SYNC_ERROR = 'E_SYNC_ERROR',
-  E_TRANSACTION_VALIDATION_FAILED = 'E_TRANSACTION_VALIDATION_FAILED',
-  E_ACTIVITY_UNAVAILABLE = 'E_ACTIVITY_UNAVAILABLE',
-  E_ALREADY_PREPARED = 'E_ALREADY_PREPARED',
-  E_PENDING = 'E_PENDING',
-  E_CONNECTION_CLOSED = 'E_CONNECTION_CLOSED',
-  E_INIT_CONNECTION = 'E_INIT_CONNECTION',
-  E_SERVICE_DISCONNECTED = 'E_SERVICE_DISCONNECTED',
-  E_QUERY_PRODUCT = 'E_QUERY_PRODUCT',
-  E_SKU_NOT_FOUND = 'E_SKU_NOT_FOUND',
-  E_SKU_OFFER_MISMATCH = 'E_SKU_OFFER_MISMATCH',
-  E_ITEM_NOT_OWNED = 'E_ITEM_NOT_OWNED',
-  E_BILLING_UNAVAILABLE = 'E_BILLING_UNAVAILABLE',
-  E_FEATURE_NOT_SUPPORTED = 'E_FEATURE_NOT_SUPPORTED',
-  E_EMPTY_SKU_LIST = 'E_EMPTY_SKU_LIST',
-}
-
-export type PurchaseResult = {
-  responseCode?: number;
-  debugMessage?: string;
-  code?: string;
-  message?: string;
-  /**
-   * @deprecated Use `purchaseToken` instead. This field will be removed in a future version.
-   */
-  purchaseTokenAndroid?: string;
-  purchaseToken?: string;
-};
-
-// Additional iOS types
-export type DiscountOffer = {
-  identifier: string;
-  keyIdentifier: string;
-  nonce: string;
-  signature: string;
-  timestamp: number;
-};
+export interface QueryfetchProductsArgs {
+  params: ProductRequest;
+}
 
-export type AppTransactionIOS = {
-  appTransactionId?: string;
-  originalPlatform?: string;
-  bundleId: string;
-  appVersion: string;
-  originalAppVersion: string;
-  originalPurchaseDate: number;
-  deviceVerification: string;
-  deviceVerificationNonce: string;
-  environment: string;
-  signedDate: number;
-  appId?: number;
-  appVersionId?: number;
-  preorderDate?: number;
-};
+export interface QuerygetActiveSubscriptionsArgs {
+  subscriptionIds?: string[] | null;
+}
 
-// ============================================================================
-// METHOD OPTIONS TYPES
-// ============================================================================
+export interface QuerygetAvailablePurchasesArgs {
+  options?: PurchaseOptions | null;
+}
 
-/**
- * Options for getAvailablePurchases and getPurchaseHistories methods
- */
-export interface PurchaseOptions {
-  /** Whether to also publish purchases to event listener */
-  alsoPublishToEventListenerIOS?: boolean;
-  /** Whether to only include active items (subscriptions that are still active) */
-  onlyIncludeActiveItemsIOS?: boolean;
-}
-
-/**
- * Parameters for finishTransaction method
- */
-export interface FinishTransactionParams {
-  /** The purchase to finish/consume */
-  purchase: Purchase;
-  /**
-   * Whether this is a consumable product that should be consumed.
-   * - Set to true for consumable products (e.g., "20 credits", "100 coins")
-   * - Set to false (or omit) for non-consumable products (e.g., "remove ads", "premium features")
-   * - Do NOT set to true for subscriptions - they are managed automatically
-   * Note: On iOS, this flag doesn't affect behavior as StoreKit handles this automatically.
-   * On Android, consumables must be consumed to allow repurchase.
-   */
-  isConsumable?: boolean;
+export interface QuerygetTransactionJwsIOSArgs {
+  transactionId: string;
 }
 
-// ============================================================================
-// IAP CONTEXT INTERFACE
-// ============================================================================
+export interface QueryhasActiveSubscriptionsArgs {
+  subscriptionIds?: string[] | null;
+}
 
-/**
- * Main IAP context interface providing all in-app purchase functionality
- */
-export interface IapContext {
-  /** Current list of available products */
-  products: Product[];
-  /** Current list of available subscription products */
-  subscriptions: SubscriptionProduct[];
-  /**
-   * List of available purchases (includes all types):
-   * - Consumables: Not yet consumed/finished
-   * - Non-consumables: Not yet finished
-   * - Subscriptions: Currently active
-   */
-  availablePurchases: Purchase[];
-  /** Currently promoted product (iOS only) */
-  promotedProduct?: Product;
-  /** Current purchase being processed */
-  currentPurchase?: Purchase;
-  /** Purchase error if any */
-  purchaseError?: PurchaseError;
-
-  // Connection methods
-  /** Initialize connection to the store */
-  initConnection(): Promise<boolean>;
-  /** End connection to the store */
-  endConnection(): Promise<boolean>;
-  /** Sync purchases (iOS only) */
-  sync(): Promise<void>;
-
-  // Product methods
-  /**
-   * Fetch products from the store
-   * @param params.skus - Array of product SKUs to fetch
-   * @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?: 'inapp' | 'subs' | 'all'; // Defaults to 'inapp'
-  }): Promise<Product[] | SubscriptionProduct[]>;
-
-  // Purchase methods
-  /**
-   * Request a purchase for products or subscriptions
-   * @param params.request - Platform-specific purchase parameters
-   * @param params.type - Type of purchase: 'inapp' for products or 'subs' for subscriptions
-   */
-  requestPurchase(params: {
-    request: RequestPurchaseProps | RequestSubscriptionProps;
-    type?: 'inapp' | 'subs'; // defaults to 'inapp'
-  }): Promise<Purchase | Purchase[] | void>;
-  /**
-   * Finish a transaction and consume if applicable.
-   * IMPORTANT: Every purchase must be finished to complete the transaction.
-   * - For consumables: Set isConsumable=true to allow repurchase
-   * - For non-consumables & subscriptions: Set isConsumable=false or omit
-   */
-  finishTransaction(
-    params: FinishTransactionParams,
-  ): Promise<PurchaseResult | boolean>;
-
-  // Purchase history methods
-  /**
-   * Get all available purchases for the current user.
-   * Returns:
-   * - Consumables that haven't been consumed (finished with isConsumable=true)
-   * - Non-consumables that haven't been finished
-   * - Active subscriptions
-   */
-  getAvailablePurchases(options?: PurchaseOptions): Promise<Purchase[]>;
-
-  // Receipt validation
-  /** Validate a receipt (server-side validation recommended) */
-  validateReceipt(
-    sku: string,
-    androidOptions?: {
-      packageName: string;
-      productToken: string;
-      accessToken: string;
-      isSub?: boolean;
-    },
-  ): Promise<ReceiptValidationResult>;
-}
-
-/**
- * Purchase error type
- */
-export interface PurchaseError {
-  /** Error code constant */
-  code: string;
-  /** Human-readable error message */
-  message: string;
-  /** Related product SKU */
-  productId?: string;
+export interface QueryisEligibleForIntroOfferIOSArgs {
+  productIds: string[];
+}
+
+export interface QueryisTransactionVerifiedIOSArgs {
+  transactionId: string;
+}
+
+export interface QuerylatestTransactionIOSArgs {
+  sku: string;
+}
+
+export interface QuerysubscriptionStatusIOSArgs {
+  skus?: string[] | null;
+}
+
+export interface ReceiptValidationAndroidOptions {
+  accessToken: string;
+  isSub?: boolean | null;
+  packageName: string;
+  productToken: string;
 }
 
-/**
- * Validation options for receipt validation
- */
 export interface ReceiptValidationProps {
+  /** Android-specific validation options */
+  androidOptions?: ReceiptValidationAndroidOptions | null;
   /** Product SKU to validate */
   sku: string;
-  /** Android-specific validation options */
-  androidOptions?: {
-    packageName: string;
-    productToken: string;
-    accessToken: string;
-    isSub?: boolean;
-  };
 }
 
-/**
- * iOS receipt validation result
- */
-export interface ReceiptValidationResultIOS {
-  /** Whether the receipt is valid */
-  isValid: boolean;
-  /** Receipt data string */
-  receiptData: string;
-  /** JWS representation */
-  jwsRepresentation: string;
-  /** Latest transaction if available */
-  latestTransaction?: Purchase;
-}
+export type ReceiptValidationResult =
+  | ReceiptValidationResultAndroid
+  | ReceiptValidationResultIOS;
 
-/**
- * Android receipt validation result
- */
 export interface ReceiptValidationResultAndroid {
   autoRenewing: boolean;
   betaProduct: boolean;
-  cancelDate: number | null;
-  cancelReason: string;
-  deferredDate: number | null;
-  deferredSku: number | null;
+  cancelDate?: number | null;
+  cancelReason?: string | null;
+  deferredDate?: number | null;
+  deferredSku?: number | null;
   freeTrialEndDate: number;
   gracePeriodEndDate: number;
   parentProductId: string;
   productId: string;
-  productType: 'inapp' | 'subs';
+  productType: string;
   purchaseDate: number;
   quantity: number;
   receiptId: string;
@@ -669,35 +587,152 @@ export interface ReceiptValidationResultAndroid {
   testTransaction: boolean;
 }
 
-/**
- * Receipt validation result from receipt validation
- */
-export type ReceiptValidationResult =
-  | ReceiptValidationResultAndroid
-  | ReceiptValidationResultIOS;
+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;
+}
 
-/**
- * Represents an active subscription with platform-specific details
- */
-export interface ActiveSubscription {
-  /** Product identifier (SKU) of the subscription */
-  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;
-  /** @deprecated Use the common `isAutoRenewing` field instead */
-  autoRenewingAndroid?: boolean;
-  /** iOS: Environment where the subscription was purchased (Production/Sandbox) */
-  environmentIOS?: string;
-  /** Whether the subscription will expire soon (typically within 7 days) */
-  willExpireSoon?: boolean;
-  /** iOS: Number of days until the subscription expires */
-  daysUntilExpirationIOS?: number;
+export interface RefundResultIOS {
+  message?: string | null;
+  status: string;
+}
+
+export interface RenewalInfoIOS {
+  autoRenewPreference?: string | null;
+  jsonRepresentation?: string | null;
+  willAutoRenew: boolean;
+}
+
+export interface RequestPurchaseAndroidProps {
+  /** Personalized offer flag */
+  isOfferPersonalized?: boolean | null;
+  /** Obfuscated account ID */
+  obfuscatedAccountIdAndroid?: string | null;
+  /** Obfuscated profile ID */
+  obfuscatedProfileIdAndroid?: string | null;
+  /** List of product SKUs */
+  skus: string[];
+}
+
+export interface RequestPurchaseIosProps {
+  /** Auto-finish transaction (dangerous) */
+  andDangerouslyFinishTransactionAutomatically?: boolean | null;
+  /** App account token for user tracking */
+  appAccountToken?: string | null;
+  /** Purchase quantity */
+  quantity?: number | null;
+  /** Product SKU */
+  sku: string;
+  /** Discount offer to apply */
+  withOffer?: DiscountOfferInputIOS | null;
+}
+
+export interface RequestPurchaseProps {
+  /** Android-specific purchase parameters */
+  android?: RequestPurchaseAndroidProps | null;
+  /** iOS-specific purchase parameters */
+  ios?: RequestPurchaseIosProps | null;
+}
+
+export interface RequestPurchasePropsByPlatforms {
+  /** Android-specific purchase parameters */
+  android?: RequestPurchaseAndroidProps | null;
+  /** iOS-specific purchase parameters */
+  ios?: RequestPurchaseIosProps | null;
+}
+
+export interface RequestPurchaseResult {
+  purchase?: Purchase | null;
+  purchases?: Purchase[] | null;
+}
+
+export interface RequestSubscriptionAndroidProps {
+  /** Personalized offer flag */
+  isOfferPersonalized?: boolean | null;
+  /** Obfuscated account ID */
+  obfuscatedAccountIdAndroid?: string | null;
+  /** Obfuscated profile ID */
+  obfuscatedProfileIdAndroid?: string | null;
+  /** Purchase token for upgrades/downgrades */
+  purchaseTokenAndroid?: string | null;
+  /** Replacement mode for subscription changes */
+  replacementModeAndroid?: number | null;
+  /** List of subscription SKUs */
+  skus: string[];
+  /** Subscription offers */
+  subscriptionOffers?: AndroidSubscriptionOfferInput[] | null;
+}
+
+export interface RequestSubscriptionIosProps {
+  andDangerouslyFinishTransactionAutomatically?: boolean | null;
+  appAccountToken?: string | null;
+  quantity?: number | null;
+  sku: string;
+  withOffer?: DiscountOfferInputIOS | null;
+}
+
+export interface RequestSubscriptionPropsByPlatforms {
+  /** Android-specific subscription parameters */
+  android?: RequestSubscriptionAndroidProps | null;
+  /** iOS-specific subscription parameters */
+  ios?: RequestPurchaseIosProps | null;
+}
+
+export interface Subscription {
+  /** Fires when the App Store surfaces a promoted product (iOS only) */
+  promotedProductIOS: string;
+  /** Fires when a purchase fails or is cancelled */
+  purchaseError: PurchaseError;
+  /** Fires when a purchase completes successfully or a pending purchase resolves */
+  purchaseUpdated: Purchase;
+}
+
+export interface SubscriptionInfoIOS {
+  introductoryOffer?: SubscriptionOfferIOS | null;
+  promotionalOffers?: SubscriptionOfferIOS[] | null;
+  subscriptionGroupId: string;
+  subscriptionPeriod: SubscriptionPeriodValueIOS;
+}
+
+export interface SubscriptionOfferIOS {
+  displayPrice: string;
+  id: string;
+  paymentMode: PaymentModeIOS;
+  period: SubscriptionPeriodValueIOS;
+  periodCount: number;
+  price: number;
+  type: SubscriptionOfferTypeIOS;
+}
+
+export enum SubscriptionOfferTypeIOS {
+  Introductory = 'INTRODUCTORY',
+  Promotional = 'PROMOTIONAL',
+}
+
+export enum SubscriptionPeriodIOS {
+  Day = 'DAY',
+  Empty = 'EMPTY',
+  Month = 'MONTH',
+  Week = 'WEEK',
+  Year = 'YEAR',
+}
+
+export interface SubscriptionPeriodValueIOS {
+  unit: SubscriptionPeriodIOS;
+  value: number;
+}
+
+export interface SubscriptionStatusIOS {
+  renewalInfo?: RenewalInfoIOS | null;
+  state: string;
+}
+
+export interface VoidResult {
+  success: boolean;
 }