[iOS] Missing support for ExternalPurchaseCustomLink token and notice sheet

[T-Matteo]

Original Content

I've not found anywhere in the documentation of this library on how to get the token to later report the transaction to apple, in their official documentation they mention the token method, but i've not found anything like that here.
Additionally there's also no way to show the notice sheet to the user before directing to the external offer.
Both steps are listed in the apple documentation and i'd expect this library to either provide a way call the related methods or offer the same functionality through different means.

---

Description

The library is missing support for two important features of Apple's ExternalPurchaseCustomLink API:

1. Getting the external purchase token: There is no documented way to retrieve the token needed to report transactions to Apple
2. Showing the notice sheet: There is no way to display the notice sheet to users before directing them to an external offer

Both of these steps are documented in Apple's official documentation and should be supported by this library.

Missing Methods

• ExternalPurchaseCustomLink.token(for:)
• ExternalPurchaseCustomLink.showNotice(type:)

Expected Solution

The library should either:

• Provide direct access to these methods, or
• Offer equivalent functionality through alternative means

---

🤖 Formatted by gitdog.dev

[hyochan]

Great news! 🎉

This functionality has been implemented in PR #3136: feat(ios): add ExternalPurchaseCustomLink API support (iOS 18.1+)

The PR adds three new APIs for the ExternalPurchaseCustomLink feature:

New APIs

1. isEligibleForExternalPurchaseCustomLinkIOS() - Check if app is eligible

   const isEligible = await isEligibleForExternalPurchaseCustomLinkIOS();

2. getExternalPurchaseCustomLinkTokenIOS(tokenType) - Get token for Apple reporting

   const result = await getExternalPurchaseCustomLinkTokenIOS('acquisition');
   // or 'services' for existing customers
   if (result.token) {
     // Report to Apple's External Purchase Server API
   }

3. showExternalPurchaseCustomLinkNoticeIOS(noticeType) - Show disclosure notice

   const result = await showExternalPurchaseCustomLinkNoticeIOS('browser');
   if (result.continued) {
     // User agreed - proceed with external purchase link
     await Linking.openURL('https://your-store.com/checkout');
   }

Requirements

• iOS 18.1+
• App must be enrolled in Apple's External Purchase program

This PR is ready for review and will be included in the next release. Feel free to test it out!