feat(inappmessaging): add support for triggering custom events (#4201)

* Expose triggerEvent() function for Firebase In App Messaging
* Fix NSString* and add simple test

packages/in-app-messaging/android/src/main/java/io/invertase/firebase/fiam/UniversalFirebaseFiamModule.java

@@ -46,6 +46,13 @@ Task<Void> setMessagesDisplaySuppressed(Boolean enabled) {
     });
   }
 
+  Task<Void> triggerEvent(String eventId) {
+    return Tasks.call(() -> {
+      FirebaseInAppMessaging.getInstance().triggerEvent(eventId);
+      return null;
+    });
+  }
+
   @Override
   public Map<String, Object> getConstants() {
     final Map<String, Object> constants = new HashMap<>();

packages/in-app-messaging/android/src/reactnative/java/io/invertase/firebase/fiam/ReactNativeFirebaseFiamModule.java

@@ -55,6 +55,17 @@ public void setMessagesDisplaySuppressed(Boolean enabled, Promise promise) {
     });
   }
 
+  @ReactMethod
+  public void triggerEvent(String eventId, Promise promise) {
+    module.triggerEvent(eventId).addOnCompleteListener(task -> {
+      if (task.isSuccessful()) {
+        promise.resolve(task.getResult());
+      } else {
+        rejectPromiseWithExceptionMap(promise, task.getException());
+      }
+    });
+  }
+
   @Override
   public Map<String, Object> getConstants() {
     return module.getConstants();

packages/in-app-messaging/e2e/fiam.e2e.js

@@ -84,4 +84,11 @@ describe('inAppMessaging()', () => {
       }
     });
   });
+
+  xdescribe('triggerEvent()', () => {
+    it('no exceptions thrown', async () => {
+      await device.launchApp();
+      await firebase.inAppMessaging().triggerEvent('eventName');
+    });
+  });
 });

packages/in-app-messaging/ios/RNFBFiam/RNFBFiamModule.m

@@ -63,4 +63,15 @@ + (BOOL)requiresMainQueueSetup {
     resolve([NSNull null]);
   }
 
+  RCT_EXPORT_METHOD(triggerEvent:
+    (NSString*) eventId
+        resolver:
+        (RCTPromiseResolveBlock) resolve
+        rejecter:
+        (RCTPromiseRejectBlock) reject) {
+    [[FIRInAppMessaging inAppMessaging] triggerEvent: eventId];
+    resolve([NSNull null]);
+  }
+
+
 @end

packages/in-app-messaging/lib/index.d.ts

@@ -130,6 +130,20 @@ export namespace FirebaseInAppMessagingTypes {
      * @param enabled Whether automatic data collection is enabled.
      */
     setAutomaticDataCollectionEnabled(enabled: boolean): Promise<null>;
+
+    /**
+     * Trigger in-app messages programmatically
+     *
+     * #### Example
+     *
+     * ```js
+     * // Suppress messages
+     * await firebase.inAppMessaging().triggerEvent("exampleTrigger");
+     * ```
+     *
+     * @param eventId The id of the event.
+     */
+    triggerEvent(eventId: string): Promise<null>;
   }
 }
 

packages/in-app-messaging/lib/index.js

@@ -15,7 +15,7 @@
  *
  */
 
-import { isBoolean } from '@react-native-firebase/app/lib/common';
+import { isBoolean, isString } from '@react-native-firebase/app/lib/common';
 import {
   createModuleNamespace,
   FirebaseModule,
@@ -65,6 +65,13 @@ class FirebaseFiamModule extends FirebaseModule {
     this._isAutomaticDataCollectionEnabled = enabled;
     return this.native.setAutomaticDataCollectionEnabled(enabled);
   }
+
+  triggerEvent(eventId) {
+    if (!isString(eventId)) {
+      throw new Error("firebase.inAppMessaging().triggerEvent(*) 'eventId' must be a string.");
+    }
+    return this.native.triggerEvent(eventId);
+  }
 }
 
 // import { SDK_VERSION } from '@react-native-firebase/in-app-messaging';