Add internal API to debug tracked events on iOS (#1612)

Depends on RevenueCat/purchases-hybrid-common#1502

This provides some visibility on what events are tracked and when on
iOS. This can help debug any issues with these events.

iOS counterpart of #1562.

Made with [Cursor](https://cursor.com)

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: ajpallares

examples/purchaseTesterTypescript/App.tsx

@@ -86,9 +86,6 @@ const App = () => {
           diagnosticsEnabled: true,
         });
       }
-      Purchases.addTrackedEventListener((event: Record<string, unknown>) => {
-        console.log('[RCTrackedEvent]', JSON.stringify(event, null, 2));
-      });
       Purchases.addDebugEventListener((event: Record<string, unknown>) => {
         console.log('[RCDebugEvent]', JSON.stringify(event, null, 2));
       });
@@ -99,6 +96,9 @@ const App = () => {
         diagnosticsEnabled: true
       });
     }
+    Purchases.addTrackedEventListener((event: Record<string, unknown>) => {
+      console.log('[RCTrackedEvent]', JSON.stringify(event, null, 2));
+    });
 
     Purchases.enableAdServicesAttributionTokenCollection();
   }, []);

ios/RNPurchases.m

@@ -566,6 +566,12 @@ static void logUnavailablePresentCodeRedemptionSheet() {
     }];
 }
 
+RCT_EXPORT_METHOD(setTrackedEventListener) {
+    [RCCommonFunctionality setTrackedEventListenerOnEventReceived:^(NSDictionary<NSString *, id> * _Nonnull eventDetails) {
+        [self sendEventWithName:RNPurchasesTrackedEvent body:eventDetails];
+    }];
+}
+
 RCT_EXPORT_METHOD(isWebPurchaseRedemptionURL:(NSString *)urlString
                   resolve:(RCTPromiseResolveBlock)resolve
                   reject:(RCTPromiseRejectBlock)reject) {

src/purchases.ts

@@ -860,15 +860,15 @@ export default class Purchases {
   /**
    * Sets a function to be called when a feature event is tracked by RevenueCatUI.
    * This is a debug API for monitoring paywall and customer center events not meant for public use.
-   * Currently only works on Android.
+   * Currently only works on Android and iOS.
    * @internal
    * @param {TrackedEventListener} trackedEventListener TrackedEvent listener
    */
   public static async addTrackedEventListener(
     trackedEventListener: TrackedEventListener
   ): Promise<void> {
     await Purchases.throwIfNotConfigured();
-    if (Platform.OS === "android") {
+    if (Platform.OS === "android" || Platform.OS === "ios") {
       if (typeof trackedEventListener !== "function") {
         throw new Error("addTrackedEventListener needs a function");
       }