react-native-iap 14.7.6 → 14.7.8

package/src/index.ts

@@ -17,6 +17,11 @@ import {ErrorCode} from './types';
 import type {
   AndroidSubscriptionOfferInput,
   DiscountOfferInputIOS,
+  ExternalPurchaseCustomLinkNoticeResultIOS,
+  ExternalPurchaseCustomLinkNoticeTypeIOS,
+  ExternalPurchaseCustomLinkTokenResultIOS,
+  ExternalPurchaseCustomLinkTokenTypeIOS,
+  ExternalPurchaseNoticeResultIOS,
   FetchProductsResult,
   MutationField,
   Product,
@@ -2590,22 +2595,21 @@ export const canPresentExternalPurchaseNoticeIOS: QueryField<
  * }
  * ```
  */
-export const presentExternalPurchaseNoticeSheetIOS: MutationField<
-  'presentExternalPurchaseNoticeSheetIOS'
-> = async () => {
-  if (Platform.OS !== 'ios') {
-    throw new Error('External purchase is only supported on iOS');
-  }
-  try {
-    return (await IAP.instance.presentExternalPurchaseNoticeSheetIOS()) as any;
-  } catch (error) {
-    RnIapConsole.error(
-      'Failed to present external purchase notice sheet:',
-      error,
-    );
-    throw error;
-  }
-};
+export const presentExternalPurchaseNoticeSheetIOS =
+  async (): Promise<ExternalPurchaseNoticeResultIOS> => {
+    if (Platform.OS !== 'ios') {
+      throw new Error('External purchase is only supported on iOS');
+    }
+    try {
+      return await IAP.instance.presentExternalPurchaseNoticeSheetIOS();
+    } catch (error) {
+      RnIapConsole.error(
+        'Failed to present external purchase notice sheet:',
+        error,
+      );
+      throw error;
+    }
+  };
 
 /**
  * Present an external purchase link to redirect users to your website (iOS 16.0+).
@@ -2635,3 +2639,117 @@ export const presentExternalPurchaseLinkIOS: MutationField<
     throw error;
   }
 };
+
+// ╔════════════════════════════════════════════════════════════════════════╗
+// ║            EXTERNAL PURCHASE CUSTOM LINK (iOS 18.1+)                   ║
+// ╚════════════════════════════════════════════════════════════════════════╝
+
+/**
+ * Check if app is eligible for ExternalPurchaseCustomLink API (iOS 18.1+).
+ * Returns true if the app can use custom external purchase links.
+ *
+ * @returns Promise<boolean> - true if eligible
+ * @platform iOS
+ * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/iseligible
+ *
+ * @example
+ * ```typescript
+ * const isEligible = await isEligibleForExternalPurchaseCustomLinkIOS();
+ * if (isEligible) {
+ *   // App can use custom external purchase links
+ * }
+ * ```
+ */
+export const isEligibleForExternalPurchaseCustomLinkIOS =
+  async (): Promise<boolean> => {
+    if (Platform.OS !== 'ios') {
+      return false;
+    }
+    try {
+      return await IAP.instance.isEligibleForExternalPurchaseCustomLinkIOS();
+    } catch (error) {
+      RnIapConsole.error(
+        'Failed to check external purchase custom link eligibility:',
+        error,
+      );
+      return false;
+    }
+  };
+
+/**
+ * Get external purchase token for reporting to Apple (iOS 18.1+).
+ * Use this token with Apple's External Purchase Server API to report transactions.
+ *
+ * @param tokenType - Token type: 'acquisition' (new customers) or 'services' (existing customers)
+ * @returns Promise<ExternalPurchaseCustomLinkTokenResultIOS> - Result with token string or error
+ * @platform iOS
+ * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/token(for:)
+ *
+ * @example
+ * ```typescript
+ * // For new customer acquisition
+ * const result = await getExternalPurchaseCustomLinkTokenIOS('acquisition');
+ * if (result.token) {
+ *   // Report token to Apple's External Purchase Server API
+ *   await reportToApple(result.token);
+ * }
+ * ```
+ */
+export const getExternalPurchaseCustomLinkTokenIOS = async (
+  tokenType: ExternalPurchaseCustomLinkTokenTypeIOS,
+): Promise<ExternalPurchaseCustomLinkTokenResultIOS> => {
+  if (Platform.OS !== 'ios') {
+    throw new Error(
+      'External purchase custom link is only supported on iOS 18.1+',
+    );
+  }
+  try {
+    return await IAP.instance.getExternalPurchaseCustomLinkTokenIOS(tokenType);
+  } catch (error) {
+    RnIapConsole.error(
+      'Failed to get external purchase custom link token:',
+      error,
+    );
+    throw error;
+  }
+};
+
+/**
+ * Show ExternalPurchaseCustomLink notice sheet (iOS 18.1+).
+ * Displays the system disclosure notice sheet for custom external purchase links.
+ * Call this after a deliberate customer interaction before linking out to external purchases.
+ *
+ * @param noticeType - Notice type: 'browser' (external purchases displayed in browser)
+ * @returns Promise<ExternalPurchaseCustomLinkNoticeResultIOS> - Result with continued status and error if any
+ * @platform iOS
+ * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/shownotice(type:)
+ *
+ * @example
+ * ```typescript
+ * const result = await showExternalPurchaseCustomLinkNoticeIOS('browser');
+ * if (result.continued) {
+ *   // User agreed to continue to external purchase
+ *   await Linking.openURL('https://your-store.com/checkout');
+ * }
+ * ```
+ */
+export const showExternalPurchaseCustomLinkNoticeIOS = async (
+  noticeType: ExternalPurchaseCustomLinkNoticeTypeIOS,
+): Promise<ExternalPurchaseCustomLinkNoticeResultIOS> => {
+  if (Platform.OS !== 'ios') {
+    throw new Error(
+      'External purchase custom link is only supported on iOS 18.1+',
+    );
+  }
+  try {
+    return await IAP.instance.showExternalPurchaseCustomLinkNoticeIOS(
+      noticeType,
+    );
+  } catch (error) {
+    RnIapConsole.error(
+      'Failed to show external purchase custom link notice:',
+      error,
+    );
+    throw error;
+  }
+};

package/src/specs/RnIap.nitro.ts

@@ -1,4 +1,24 @@
 import type {HybridObject} from 'react-native-nitro-modules';
+
+// ╔══════════════════════════════════════════════════════════════════════════╗
+// ║                      NITRO MODULE CONSTRAINTS                            ║
+// ╠══════════════════════════════════════════════════════════════════════════╣
+// ║ Nitro Modules (react-native-nitro-modules) has specific limitations      ║
+// ║ when generating C++/Swift/Kotlin bridge code from TypeScript types:      ║
+// ║                                                                          ║
+// ║ 1. UNION TYPES REQUIRE 2+ VALUES                                         ║
+// ║    - Single-value unions like `type Foo = 'bar'` cause codegen errors    ║
+// ║    - Error: "String literal 'x' cannot be represented in C++ because     ║
+// ║      it is ambiguous between a string and a discriminating union enum"   ║
+// ║    - Solution: Add a fallback value (e.g., 'unspecified') to make 2+     ║
+// ║                                                                          ║
+// ║ 2. TYPES MUST BE DEFINED IN THIS FILE OR IMPORTED AS `type`              ║
+// ║    - Nitro codegen reads this file to generate native bridge code        ║
+// ║    - Interface types from types.ts can be imported and used directly     ║
+// ║    - Union types with 2+ values can be imported from types.ts            ║
+// ║    - Single-value unions must be redefined locally with extra values     ║
+// ╚══════════════════════════════════════════════════════════════════════════╝
+
 // NOTE: This Nitro spec re-exports types from the generated schema (src/types.ts)
 // via type aliases to avoid duplicating structure. Nitro's codegen expects the
 // canonical `Nitro*` names defined here, so we keep the aliases rather than
@@ -8,6 +28,11 @@ import type {
   AndroidSubscriptionOfferInput,
   DeepLinkOptions,
   InitConnectionConfig,
+  ExternalPurchaseCustomLinkNoticeResultIOS,
+  ExternalPurchaseCustomLinkTokenResultIOS,
+  // ExternalPurchaseCustomLinkTokenTypeIOS has 2 values ('acquisition' | 'services')
+  // so it can be imported directly from types.ts
+  ExternalPurchaseCustomLinkTokenTypeIOS,
   ExternalPurchaseLinkResultIOS,
   ExternalPurchaseNoticeResultIOS,
   MutationFinishTransactionArgs,
@@ -28,9 +53,25 @@ import type {
   WinBackOfferInputIOS,
 } from '../types';
 
-// Nitro-compatible enum types (Nitro doesn't support inline string unions from types.ts)
+// ╔══════════════════════════════════════════════════════════════════════════╗
+// ║                    LOCAL TYPE DEFINITIONS FOR NITRO                      ║
+// ╠══════════════════════════════════════════════════════════════════════════╣
+// ║ Types below are defined locally because:                                 ║
+// ║ - GQL-generated type has only 1 value (Nitro requires 2+), OR            ║
+// ║ - Nitro codegen needs the type defined in this file for bridge gen       ║
+// ╚══════════════════════════════════════════════════════════════════════════╝
+
+// ExternalPurchaseCustomLinkNoticeTypeIOS (iOS 18.1+)
+// GQL type: 'browser' (1 value) → Nitro requires 2+ values
+// Added 'unspecified' as fallback to satisfy Nitro constraint
+export type ExternalPurchaseCustomLinkNoticeTypeIOS = 'browser' | 'unspecified';
+
+// Platform identifier for cross-platform purchase/product data
+// Defined locally for Nitro codegen (not in GQL schema)
 export type IapPlatform = 'ios' | 'android';
 
+// IAPKit purchase state enum for receipt verification
+// Defined locally for Nitro codegen (IAPKit-specific, not in GQL schema)
 export type IapkitPurchaseState =
   | 'entitled'
   | 'pending-acknowledgment'
@@ -42,13 +83,17 @@ export type IapkitPurchaseState =
   | 'unknown'
   | 'inauthentic';
 
-// IapStore enum for purchase store identification
+// Store identifier for purchase origin
+// Defined locally for Nitro codegen (not in GQL schema)
 export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon';
 
-// Note: Nitro requires at least 2 values for union types
+// Purchase verification provider selection
+// Defined locally for Nitro codegen (not in GQL schema)
 export type PurchaseVerificationProvider = 'iapkit' | 'none';
 
-// Billing Programs API types (Android 8.2.0+, 8.3.0+ for external-payments, 7.0+ for user-choice-billing)
+// Billing Programs API (Android)
+// GQL type exists but defined locally for Nitro codegen consistency
+// Android 8.2.0+, 8.3.0+ for external-payments, 7.0+ for user-choice-billing
 export type BillingProgramAndroid =
   | 'unspecified'
   | 'external-content-link'
@@ -57,16 +102,21 @@ export type BillingProgramAndroid =
   | 'user-choice-billing';
 
 // Developer Billing Launch Mode (Android 8.3.0+)
+// Defined locally for Nitro codegen
 export type DeveloperBillingLaunchModeAndroid =
   | 'unspecified'
   | 'launch-in-external-browser-or-app'
   | 'caller-will-launch-link';
 
+// External Link Launch Mode (Android 8.2.0+)
+// Defined locally for Nitro codegen
 export type ExternalLinkLaunchModeAndroid =
   | 'unspecified'
   | 'launch-in-external-browser-or-app'
   | 'caller-will-launch-link';
 
+// External Link Type (Android 8.2.0+)
+// Defined locally for Nitro codegen
 export type ExternalLinkTypeAndroid =
   | 'unspecified'
   | 'link-to-digital-content-offer'
@@ -1127,4 +1177,45 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
   presentExternalPurchaseLinkIOS(
     url: string,
   ): Promise<ExternalPurchaseLinkResultIOS>;
+
+  // ╔════════════════════════════════════════════════════════════════════════╗
+  // ║            EXTERNAL PURCHASE CUSTOM LINK (iOS 18.1+)                   ║
+  // ╚════════════════════════════════════════════════════════════════════════╝
+
+  /**
+   * Check if app is eligible for ExternalPurchaseCustomLink API (iOS 18.1+).
+   * Returns true if the app can use custom external purchase links.
+   *
+   * @returns Promise<boolean> - true if eligible
+   * @platform iOS
+   * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/iseligible
+   */
+  isEligibleForExternalPurchaseCustomLinkIOS(): Promise<boolean>;
+
+  /**
+   * Get external purchase token for reporting to Apple (iOS 18.1+).
+   * Use this token with Apple's External Purchase Server API to report transactions.
+   *
+   * @param tokenType - Token type: 'acquisition' (new customers) or 'services' (existing customers)
+   * @returns Promise<ExternalPurchaseCustomLinkTokenResultIOS> - Result with token string or error
+   * @platform iOS
+   * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/token(for:)
+   */
+  getExternalPurchaseCustomLinkTokenIOS(
+    tokenType: ExternalPurchaseCustomLinkTokenTypeIOS,
+  ): Promise<ExternalPurchaseCustomLinkTokenResultIOS>;
+
+  /**
+   * Show ExternalPurchaseCustomLink notice sheet (iOS 18.1+).
+   * Displays the system disclosure notice sheet for custom external purchase links.
+   * Call this after a deliberate customer interaction before linking out to external purchases.
+   *
+   * @param noticeType - Notice type: 'browser' (external purchases displayed in browser)
+   * @returns Promise<ExternalPurchaseCustomLinkNoticeResultIOS> - Result with continued status and error if any
+   * @platform iOS
+   * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/shownotice(type:)
+   */
+  showExternalPurchaseCustomLinkNoticeIOS(
+    noticeType: ExternalPurchaseCustomLinkNoticeTypeIOS,
+  ): Promise<ExternalPurchaseCustomLinkNoticeResultIOS>;
 }

package/src/types.ts

@@ -386,7 +386,40 @@ export interface ExternalOfferReportingDetailsAndroid {
   externalTransactionToken: string;
 }
 
-/** Result of presenting an external purchase link (iOS 18.2+) */
+/** Result of showing ExternalPurchaseCustomLink notice (iOS 18.1+). */
+export interface ExternalPurchaseCustomLinkNoticeResultIOS {
+  /** Whether the user chose to continue to external purchase */
+  continued: boolean;
+  /** Optional error message if the presentation failed */
+  error?: (string | null);
+}
+
+/**
+ * Notice types for ExternalPurchaseCustomLink (iOS 18.1+).
+ * Determines the style of disclosure notice to display.
+ * Reference: https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/noticetype
+ */
+export type ExternalPurchaseCustomLinkNoticeTypeIOS = 'browser';
+
+/** Result of requesting an ExternalPurchaseCustomLink token (iOS 18.1+). */
+export interface ExternalPurchaseCustomLinkTokenResultIOS {
+  /** Optional error message if token retrieval failed */
+  error?: (string | null);
+  /**
+   * The external purchase token string.
+   * Report this token to Apple's External Purchase Server API.
+   */
+  token?: (string | null);
+}
+
+/**
+ * Token types for ExternalPurchaseCustomLink (iOS 18.1+).
+ * Used to request different types of external purchase tokens for reporting to Apple.
+ * Reference: https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/token(for:)
+ */
+export type ExternalPurchaseCustomLinkTokenTypeIOS = 'acquisition' | 'services';
+
+/** Result of presenting an external purchase link */
 export interface ExternalPurchaseLinkResultIOS {
   /** Optional error message if the presentation failed */
   error?: (string | null);
@@ -394,13 +427,22 @@ export interface ExternalPurchaseLinkResultIOS {
   success: boolean;
 }
 
-/** User actions on external purchase notice sheet (iOS 18.2+) */
+/** User actions on external purchase notice sheet (iOS 17.4+) */
 export type ExternalPurchaseNoticeAction = 'continue' | 'dismissed';
 
-/** Result of presenting external purchase notice sheet (iOS 18.2+) */
+/**
+ * Result of presenting external purchase notice sheet (iOS 17.4+)
+ * Returns the token when user continues to external purchase.
+ */
 export interface ExternalPurchaseNoticeResultIOS {
   /** Optional error message if the presentation failed */
   error?: (string | null);
+  /**
+   * External purchase token returned when user continues (iOS 17.4+).
+   * This token should be reported to Apple's External Purchase Server API.
+   * Only present when result is Continue.
+   */
+  externalPurchaseToken?: (string | null);
   /** Notice result indicating user action */
   result: ExternalPurchaseNoticeAction;
 }
@@ -527,9 +569,13 @@ export interface Mutation {
   launchExternalLinkAndroid: Promise<boolean>;
   /** Present the App Store code redemption sheet */
   presentCodeRedemptionSheetIOS: Promise<boolean>;
-  /** Present external purchase custom link with StoreKit UI (iOS 18.2+) */
+  /** Present external purchase custom link with StoreKit UI */
   presentExternalPurchaseLinkIOS: Promise<ExternalPurchaseLinkResultIOS>;
-  /** Present external purchase notice sheet (iOS 18.2+) */
+  /**
+   * Present external purchase notice sheet (iOS 17.4+).
+   * Uses ExternalPurchase.presentNoticeSheet() which returns a token when user continues.
+   * Reference: https://developer.apple.com/documentation/storekit/externalpurchase/presentnoticesheet()
+   */
   presentExternalPurchaseNoticeSheetIOS: Promise<ExternalPurchaseNoticeResultIOS>;
   /** Initiate a purchase flow; rely on events for final state */
   requestPurchase?: Promise<(Purchase | Purchase[] | null)>;
@@ -553,6 +599,13 @@ export interface Mutation {
    * Throws OpenIapError.NotPrepared if billing client not ready
    */
   showAlternativeBillingDialogAndroid: Promise<boolean>;
+  /**
+   * Show ExternalPurchaseCustomLink notice sheet (iOS 18.1+).
+   * Displays the system disclosure notice sheet for custom external purchase links.
+   * Call this after a deliberate customer interaction before linking out to external purchases.
+   * Reference: https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/shownotice(type:)
+   */
+  showExternalPurchaseCustomLinkNoticeIOS: Promise<ExternalPurchaseCustomLinkNoticeResultIOS>;
   /** Open subscription management UI and return changed purchases (iOS 15+) */
   showManageSubscriptionsIOS: Promise<PurchaseIOS[]>;
   /** Force a StoreKit sync for transactions (iOS 15+) */
@@ -611,6 +664,8 @@ export type MutationRequestPurchaseArgs =
     };
 
 
+export type MutationShowExternalPurchaseCustomLinkNoticeIosArgs = ExternalPurchaseCustomLinkNoticeTypeIOS;
+
 export type MutationValidateReceiptArgs = VerifyPurchaseProps;
 
 export type MutationVerifyPurchaseArgs = VerifyPurchaseProps;
@@ -1053,7 +1108,10 @@ export type PurchaseState = 'pending' | 'purchased' | 'unknown';
 export type PurchaseVerificationProvider = 'iapkit';
 
 export interface Query {
-  /** Check if external purchase notice sheet can be presented (iOS 18.2+) */
+  /**
+   * Check if external purchase notice sheet can be presented (iOS 17.4+)
+   * Uses ExternalPurchase.canPresent
+   */
   canPresentExternalPurchaseNoticeIOS: Promise<boolean>;
   /** Get current StoreKit 2 entitlements (iOS 15+) */
   currentEntitlementIOS?: Promise<(PurchaseIOS | null)>;
@@ -1065,6 +1123,12 @@ export interface Query {
   getAppTransactionIOS?: Promise<(AppTransaction | null)>;
   /** Get all available purchases for the current user */
   getAvailablePurchases: Promise<Purchase[]>;
+  /**
+   * Get external purchase token for reporting to Apple (iOS 18.1+).
+   * Use this token with Apple's External Purchase Server API to report transactions.
+   * Reference: https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/token(for:)
+   */
+  getExternalPurchaseCustomLinkTokenIOS: Promise<ExternalPurchaseCustomLinkTokenResultIOS>;
   /** Retrieve all pending transactions in the StoreKit queue */
   getPendingTransactionsIOS: Promise<PurchaseIOS[]>;
   /** Get the currently promoted product (iOS 11+) */
@@ -1082,6 +1146,12 @@ export interface Query {
   getTransactionJwsIOS?: Promise<(string | null)>;
   /** Check whether the user has active subscriptions */
   hasActiveSubscriptions: Promise<boolean>;
+  /**
+   * Check if app is eligible for ExternalPurchaseCustomLink API (iOS 18.1+).
+   * Returns true if the app can use custom external purchase links.
+   * Reference: https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/iseligible
+   */
+  isEligibleForExternalPurchaseCustomLinkIOS: Promise<boolean>;
   /** Check introductory offer eligibility for a subscription group */
   isEligibleForIntroOfferIOS: Promise<boolean>;
   /** Verify a StoreKit 2 transaction signature */
@@ -1107,6 +1177,8 @@ export type QueryGetActiveSubscriptionsArgs = (string[] | null) | undefined;
 
 export type QueryGetAvailablePurchasesArgs = (PurchaseOptions | null) | undefined;
 
+export type QueryGetExternalPurchaseCustomLinkTokenIosArgs = ExternalPurchaseCustomLinkTokenTypeIOS;
+
 export type QueryGetTransactionJwsIosArgs = string;
 
 export type QueryHasActiveSubscriptionsArgs = (string[] | null) | undefined;
@@ -1742,6 +1814,7 @@ export type QueryArgsMap = {
   getActiveSubscriptions: QueryGetActiveSubscriptionsArgs;
   getAppTransactionIOS: never;
   getAvailablePurchases: QueryGetAvailablePurchasesArgs;
+  getExternalPurchaseCustomLinkTokenIOS: QueryGetExternalPurchaseCustomLinkTokenIosArgs;
   getPendingTransactionsIOS: never;
   getPromotedProductIOS: never;
   getReceiptDataIOS: never;
@@ -1749,6 +1822,7 @@ export type QueryArgsMap = {
   getStorefrontIOS: never;
   getTransactionJwsIOS: QueryGetTransactionJwsIosArgs;
   hasActiveSubscriptions: QueryHasActiveSubscriptionsArgs;
+  isEligibleForExternalPurchaseCustomLinkIOS: never;
   isEligibleForIntroOfferIOS: QueryIsEligibleForIntroOfferIosArgs;
   isTransactionVerifiedIOS: QueryIsTransactionVerifiedIosArgs;
   latestTransactionIOS: QueryLatestTransactionIosArgs;
@@ -1790,6 +1864,7 @@ export type MutationArgsMap = {
   requestPurchaseOnPromotedProductIOS: never;
   restorePurchases: never;
   showAlternativeBillingDialogAndroid: never;
+  showExternalPurchaseCustomLinkNoticeIOS: MutationShowExternalPurchaseCustomLinkNoticeIosArgs;
   showManageSubscriptionsIOS: never;
   syncIOS: never;
   validateReceipt: MutationValidateReceiptArgs;

package/src/utils/type-bridge.ts

@@ -93,6 +93,7 @@ function normalizeProductTypeIOS(value?: Nullable<string>): ProductTypeIOS {
       return 'auto-renewable-subscription';
     case 'nonrenewingsubscription':
     case 'non_renewing_subscription':
+    case 'non-renewing-subscription':
       return 'non-renewing-subscription';
     default:
       if (value) {