react-native-iap 15.6.0 → 15.6.1

package/src/types.ts

@@ -1,6 +1,6 @@
 // ============================================================================
 // AUTO-GENERATED TYPES — DO NOT EDIT DIRECTLY
-// Run `npm run generate` after updating any *.graphql schema file.
+// Refresh this file with the generated-types workflow documented for your checkout.
 // ============================================================================
 
 export interface ActiveSubscription {
@@ -30,9 +30,9 @@ export interface ActiveSubscription {
   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.
+   * @deprecated iOS only - use daysUntilExpirationIOS instead. Scheduled for removal in OpenIAP 3.0.
    */
   willExpireSoon?: (boolean | null);
 }
@@ -90,8 +90,9 @@ export interface AdvancedCommerceRefundIOS {
 /**
  * Alternative billing mode for Android
  * Controls which billing system is used
- * @deprecated Use enableBillingProgramAndroid with BillingProgramAndroid instead.
- * Use USER_CHOICE_BILLING for user choice billing, EXTERNAL_OFFER for alternative only.
+ * Use the user-choice-billing program for user choice billing and external-offer
+ * for external digital-content offers.
+ * @deprecated Use enableBillingProgramAndroid with BillingProgramAndroid instead. Scheduled for removal in OpenIAP 3.0.
  */
 export type AlternativeBillingModeAndroid = 'none' | 'user-choice' | 'alternative-only';
 
@@ -327,8 +328,8 @@ export interface DiscountDisplayInfoAndroid {
 
 /**
  * Discount information returned from the store.
- * @deprecated Use the standardized SubscriptionOffer type instead for cross-platform compatibility.
- * @see https://openiap.dev/docs/types#subscription-offer
+ * @see https://openiap.dev/docs/types/subscription-offer
+ * @deprecated Use the standardized SubscriptionOffer type instead for cross-platform compatibility. Scheduled for removal in OpenIAP 3.0.
  */
 export interface DiscountIOS {
   identifier: string;
@@ -343,12 +344,13 @@ export interface DiscountIOS {
 
 /**
  * Standardized one-time product discount offer.
- * Provides a unified interface for one-time purchase discounts across platforms.
+ * Provides a platform-neutral OpenIAP shape for Google Play one-time product
+ * purchase options and offers.
  *
- * Currently supported on Android (Google Play Billing 8.0+).
- * iOS does not support one-time purchase discounts in the same way.
+ * Currently populated only on Android (Google Play Billing 8.0+).
+ * iOS does not populate this type.
  *
- * @see https://openiap.dev/docs/features/discount
+ * @see https://openiap.dev/docs/types/discount-offer
  */
 export interface DiscountOffer {
   /** Currency code (ISO 4217, e.g., "USD") */
@@ -360,7 +362,7 @@ export interface DiscountOffer {
   discountAmountMicrosAndroid?: (string | null);
   /** Formatted display price string (e.g., "$4.99") */
   displayPrice: string;
-  /** [Android] Formatted discount amount string (e.g., "$5.00 OFF"). */
+  /** [Android] Formatted discount amount including its currency sign (e.g., "$5.00"). */
   formattedDiscountAmountAndroid?: (string | null);
   /**
    * [Android] Original full price in micro-units before discount.
@@ -406,7 +408,11 @@ export interface DiscountOffer {
   purchaseOptionIdAndroid?: (string | null);
   /** [Android] Rental details if this is a rental offer. */
   rentalDetailsAndroid?: (RentalDetailsAndroid | null);
-  /** Type of discount offer */
+  /**
+   * Offer category. DiscountOffer currently represents Android one-time product
+   * offers and is populated as OneTime. Introductory and Promotional are used by
+   * SubscriptionOffer.
+   */
   type: DiscountOfferType;
   /**
    * [Android] Valid time window for the offer.
@@ -417,8 +423,8 @@ export interface DiscountOffer {
 
 /**
  * iOS DiscountOffer (output type).
- * @deprecated Use the standardized SubscriptionOffer type instead for cross-platform compatibility.
- * @see https://openiap.dev/docs/types#subscription-offer
+ * @see https://openiap.dev/docs/types/subscription-offer
+ * @deprecated Use the standardized SubscriptionOffer type instead for cross-platform compatibility. Scheduled for removal in OpenIAP 3.0.
  */
 export interface DiscountOfferIOS {
   /** Discount identifier */
@@ -484,8 +490,11 @@ export enum ErrorCode {
   PurchaseVerificationFinishFailed = 'purchase-verification-finish-failed',
   PurchaseVerificationFinished = 'purchase-verification-finished',
   QueryProduct = 'query-product',
+  /** @deprecated Use PurchaseVerificationFailed instead. Scheduled for removal in OpenIAP 3.0. */
   ReceiptFailed = 'receipt-failed',
+  /** @deprecated Use PurchaseVerificationFinished instead. Scheduled for removal in OpenIAP 3.0. */
   ReceiptFinished = 'receipt-finished',
+  /** @deprecated Use PurchaseVerificationFinishFailed instead. Scheduled for removal in OpenIAP 3.0. */
   ReceiptFinishedFailed = 'receipt-finished-failed',
   RemoteError = 'remote-error',
   ServiceDisconnected = 'service-disconnected',
@@ -517,8 +526,8 @@ export type ExternalLinkTypeAndroid = 'unspecified' | 'link-to-digital-content-o
 
 /**
  * External offer availability result (Android)
- * @deprecated Use BillingProgramAvailabilityResultAndroid with isBillingProgramAvailableAsync instead
  * Available in Google Play Billing Library 6.2.0+, deprecated in 8.2.0
+ * @deprecated Use BillingProgramAvailabilityResultAndroid from isBillingProgramAvailableAndroid instead. Scheduled for removal in OpenIAP 3.0.
  */
 export interface ExternalOfferAvailabilityResultAndroid {
   /** Whether external offers are available for the user */
@@ -527,8 +536,8 @@ export interface ExternalOfferAvailabilityResultAndroid {
 
 /**
  * External offer reporting details (Android)
- * @deprecated Use BillingProgramReportingDetailsAndroid with createBillingProgramReportingDetailsAsync instead
  * Available in Google Play Billing Library 6.2.0+, deprecated in 8.2.0
+ * @deprecated Use BillingProgramReportingDetailsAndroid from createBillingProgramReportingDetailsAndroid instead. Scheduled for removal in OpenIAP 3.0.
  */
 export interface ExternalOfferReportingDetailsAndroid {
   /** External transaction token for reporting external offer transactions */
@@ -675,8 +684,8 @@ export interface InitConnectionConfig {
   /**
    * Alternative billing mode for Android
    * If not specified, defaults to NONE (standard Google Play billing)
-   * @deprecated Use enableBillingProgramAndroid instead.
    * Use USER_CHOICE_BILLING for user choice billing, EXTERNAL_OFFER for alternative only.
+   * @deprecated Use enableBillingProgramAndroid instead. Scheduled for removal in OpenIAP 3.0.
    */
   alternativeBillingModeAndroid?: (AlternativeBillingModeAndroid | null);
   /**
@@ -773,6 +782,7 @@ export interface Mutation {
    * Returns true if available, false otherwise.
    * Throws OpenIapError.NotPrepared if billing client not ready.
    * See: https://openiap.dev/docs/apis/android/check-alternative-billing-availability-android
+   * @deprecated Use isBillingProgramAvailableAndroid with the external-offer BillingProgramAndroid value instead. Scheduled for removal in OpenIAP 3.0.
    */
   checkAlternativeBillingAvailabilityAndroid: Promise<boolean>;
   /**
@@ -792,6 +802,7 @@ export interface Mutation {
    * Returns token string, or null if creation failed.
    * Throws OpenIapError.NotPrepared if billing client not ready.
    * See: https://openiap.dev/docs/apis/android/create-alternative-billing-token-android
+   * @deprecated Use createBillingProgramReportingDetailsAndroid with the external-offer BillingProgramAndroid value instead. Scheduled for removal in OpenIAP 3.0.
    */
   createAlternativeBillingTokenAndroid?: Promise<(string | null)>;
   /**
@@ -859,7 +870,7 @@ export interface Mutation {
    * purchase while the app is running with an active billing connection; always
    * reconcile with getAvailablePurchases when the app resumes.
    * Does not require the billing client to be initialized (no Play Billing version requirement).
-   * Planned OpenIAP availability: Spec 2.5.0 / openiap-google 2.5.0.
+   * Available in OpenIAP Spec 2.4.2 / openiap-google 2.5.0.
    * Android counterpart of presentCodeRedemptionSheetIOS.
    * Returns true when the redemption flow was launched, or false when the current
    * store flavor does not provide an equivalent redemption flow.
@@ -891,11 +902,8 @@ export interface Mutation {
   /**
    * Buy the currently promoted product.
    *
-   * @deprecated Use promotedProductListenerIOS to receive the productId,
-   * then call requestPurchase with that SKU instead. In StoreKit 2,
-   * promoted products can be purchased directly via the standard purchase flow.
    * See: https://openiap.dev/docs/apis/ios/request-purchase-on-promoted-product-ios
-   * @deprecated Use promotedProductListenerIOS + requestPurchase instead
+   * @deprecated Use the promoted-product listener or callback exposed by your SDK to receive the productId, then call requestPurchase with that SKU instead. In StoreKit 2, promoted products can be purchased directly via the standard purchase flow. Scheduled for removal in OpenIAP 3.0.
    */
   requestPurchaseOnPromotedProductIOS: Promise<boolean>;
   /**
@@ -909,6 +917,7 @@ export interface Mutation {
    * Returns true if user accepted, false if user canceled.
    * Throws OpenIapError.NotPrepared if billing client not ready.
    * See: https://openiap.dev/docs/apis/android/show-alternative-billing-dialog-android
+   * @deprecated Use launchExternalLinkAndroid instead. Scheduled for removal in OpenIAP 3.0.
    */
   showAlternativeBillingDialogAndroid: Promise<boolean>;
   /**
@@ -948,7 +957,7 @@ export interface Mutation {
   /**
    * Deprecated. Validate purchase receipts with the configured providers — use verifyPurchase instead.
    * See: https://openiap.dev/docs/features/validation#verify-purchase
-   * @deprecated Use verifyPurchase
+   * @deprecated Use verifyPurchase. Scheduled for removal in OpenIAP 3.0.
    */
   validateReceipt: Promise<VerifyPurchaseResult>;
   /**
@@ -969,8 +978,6 @@ export interface Mutation {
   verifyPurchaseWithProvider: Promise<VerifyPurchaseWithProviderResult>;
 }
 
-
-
 export type MutationAcknowledgePurchaseAndroidArgs = string;
 
 export type MutationBeginRefundRequestIosArgs = string;
@@ -982,7 +989,6 @@ export interface MutationCreateBillingProgramReportingDetailsAndroidArgs {
   program: BillingProgramAndroid;
 }
 
-
 export type MutationDeepLinkToSubscriptionsArgs = (DeepLinkOptions | null) | undefined;
 
 export interface MutationFinishTransactionArgs {
@@ -990,7 +996,6 @@ export interface MutationFinishTransactionArgs {
   purchase: PurchaseInput;
 }
 
-
 export type MutationInitConnectionArgs = (InitConnectionConfig | null) | undefined;
 
 export type MutationIsBillingProgramAvailableAndroidArgs = BillingProgramAndroid;
@@ -999,22 +1004,7 @@ export type MutationLaunchExternalLinkAndroidArgs = LaunchExternalLinkParamsAndr
 
 export type MutationPresentExternalPurchaseLinkIosArgs = string;
 
-export type MutationRequestPurchaseArgs =
-  | {
-      /** Per-platform purchase request props */
-      request: RequestPurchasePropsByPlatforms;
-      type: 'in-app';
-      /** Use alternative billing (Google Play alternative billing, Apple external purchase link) */
-      useAlternativeBilling?: boolean | null;
-    }
-  | {
-      /** Per-platform subscription request props */
-      request: RequestSubscriptionPropsByPlatforms;
-      type: 'subs';
-      /** Use alternative billing (Google Play alternative billing, Apple external purchase link) */
-      useAlternativeBilling?: boolean | null;
-    };
-
+export type MutationRequestPurchaseArgs = RequestPurchaseProps;
 
 export type MutationShowBillingProgramInformationDialogAndroidArgs = BillingProgramInformationDialogParamsAndroid;
 
@@ -1093,9 +1083,9 @@ export interface ProductAndroid extends ProductCommon {
   debugDescription?: (string | null);
   description: string;
   /**
-   * Standardized discount offers for one-time products.
-   * Cross-platform type with Android-specific fields using suffix.
-   * @see https://openiap.dev/docs/types#discount-offer
+   * Standardized Android one-time product purchase options and offers.
+   * Native metadata uses Android-suffixed fields.
+   * @see https://openiap.dev/docs/types/discount-offer
    */
   discountOffers?: (DiscountOffer[] | null);
   displayName?: (string | null);
@@ -1105,8 +1095,7 @@ export interface ProductAndroid extends ProductCommon {
   /**
    * One-time purchase offer details including discounts (Android)
    * Returns all eligible offers. Available in Google Play Billing Library 8.0+
-   * @deprecated Use discountOffers instead for cross-platform compatibility.
-   * @deprecated Use discountOffers instead
+   * @deprecated Use the standardized discountOffers field instead. Scheduled for removal in OpenIAP 3.0.
    */
   oneTimePurchaseOfferDetailsAndroid?: (ProductAndroidOneTimePurchaseOfferDetail[] | null);
   platform: 'android';
@@ -1119,15 +1108,12 @@ export interface ProductAndroid extends ProductCommon {
    * Available in Google Play Billing Library 8.0.0+
    */
   productStatusAndroid?: (ProductStatusAndroid | null);
-  /**
-   * @deprecated Use subscriptionOffers instead for cross-platform compatibility.
-   * @deprecated Use subscriptionOffers instead
-   */
+  /** @deprecated Use subscriptionOffers instead for cross-platform compatibility. Scheduled for removal in OpenIAP 3.0. */
   subscriptionOfferDetailsAndroid?: (ProductSubscriptionAndroidOfferDetails[] | null);
   /**
    * Standardized subscription offers.
    * Cross-platform type with Android-specific fields using suffix.
-   * @see https://openiap.dev/docs/types#subscription-offer
+   * @see https://openiap.dev/docs/types/subscription-offer
    */
   subscriptionOffers?: (SubscriptionOffer[] | null);
   title: string;
@@ -1137,8 +1123,8 @@ export interface ProductAndroid extends ProductCommon {
 /**
  * One-time purchase offer details (Android).
  * Available in Google Play Billing Library 8.0+
- * @deprecated Use the standardized DiscountOffer type instead for cross-platform compatibility.
- * @see https://openiap.dev/docs/types#discount-offer
+ * @see https://openiap.dev/docs/types/discount-offer
+ * @deprecated Use the standardized DiscountOffer type for Android one-time offers. Scheduled for removal in OpenIAP 3.0.
  */
 export interface ProductAndroidOneTimePurchaseOfferDetail {
   /**
@@ -1209,16 +1195,13 @@ export interface ProductIOS extends ProductCommon {
    * monthly subscriptions with a 12-month commitment.
    */
   pricingTermsIOS?: (SubscriptionPricingTermsIOS[] | null);
-  /**
-   * @deprecated Use subscriptionOffers instead for cross-platform compatibility.
-   * @deprecated Use subscriptionOffers instead
-   */
+  /** @deprecated Use subscriptionOffers instead for cross-platform compatibility. Scheduled for removal in OpenIAP 3.0. */
   subscriptionInfoIOS?: (SubscriptionInfoIOS | null);
   /**
    * Standardized subscription offers.
    * Cross-platform type with iOS-specific fields using suffix.
    * Note: iOS does not support one-time product discounts.
-   * @see https://openiap.dev/docs/types#subscription-offer
+   * @see https://openiap.dev/docs/types/subscription-offer
    */
   subscriptionOffers?: (SubscriptionOffer[] | null);
   title: string;
@@ -1250,9 +1233,8 @@ export interface ProductSubscriptionAndroid extends ProductCommon {
   debugDescription?: (string | null);
   description: string;
   /**
-   * Standardized discount offers for one-time products.
-   * Cross-platform type with Android-specific fields using suffix.
-   * @see https://openiap.dev/docs/types#discount-offer
+   * Nullable compatibility field. Google Play does not return one-time purchase
+   * offer details for subscription products; use subscriptionOffers below.
    */
   discountOffers?: (DiscountOffer[] | null);
   displayName?: (string | null);
@@ -1260,10 +1242,9 @@ export interface ProductSubscriptionAndroid extends ProductCommon {
   id: string;
   nameAndroid: string;
   /**
-   * One-time purchase offer details including discounts (Android)
-   * Returns all eligible offers. Available in Google Play Billing Library 8.0+
-   * @deprecated Use discountOffers instead for cross-platform compatibility.
-   * @deprecated Use discountOffers instead
+   * Legacy nullable compatibility field. Google Play does not populate one-time
+   * purchase offer details for subscription products.
+   * @deprecated One-time offers belong to ProductAndroid.discountOffers; subscriptions use subscriptionOffers. Scheduled for removal in OpenIAP 3.0.
    */
   oneTimePurchaseOfferDetailsAndroid?: (ProductAndroidOneTimePurchaseOfferDetail[] | null);
   platform: 'android';
@@ -1276,15 +1257,12 @@ export interface ProductSubscriptionAndroid extends ProductCommon {
    * Available in Google Play Billing Library 8.0.0+
    */
   productStatusAndroid?: (ProductStatusAndroid | null);
-  /**
-   * @deprecated Use subscriptionOffers instead for cross-platform compatibility.
-   * @deprecated Use subscriptionOffers instead
-   */
+  /** @deprecated Use subscriptionOffers instead for cross-platform compatibility. Scheduled for removal in OpenIAP 3.0. */
   subscriptionOfferDetailsAndroid: ProductSubscriptionAndroidOfferDetails[];
   /**
    * Standardized subscription offers.
    * Cross-platform type with Android-specific fields using suffix.
-   * @see https://openiap.dev/docs/types#subscription-offer
+   * @see https://openiap.dev/docs/types/subscription-offer
    */
   subscriptionOffers: SubscriptionOffer[];
   title: string;
@@ -1293,8 +1271,8 @@ export interface ProductSubscriptionAndroid extends ProductCommon {
 
 /**
  * Subscription offer details (Android).
- * @deprecated Use the standardized SubscriptionOffer type instead for cross-platform compatibility.
- * @see https://openiap.dev/docs/types#subscription-offer
+ * @see https://openiap.dev/docs/types/subscription-offer
+ * @deprecated Use the standardized SubscriptionOffer type instead for cross-platform compatibility. Scheduled for removal in OpenIAP 3.0.
  */
 export interface ProductSubscriptionAndroidOfferDetails {
   basePlanId: string;
@@ -1314,10 +1292,7 @@ export interface ProductSubscriptionIOS extends ProductCommon {
   currency: string;
   debugDescription?: (string | null);
   description: string;
-  /**
-   * @deprecated Use subscriptionOffers instead for cross-platform compatibility.
-   * @deprecated Use subscriptionOffers instead
-   */
+  /** @deprecated Use subscriptionOffers instead for cross-platform compatibility. Scheduled for removal in OpenIAP 3.0. */
   discountsIOS?: (DiscountIOS[] | null);
   displayName?: (string | null);
   displayNameIOS: string;
@@ -1339,15 +1314,12 @@ export interface ProductSubscriptionIOS extends ProductCommon {
   pricingTermsIOS?: (SubscriptionPricingTermsIOS[] | null);
   /** App Store subscription group identifier for intro-offer eligibility checks. */
   subscriptionGroupIdIOS?: (string | null);
-  /**
-   * @deprecated Use subscriptionOffers for offer metadata and subscriptionGroupIdIOS for the App Store subscription group identifier.
-   * @deprecated Use subscriptionOffers for offers and subscriptionGroupIdIOS for group ID
-   */
+  /** @deprecated Use subscriptionOffers for offer metadata and subscriptionGroupIdIOS for the App Store subscription group identifier. Scheduled for removal in OpenIAP 3.0. */
   subscriptionInfoIOS?: (SubscriptionInfoIOS | null);
   /**
    * Standardized subscription offers.
    * Cross-platform type with iOS-specific fields using suffix.
-   * @see https://openiap.dev/docs/types#subscription-offer
+   * @see https://openiap.dev/docs/types/subscription-offer
    */
   subscriptionOffers?: (SubscriptionOffer[] | null);
   subscriptionPeriodNumberIOS?: (string | null);
@@ -1407,7 +1379,7 @@ export interface PurchaseAndroid extends PurchaseCommon {
    * Available in Google Play Billing Library 5.0+
    */
   pendingPurchaseUpdateAndroid?: (PendingPurchaseUpdateAndroid | null);
-  /** @deprecated Use store instead */
+  /** @deprecated Use store instead. Scheduled for removal in OpenIAP 3.0. */
   platform: IapPlatform;
   productId: string;
   purchaseState: PurchaseState;
@@ -1432,7 +1404,7 @@ export interface PurchaseCommon {
   id: string;
   ids?: (string[] | null);
   isAutoRenewing: boolean;
-  /** @deprecated Use store instead */
+  /** @deprecated Use store instead. Scheduled for removal in OpenIAP 3.0. */
   platform: IapPlatform;
   productId: string;
   purchaseState: PurchaseState;
@@ -1484,7 +1456,7 @@ export interface PurchaseIOS extends PurchaseCommon {
   originalTransactionDateIOS?: (number | null);
   originalTransactionIdentifierIOS?: (string | null);
   ownershipTypeIOS?: (string | null);
-  /** @deprecated Use store instead */
+  /** @deprecated Use store instead. Scheduled for removal in OpenIAP 3.0. */
   platform: IapPlatform;
   productId: string;
   purchaseState: PurchaseState;
@@ -1622,7 +1594,7 @@ export interface Query {
    * Deprecated. Get the current App Store storefront ISO 3166-1 alpha-3 country
    * code — use cross-platform getStorefront instead.
    * See: https://openiap.dev/docs/apis/ios/get-storefront-ios
-   * @deprecated Use getStorefront
+   * @deprecated Use getStorefront. Scheduled for removal in OpenIAP 3.0.
    */
   getStorefrontIOS: Promise<string>;
   /**
@@ -1665,13 +1637,11 @@ export interface Query {
   /**
    * Deprecated. Legacy App Store receipt validation — use verifyPurchase instead.
    * See: https://openiap.dev/docs/apis/ios/validate-receipt-ios
-   * @deprecated Use verifyPurchase
+   * @deprecated Use verifyPurchase. Scheduled for removal in OpenIAP 3.0.
    */
   validateReceiptIOS: Promise<VerifyPurchaseResultIOS>;
 }
 
-
-
 export type QueryCurrentEntitlementIosArgs = string;
 
 export type QueryFetchProductsArgs = ProductRequest;
@@ -1832,15 +1802,23 @@ export type RequestPurchaseProps =
   | {
       /** Per-platform purchase request props */
       request: RequestPurchasePropsByPlatforms;
+      /** Explicit purchase type hint (defaults to in-app) */
       type: 'in-app';
-      /** Use alternative billing (Google Play alternative billing, Apple external purchase link) */
+      /**
+       * This flag only logs debug info and has no effect on the purchase flow.
+       * @deprecated Use enableBillingProgramAndroid in InitConnectionConfig instead. Scheduled for removal in OpenIAP 3.0.
+       */
       useAlternativeBilling?: boolean | null;
     }
   | {
       /** Per-platform subscription request props */
       request: RequestSubscriptionPropsByPlatforms;
+      /** Explicit purchase type hint (defaults to in-app) */
       type: 'subs';
-      /** Use alternative billing (Google Play alternative billing, Apple external purchase link) */
+      /**
+       * This flag only logs debug info and has no effect on the purchase flow.
+       * @deprecated Use enableBillingProgramAndroid in InitConnectionConfig instead. Scheduled for removal in OpenIAP 3.0.
+       */
       useAlternativeBilling?: boolean | null;
     };
 
@@ -1854,13 +1832,13 @@ export type RequestPurchaseProps =
  *   (determined at build time, not runtime)
  */
 export interface RequestPurchasePropsByPlatforms {
-  /** @deprecated Use google instead */
+  /** @deprecated Use google instead. Scheduled for removal in OpenIAP 3.0. */
   android?: (RequestPurchaseAndroidProps | null);
   /** Apple-specific purchase parameters */
   apple?: (RequestPurchaseIosProps | null);
   /** Google-specific purchase parameters */
   google?: (RequestPurchaseAndroidProps | null);
-  /** @deprecated Use apple instead */
+  /** @deprecated Use apple instead. Scheduled for removal in OpenIAP 3.0. */
   ios?: (RequestPurchaseIosProps | null);
 }
 
@@ -1892,7 +1870,7 @@ export interface RequestSubscriptionAndroidProps {
   purchaseToken?: (string | null);
   /**
    * Replacement mode for subscription changes
-   * @deprecated Use subscriptionProductReplacementParams instead for item-level replacement (8.1.0+)
+   * @deprecated Use subscriptionProductReplacementParams instead for item-level replacement (8.1.0+). Scheduled for removal in OpenIAP 3.0.
    */
   replacementMode?: (number | null);
   /** List of subscription SKUs */
@@ -1963,13 +1941,13 @@ export interface RequestSubscriptionIosProps {
  *   (determined at build time, not runtime)
  */
 export interface RequestSubscriptionPropsByPlatforms {
-  /** @deprecated Use google instead */
+  /** @deprecated Use google instead. Scheduled for removal in OpenIAP 3.0. */
   android?: (RequestSubscriptionAndroidProps | null);
   /** Apple-specific subscription parameters */
   apple?: (RequestSubscriptionIosProps | null);
   /** Google-specific subscription parameters */
   google?: (RequestSubscriptionAndroidProps | null);
-  /** @deprecated Use apple instead */
+  /** @deprecated Use apple instead. Scheduled for removal in OpenIAP 3.0. */
   ios?: (RequestSubscriptionIosProps | null);
 }
 
@@ -2098,8 +2076,6 @@ export interface Subscription {
   userChoiceBillingAndroid: UserChoiceBillingDetails;
 }
 
-
-
 export type SubscriptionPurchaseUpdatedArgs = (PurchaseUpdatedListenerOptions | null) | undefined;
 
 export type SubscriptionBillingPlanTypeIOS = 'unknown' | 'monthly' | 'up-front';
@@ -2126,8 +2102,7 @@ export interface SubscriptionInfoIOS {
  * - iOS: Introductory offers, promotional offers with server-side signatures
  * - Android: Offer tokens with pricing phases
  *
- * @see https://openiap.dev/docs/types/ios#discount-offer
- * @see https://openiap.dev/docs/types/android#subscription-offer
+ * @see https://openiap.dev/docs/types/subscription-offer
  */
 export interface SubscriptionOffer {
   /**
@@ -2201,8 +2176,8 @@ export interface SubscriptionOffer {
 
 /**
  * iOS subscription offer details.
- * @deprecated Use the standardized SubscriptionOffer type instead for cross-platform compatibility.
- * @see https://openiap.dev/docs/types#subscription-offer
+ * @see https://openiap.dev/docs/types/subscription-offer
+ * @deprecated Use the standardized SubscriptionOffer type instead for cross-platform compatibility. Scheduled for removal in OpenIAP 3.0.
  */
 export interface SubscriptionOfferIOS {
   displayPrice: string;
@@ -2262,8 +2237,6 @@ export interface SubscriptionProductReplacementParamsAndroid {
  */
 export type SubscriptionReplacementModeAndroid = 'unknown-replacement-mode' | 'with-time-proration' | 'charge-prorated-price' | 'charge-full-price' | 'without-proration' | 'deferred' | 'keep-existing';
 
-export type SubscriptionState = 'active' | 'expired' | 'in-billing-retry' | 'in-grace-period' | 'paused' | 'refunded' | 'revoked' | 'unknown';
-
 export interface SubscriptionStatusIOS {
   renewalInfo?: (RenewalInfoIOS | null);
   state: string;
@@ -2445,67 +2418,6 @@ export interface VerifyPurchaseWithProviderResult {
 
 export type VoidResult = void;
 
-export type WebhookCancellationReason = 'billing-error' | 'other' | 'price-increase-declined' | 'product-unavailable' | 'refunded' | 'user-canceled';
-
-export interface WebhookEvent {
-  /** Reason for cancellation, when applicable. */
-  cancellationReason?: (WebhookCancellationReason | null);
-  /** Localized currency code (ISO 4217) at event time, when available. */
-  currency?: (string | null);
-  environment: WebhookEventEnvironment;
-  /** When the current subscription period ends. Epoch milliseconds. */
-  expiresAt?: (number | null);
-  /**
-   * Stable identifier suitable for idempotency. Derived from the source notification
-   * UUID where the store provides one (ASN v2 `notificationUUID`, RTDN message id);
-   * otherwise hashed from the canonicalized payload.
-   */
-  id: string;
-  /** Time the underlying event occurred at the store. Epoch milliseconds. */
-  occurredAt: number;
-  platform: IapPlatform;
-  /**
-   * Price in micros (1/1,000,000 of the currency unit) at event time, when available.
-   * Matches Google Play's `priceAmountMicros` convention; iOS values are converted.
-   */
-  priceAmountMicros?: (number | null);
-  /** Product the event pertains to. May be null for account-level events. */
-  productId?: (string | null);
-  /** kit project that owns the subscription / purchase this event refers to. */
-  projectId: string;
-  /**
-   * Cross-platform purchase identity used to correlate this event with an existing
-   * purchase record. iOS: `originalTransactionId`. Android: `purchaseToken`.
-   * Null for `TestNotification` events (Apple ASN v2 / Google RTDN test
-   * payloads carry no transaction); always present for every other event type.
-   */
-  purchaseToken?: (string | null);
-  /**
-   * Original signed payload from the store. ASN v2 events expose the JWS string;
-   * RTDN events expose the base64-decoded Pub/Sub message JSON. Provided so that
-   * consumers can independently verify or extract platform-specific fields. kit
-   * always validates this payload before emitting the event.
-   */
-  rawSignedPayload?: (string | null);
-  /** Time kit ingested and normalized this event. Epoch milliseconds. */
-  receivedAt: number;
-  /** When auto-renewal will charge again. Epoch milliseconds. */
-  renewsAt?: (number | null);
-  source: WebhookEventSource;
-  /**
-   * Normalized subscription state at the time of event, when the event refers to
-   * a subscription. Null for one-time purchase events.
-   */
-  subscriptionState?: (SubscriptionState | null);
-  type: WebhookEventType;
-}
-
-export type WebhookEventEnvironment = 'production' | 'sandbox' | 'xcode';
-
-export type WebhookEventSource = 'apple-app-store-server-notifications-v2' | 'google-play-real-time-developer-notifications' | 'meta-horizon-reconciler';
-
-export type WebhookEventType = 'purchase-consumption-request' | 'purchase-refunded' | 'subscription-canceled' | 'subscription-expired' | 'subscription-in-billing-retry' | 'subscription-in-grace-period' | 'subscription-paused' | 'subscription-price-change' | 'subscription-product-changed' | 'subscription-recovered' | 'subscription-renewed' | 'subscription-resumed' | 'subscription-revoked' | 'subscription-started' | 'subscription-uncanceled' | 'test-notification';
-
 /**
  * Win-back offer input for iOS 18+ (StoreKit 2)
  * Win-back offers are used to re-engage churned subscribers.
@@ -2516,44 +2428,6 @@ export interface WinBackOfferInputIOS {
   /** The win-back offer ID from App Store Connect */
   offerId: string;
 }
-// -- Query helper types (auto-generated)
-export type QueryArgsMap = {
-  canPresentExternalPurchaseNoticeIOS: never;
-  currentEntitlementIOS: QueryCurrentEntitlementIosArgs;
-  fetchProducts: QueryFetchProductsArgs;
-  getActiveSubscriptions: QueryGetActiveSubscriptionsArgs;
-  getAllTransactionsIOS: never;
-  getAppTransactionIOS: never;
-  getAvailablePurchases: QueryGetAvailablePurchasesArgs;
-  getBillingChoiceInfoAndroid: QueryGetBillingChoiceInfoAndroidArgs;
-  getExternalPurchaseCustomLinkTokenIOS: QueryGetExternalPurchaseCustomLinkTokenIosArgs;
-  getPendingTransactionsIOS: never;
-  getPromotedProductIOS: never;
-  getReceiptDataIOS: never;
-  getStorefront: never;
-  getStorefrontIOS: never;
-  getTransactionJwsIOS: QueryGetTransactionJwsIosArgs;
-  hasActiveSubscriptions: QueryHasActiveSubscriptionsArgs;
-  isEligibleForExternalPurchaseCustomLinkIOS: never;
-  isEligibleForIntroOfferIOS: QueryIsEligibleForIntroOfferIosArgs;
-  isTransactionVerifiedIOS: QueryIsTransactionVerifiedIosArgs;
-  latestTransactionIOS: QueryLatestTransactionIosArgs;
-  subscriptionStatusIOS: QuerySubscriptionStatusIosArgs;
-  validateReceiptIOS: QueryValidateReceiptIosArgs;
-};
-
-export type QueryField<K extends keyof Query> =
-  QueryArgsMap[K] extends never
-    ? () => NonNullable<Query[K]>
-    : undefined extends QueryArgsMap[K]
-      ? (args?: QueryArgsMap[K]) => NonNullable<Query[K]>
-      : (args: QueryArgsMap[K]) => NonNullable<Query[K]>;
-
-export type QueryFieldMap = {
-  [K in keyof Query]?: QueryField<K>;
-};
-// -- End query helper types
-
 // -- Mutation helper types (auto-generated)
 export type MutationArgsMap = {
   acknowledgePurchaseAndroid: MutationAcknowledgePurchaseAndroidArgs;
@@ -2599,6 +2473,44 @@ export type MutationFieldMap = {
 };
 // -- End mutation helper types
 
+// -- Query helper types (auto-generated)
+export type QueryArgsMap = {
+  canPresentExternalPurchaseNoticeIOS: never;
+  currentEntitlementIOS: QueryCurrentEntitlementIosArgs;
+  fetchProducts: QueryFetchProductsArgs;
+  getActiveSubscriptions: QueryGetActiveSubscriptionsArgs;
+  getAllTransactionsIOS: never;
+  getAppTransactionIOS: never;
+  getAvailablePurchases: QueryGetAvailablePurchasesArgs;
+  getBillingChoiceInfoAndroid: QueryGetBillingChoiceInfoAndroidArgs;
+  getExternalPurchaseCustomLinkTokenIOS: QueryGetExternalPurchaseCustomLinkTokenIosArgs;
+  getPendingTransactionsIOS: never;
+  getPromotedProductIOS: never;
+  getReceiptDataIOS: never;
+  getStorefront: never;
+  getStorefrontIOS: never;
+  getTransactionJwsIOS: QueryGetTransactionJwsIosArgs;
+  hasActiveSubscriptions: QueryHasActiveSubscriptionsArgs;
+  isEligibleForExternalPurchaseCustomLinkIOS: never;
+  isEligibleForIntroOfferIOS: QueryIsEligibleForIntroOfferIosArgs;
+  isTransactionVerifiedIOS: QueryIsTransactionVerifiedIosArgs;
+  latestTransactionIOS: QueryLatestTransactionIosArgs;
+  subscriptionStatusIOS: QuerySubscriptionStatusIosArgs;
+  validateReceiptIOS: QueryValidateReceiptIosArgs;
+};
+
+export type QueryField<K extends keyof Query> =
+  QueryArgsMap[K] extends never
+    ? () => NonNullable<Query[K]>
+    : undefined extends QueryArgsMap[K]
+      ? (args?: QueryArgsMap[K]) => NonNullable<Query[K]>
+      : (args: QueryArgsMap[K]) => NonNullable<Query[K]>;
+
+export type QueryFieldMap = {
+  [K in keyof Query]?: QueryField<K>;
+};
+// -- End query helper types
+
 // -- Subscription helper types (auto-generated)
 export type SubscriptionArgsMap = {
   developerProvidedBillingAndroid: never;