@capillarytech/react-native-hydra-lib 1.7.0-beta.1 → 1.7.0-beta.10

package/android/src/main/java/com/hydralib/hydrasdk/HydraInAppMessages.kt

@@ -66,33 +66,46 @@ object HydraInAppMessages {
     message: ReadableMap?,
     promise: Promise?
   ) {
-
-    message?.let {
-      val messageMap = message.toMap()
-      messageMap["nativeJsonPayload"]?.let {
-        val jsonString = Gson().toJson(it)
-        val payloadFromJson = Gson().fromJson(jsonString, CampaignPayload::class.java)
-        HydraInAppUIHelper.getInstance()
-          .reportInAppMessageIsClicked(HydraCore.appContext!!, payloadFromJson)
-        promise?.resolve(true)
-      }
+    if (message == null) {
+      Logger.e("HydraInAppMessages.reportMessageClicked", "message is null, cannot report click")
+      promise?.reject("Error", "message is null")
+      return
+    }
+    val messageMap = message.toMap()
+    val nativeJsonPayload = messageMap["nativeJsonPayload"]
+    if (nativeJsonPayload == null) {
+      Logger.e("HydraInAppMessages.reportMessageClicked", "nativeJsonPayload missing in message, cannot report click")
+      promise?.reject("Error", "nativeJsonPayload missing in message")
+      return
     }
+    val jsonString = Gson().toJson(nativeJsonPayload)
+    val payloadFromJson = Gson().fromJson(jsonString, CampaignPayload::class.java)
+    HydraInAppUIHelper.getInstance()
+      .reportInAppMessageIsClicked(HydraCore.appContext!!, payloadFromJson)
+    promise?.resolve(true)
   }
 
   fun reportMessageDismissed(
     message: ReadableMap?,
     promise: Promise?
   ) {
-    message?.let {
-      val messageMap = message.toMap()
-      messageMap["nativeJsonPayload"]?.let {
-        val jsonString = Gson().toJson(it)
-        val payloadFromJson = Gson().fromJson(jsonString, CampaignPayload::class.java)
-        HydraInAppUIHelper.getInstance()
-          .reportInAppMessageDismissed(HydraCore.appContext!!, payloadFromJson)
-        promise?.resolve(true)
-      }
+    if (message == null) {
+      Logger.e("HydraInAppMessages.reportMessageDismissed", "message is null, cannot report dismissal")
+      promise?.reject("Error", "message is null")
+      return
+    }
+    val messageMap = message.toMap()
+    val nativeJsonPayload = messageMap["nativeJsonPayload"]
+    if (nativeJsonPayload == null) {
+      Logger.e("HydraInAppMessages.reportMessageDismissed", "nativeJsonPayload missing in message, cannot report dismissal")
+      promise?.reject("Error", "nativeJsonPayload missing in message")
+      return
     }
+    val jsonString = Gson().toJson(nativeJsonPayload)
+    val payloadFromJson = Gson().fromJson(jsonString, CampaignPayload::class.java)
+    HydraInAppUIHelper.getInstance()
+      .reportInAppMessageDismissed(HydraCore.appContext!!, payloadFromJson)
+    promise?.resolve(true)
   }
 
   fun reportMessageRating(
@@ -100,16 +113,23 @@ object HydraInAppMessages {
     rating: Double,
     promise: Promise?
   ) {
-    message?.let {
-      val messageMap = message.toMap()
-      messageMap["nativeJsonPayload"]?.let {
-        val jsonString = Gson().toJson(it)
-        val payloadFromJson = Gson().fromJson(jsonString, CampaignPayload::class.java)
-        HydraInAppUIHelper.getInstance()
-          .reportInAppMessageRating(HydraCore.appContext!!, payloadFromJson, rating.toInt())
-        promise?.resolve(true)
-      }
+    if (message == null) {
+      Logger.e("HydraInAppMessages.reportMessageRating", "message is null, cannot report rating")
+      promise?.reject("Error", "message is null")
+      return
+    }
+    val messageMap = message.toMap()
+    val nativeJsonPayload = messageMap["nativeJsonPayload"]
+    if (nativeJsonPayload == null) {
+      Logger.e("HydraInAppMessages.reportMessageRating", "nativeJsonPayload missing in message, cannot report rating")
+      promise?.reject("Error", "nativeJsonPayload missing in message")
+      return
     }
+    val jsonString = Gson().toJson(nativeJsonPayload)
+    val payloadFromJson = Gson().fromJson(jsonString, CampaignPayload::class.java)
+    HydraInAppUIHelper.getInstance()
+      .reportInAppMessageRating(HydraCore.appContext!!, payloadFromJson, rating.toInt())
+    promise?.resolve(true)
   }
 
   fun reportMessageFeedback(
@@ -118,19 +138,26 @@ object HydraInAppMessages {
     feedbackOptions: ReadableArray?,
     promise: Promise?
   ) {
-    message?.let {
-      val messageMap = message.toMap()
-      messageMap["nativeJsonPayload"]?.let {
-        val jsonString = Gson().toJson(it)
-        val payloadFromJson = Gson().fromJson(jsonString, CampaignPayload::class.java)
-        val feedbackOptionsList = feedbackOptions?.toList()?.mapNotNull { option -> option as? Int } ?: listOf()
-        HydraInAppUIHelper.getInstance().reportInAppMessageFeedback(
-          HydraCore.appContext!!,
-          payloadFromJson,
-          feedbackOptionsList
-        )
-        promise?.resolve(true)
-      }
+    if (message == null) {
+      Logger.e("HydraInAppMessages.reportMessageFeedback", "message is null, cannot report feedback")
+      promise?.reject("Error", "message is null")
+      return
+    }
+    val messageMap = message.toMap()
+    val nativeJsonPayload = messageMap["nativeJsonPayload"]
+    if (nativeJsonPayload == null) {
+      Logger.e("HydraInAppMessages.reportMessageFeedback", "nativeJsonPayload missing in message, cannot report feedback")
+      promise?.reject("Error", "nativeJsonPayload missing in message")
+      return
     }
+    val jsonString = Gson().toJson(nativeJsonPayload)
+    val payloadFromJson = Gson().fromJson(jsonString, CampaignPayload::class.java)
+    val feedbackOptionsList = feedbackOptions?.toList()?.mapNotNull { option -> option as? Int } ?: listOf()
+    HydraInAppUIHelper.getInstance().reportInAppMessageFeedback(
+      HydraCore.appContext!!,
+      payloadFromJson,
+      feedbackOptionsList
+    )
+    promise?.resolve(true)
   }
 }

package/android/src/main/java/com/hydralib/hydrasdk/HydraInbox.kt

@@ -43,7 +43,7 @@ object HydraInbox {
       Logger.d("HydraInbox.markInboxMessageAsRead", "Inbox message marked read successfully")
       return
     }
-    Logger.d("HydraInbox.markInboxMessageAsRead", "Invalid inbox message details")
+    Logger.e("HydraInbox.markInboxMessageAsRead", "Invalid inbox message details, input message = $inboxMessage")
     promise?.resolve(false)
   }
 
@@ -56,7 +56,7 @@ object HydraInbox {
       Logger.d("HydraInbox.deleteInboxMessage", "Inbox message deleted successfully")
       return
     }
-    Logger.d("HydraInbox.deleteInboxMessage", "Invalid inbox message details")
+    Logger.e("HydraInbox.deleteInboxMessage", "Invalid inbox message details, input message = $inboxMessage")
     promise?.resolve(false)
   }
 

package/android/src/main/java/com/hydralib/hydrasdk/HydraPushNotification.kt

@@ -6,10 +6,12 @@ import android.app.NotificationManager
 import android.app.PendingIntent
 import android.content.Context
 import android.content.Intent
+import android.content.pm.PackageManager
 import android.net.Uri
 import android.os.Build
 import com.hydralib.delegates.NonHydraNotificationActivity
 import androidx.core.app.NotificationCompat
+import androidx.core.content.ContextCompat
 import com.capillary.hydra.android.sdk.utils.Logger
 import com.capillary.hydra.firebase.HydraFirebaseAPI
 import com.capillary.hydra.firebase.listener.NonHydraPushListener
@@ -155,6 +157,32 @@ object HydraPushNotification {
       return
     }
 
+    // Already granted: answer from the OS state instead of asking again. requestPushPermission
+    // starts PermissionActivity unconditionally, and that activity lands in the host app's task
+    // even when it has nothing to show and finishes immediately. During a notification-click
+    // cold start that pulls the app back on top of the browser we just handed an EXTERNAL CTA
+    // to, so the external link looks like it did nothing.
+    //
+    // Placed before the listener registration on purpose: the promise below is resolved from
+    // NotificationPermissionListener, which only fires in response to requestPushPermission, so
+    // returning after registering would leak a listener that never fires and hang the promise.
+    // Spelled out rather than Manifest.permission.POST_NOTIFICATIONS: that constant is API 33,
+    // and this library's compileSdkVersion falls back to 31 (gradle.properties) for any host app
+    // whose rootProject.ext does not override it, so the symbol would not resolve there. The
+    // string is the platform's own value and is stable.
+    val context = HydraCore.appContext
+    if (context != null &&
+      ContextCompat.checkSelfPermission(context, "android.permission.POST_NOTIFICATIONS")
+      == PackageManager.PERMISSION_GRANTED
+    ) {
+      Logger.d(
+        "HydraPushNotification.requestPermission",
+        "POST_NOTIFICATIONS already granted, resolving without starting PermissionActivity"
+      )
+      promise?.resolve(true)
+      return
+    }
+
     var listener: NotificationPermissionListener? = null
     listener = NotificationPermissionListener { isGranted ->
       Logger.d(
@@ -190,7 +218,7 @@ object HydraPushNotification {
 
   fun getFCMToken(promise: Promise?) {
     if (fcmToken == null) {
-      Logger.d("HydraPushNotification.getFCMToken", "Token is not available, try later")
+      Logger.e("HydraPushNotification.getFCMToken", "Token is not available, try later")
       promise?.reject("TokenNotSet", "Token is not available, try later")
       return
     }

package/android/src/newarch/HydraLibModule.kt

@@ -121,6 +121,22 @@ class HydraLibModule(reactContext: ReactApplicationContext) :
     HydraCore.setCapToken(token, promise)
   }
 
+  override fun setGamificationSuppressed(suppressed: Boolean, promise: Promise?) {
+    HydraCore.setGamificationSuppressed(suppressed, promise)
+  }
+
+  override fun isGamificationSuppressed(promise: Promise?) {
+    HydraCore.isGamificationSuppressed(promise)
+  }
+
+  override fun setThemeMode(mode: String, promise: Promise?) {
+    HydraCore.setThemeMode(mode, promise)
+  }
+
+  override fun getThemeMode(promise: Promise?) {
+    HydraCore.getThemeMode(promise)
+  }
+
   override fun openExternalUrl(url: String, promise: Promise?) {
     HydraPushNotification.openExternalUrl(url, promise)
   }

package/android/src/oldarch/HydraLibModule.kt

@@ -141,6 +141,26 @@ class HydraLibModule internal constructor(context: ReactApplicationContext) :
     HydraCore.setCapToken(token, promise)
   }
 
+  @ReactMethod(isBlockingSynchronousMethod = false)
+  fun setGamificationSuppressed(suppressed: Boolean, promise: Promise?) {
+    HydraCore.setGamificationSuppressed(suppressed, promise)
+  }
+
+  @ReactMethod(isBlockingSynchronousMethod = false)
+  fun isGamificationSuppressed(promise: Promise?) {
+    HydraCore.isGamificationSuppressed(promise)
+  }
+
+  @ReactMethod(isBlockingSynchronousMethod = false)
+  fun setThemeMode(mode: String, promise: Promise?) {
+    HydraCore.setThemeMode(mode, promise)
+  }
+
+  @ReactMethod(isBlockingSynchronousMethod = false)
+  fun getThemeMode(promise: Promise?) {
+    HydraCore.getThemeMode(promise)
+  }
+
   @ReactMethod(isBlockingSynchronousMethod = false)
   fun openExternalUrl(url: String, promise: Promise?) {
     HydraPushNotification.openExternalUrl(url, promise)

package/ios/Delegates/HydraApplicationDelegate.swift

@@ -32,6 +32,14 @@ import HydraCore
   }
   
   fileprivate func setupNavigationController(_ application: UIApplication) {
+    // Wrapping the app's rootViewController in a UINavigationController is only
+    // needed to push the Hydra NotificationCenter (see HydraInboxUI). Apps that
+    // don't enable InboxUI keep their own root view controller untouched.
+    guard HydraSDKCore.isInboxUIEnabled() else {
+      Logger.info("HydraApplicationDelegate: setupNavigationController: enable_inbox_ui is false, skipping navigation controller setup")
+      return
+    }
+
     //Create and set NavigationController as rootController, will be required to show NotificationCenter
     let storyboard = UIStoryboard(name: Bundle.main.infoDictionary?["UILaunchStoryboardName"] as? String ?? "LaunchScreen", bundle: nil)
     let viewController = storyboard.instantiateInitialViewController()

package/ios/EventEmitter/HydraEventType.swift

@@ -25,4 +25,6 @@ enum HydraEventType : String, CaseIterable{
   case ON_VISITOR_SESSION_READY = "onVisitorSessionReady"
   case ON_USER_STATE_CHANGED = "onUserStateChanged"
   case ON_GAMIFICATION_VIEW_HEIGHT_CHANGED = "onGamificationViewHeightChanged"
+  case ON_GAMIFICATION_ANALYTICS_EVENT = "gamificationAnalyticsEvent"
+  case ON_GAMIFICATION_DEEPLINK = "gamificationDeeplink"
 }

package/ios/GamificationViews/GamificationBannerViewComponentView.mm

@@ -2,10 +2,10 @@
 
 #import "GamificationBannerViewComponentView.h"
 
-#import "../generated/RNHydraLibSpec/ComponentDescriptors.h"
-#import "../generated/RNHydraLibSpec/EventEmitters.h"
-#import "../generated/RNHydraLibSpec/Props.h"
-#import "../generated/RNHydraLibSpec/RCTComponentViewHelpers.h"
+#import <react/renderer/components/RNHydraLibSpec/ComponentDescriptors.h>
+#import <react/renderer/components/RNHydraLibSpec/EventEmitters.h>
+#import <react/renderer/components/RNHydraLibSpec/Props.h>
+#import <react/renderer/components/RNHydraLibSpec/RCTComponentViewHelpers.h>
 #import "RCTFabricComponentsPlugins.h"
 #import <React/RCTBridgeModule.h>
 #import <React/RCTComponentViewFactory.h>
@@ -53,12 +53,37 @@ using namespace facebook::react;
 }
 
 - (void)gamificationDataReloaded {
+    // Always dispatch to main: the SDK may post this from a background queue,
+    // and createGamificationBannerView is a UIKit/MainActor call.
     dispatch_async(dispatch_get_main_queue(), ^{
+        // Fabric keeps unmounted component views alive in its recycle pool, and a pooled view is
+        // still a registered observer here. It must NOT rebuild: every successful
+        // createGamificationBannerView records an impression against the entry point's display count
+        // (conditions.showCount.count), so an off-screen pooled view would silently burn the cap and
+        // the banner would vanish for real users far sooner than configured. A mounted view always
+        // has a superview; a pooled one never does (Fabric asserts this when enqueueing).
+        if (self.superview == nil) {
+            return;
+        }
         self->_needsBannerView = YES;
         [self attachBannerViewIfPossible];
     });
 }
 
+// Fabric recycles component views. RCTViewComponentView's own prepareForRecycle resets the event
+// emitter and react subviews but NOT `contentView`, and setContentView: re-adds it to the container
+// view — so without this a recycled instance keeps the previous mount's banner view (a live
+// WKWebView showing an already-rendered campaign). updateProps would then see `contentView != nil`
+// with an unchanged bannerId and never ask the SDK again, bypassing the frequency-cap/visibility
+// check entirely and displaying stale content the SDK has decided to hide.
+- (void)prepareForRecycle {
+    self.contentView = nil;
+    _bannerId = nil;
+    _needsBannerView = NO;
+    _retryPending = NO;
+    [super prepareForRecycle];
+}
+
 - (void)updateProps:(const Props::Shared &)props oldProps:(const Props::Shared &)oldProps {
     const auto &newProps = *std::static_pointer_cast<const GamificationBannerViewProps>(props);
 
@@ -87,7 +112,11 @@ using namespace facebook::react;
     if (!_needsBannerView || _bannerId.length == 0) {
         return;
     }
-    if (CGRectIsEmpty(self.bounds)) {
+    // Only WIDTH has to be laid out: the SDK ignores our bounds entirely (it measures the window)
+    // and seeds the real height back through onHeight. Requiring a non-empty rect would wedge a
+    // surface that has legitimately collapsed to height 0 — it could never rebuild when fresh data
+    // arrives, because its own bounds would stay empty forever.
+    if (self.bounds.size.width <= 0) {
         return;
     }
 
@@ -99,7 +128,15 @@ using namespace facebook::react;
         _needsBannerView = NO;
         _retryPending = NO;
     } else {
-        NSLog(@"[GamificationBanner] SDK returned nil — scheduling long fallback");
+        NSLog(@"[GamificationBanner] SDK returned nil — collapsing and scheduling long fallback");
+        // nil means "do not render this banner now" — hidden, frequency-capped, or no resolved URL.
+        // Drop anything already attached so a previously loaded webview can't outlive that decision.
+        // The SDK has already pushed height 0 through onHeight, so the JS side collapses with us.
+        self.contentView = nil;
+        // Don't retry aggressively: the SDK may have entry points loaded but
+        // reward/program data not yet ready. The HydraGamificationDataReloaded
+        // notification fires when everything is ready and will call us again.
+        // This 5-second fallback only fires if that notification is missed.
         [self scheduleFallbackRetry];
     }
 }

package/ios/GamificationViews/GamificationEmbedViewComponentView.mm

@@ -2,10 +2,10 @@
 
 #import "GamificationEmbedViewComponentView.h"
 
-#import "../generated/RNHydraLibSpec/ComponentDescriptors.h"
-#import "../generated/RNHydraLibSpec/EventEmitters.h"
-#import "../generated/RNHydraLibSpec/Props.h"
-#import "../generated/RNHydraLibSpec/RCTComponentViewHelpers.h"
+#import <react/renderer/components/RNHydraLibSpec/ComponentDescriptors.h>
+#import <react/renderer/components/RNHydraLibSpec/EventEmitters.h>
+#import <react/renderer/components/RNHydraLibSpec/Props.h>
+#import <react/renderer/components/RNHydraLibSpec/RCTComponentViewHelpers.h>
 #import "RCTFabricComponentsPlugins.h"
 #import <React/RCTBridgeModule.h>
 #import <React/RCTComponentViewFactory.h>
@@ -56,11 +56,34 @@ using namespace facebook::react;
     // Always dispatch to main: the SDK may post this from a background queue,
     // and createGamificationEmbedView is a UIKit/MainActor call.
     dispatch_async(dispatch_get_main_queue(), ^{
+        // Fabric keeps unmounted component views alive in its recycle pool, and a pooled view is
+        // still a registered observer here. It must NOT rebuild: every successful
+        // createGamificationEmbedView records an impression against the entry point's display count
+        // (conditions.showCount.count), so an off-screen pooled view would silently burn the cap and
+        // the embed would vanish for real users far sooner than configured. A mounted view always
+        // has a superview; a pooled one never does (Fabric asserts this when enqueueing).
+        if (self.superview == nil) {
+            return;
+        }
         self->_needsEmbedView = YES;
         [self attachEmbedViewIfPossible];
     });
 }
 
+// Fabric recycles component views. RCTViewComponentView's own prepareForRecycle resets the event
+// emitter and react subviews but NOT `contentView`, and setContentView: re-adds it to the container
+// view — so without this a recycled instance keeps the previous mount's EmbedView (a live WKWebView
+// showing an already-rendered campaign). updateProps would then see `contentView != nil` with an
+// unchanged embedId and never ask the SDK again, bypassing the frequency-cap/visibility check
+// entirely and displaying stale content the SDK has decided to hide.
+- (void)prepareForRecycle {
+    self.contentView = nil;
+    _embedId = nil;
+    _needsEmbedView = NO;
+    _retryPending = NO;
+    [super prepareForRecycle];
+}
+
 - (void)updateProps:(const Props::Shared &)props oldProps:(const Props::Shared &)oldProps {
     const auto &newProps = *std::static_pointer_cast<const GamificationEmbedViewProps>(props);
 
@@ -89,7 +112,11 @@ using namespace facebook::react;
     if (!_needsEmbedView || _embedId.length == 0) {
         return;
     }
-    if (CGRectIsEmpty(self.bounds)) {
+    // Only WIDTH has to be laid out: the SDK ignores our bounds entirely (it measures the window)
+    // and seeds the real height back through onHeight. Requiring a non-empty rect would wedge a
+    // surface that has legitimately collapsed to height 0 — it could never rebuild when fresh data
+    // arrives, because its own bounds would stay empty forever.
+    if (self.bounds.size.width <= 0) {
         return;
     }
 
@@ -101,7 +128,11 @@ using namespace facebook::react;
         _needsEmbedView = NO;
         _retryPending = NO;
     } else {
-        NSLog(@"[GamificationEmbed] SDK returned nil — scheduling long fallback");
+        NSLog(@"[GamificationEmbed] SDK returned nil — collapsing and scheduling long fallback");
+        // nil means "do not render this embed now" — hidden, frequency-capped, or no resolved URL.
+        // Drop anything already attached so a previously loaded webview can't outlive that decision.
+        // The SDK has already pushed height 0 through onHeight, so the JS side collapses with us.
+        self.contentView = nil;
         // Don't retry aggressively: the SDK may have entry points loaded but
         // reward/program data not yet ready. The HydraGamificationDataReloaded
         // notification fires when everything is ready and will call us again.

package/ios/GamificationViews/GamificationLoyaltyViewComponentView.mm

@@ -2,10 +2,10 @@
 
 #import "GamificationLoyaltyViewComponentView.h"
 
-#import "../generated/RNHydraLibSpec/ComponentDescriptors.h"
-#import "../generated/RNHydraLibSpec/EventEmitters.h"
-#import "../generated/RNHydraLibSpec/Props.h"
-#import "../generated/RNHydraLibSpec/RCTComponentViewHelpers.h"
+#import <react/renderer/components/RNHydraLibSpec/ComponentDescriptors.h>
+#import <react/renderer/components/RNHydraLibSpec/EventEmitters.h>
+#import <react/renderer/components/RNHydraLibSpec/Props.h>
+#import <react/renderer/components/RNHydraLibSpec/RCTComponentViewHelpers.h>
 #import "RCTFabricComponentsPlugins.h"
 #import <React/RCTBridgeModule.h>
 #import <React/RCTComponentViewFactory.h>
@@ -53,12 +53,37 @@ using namespace facebook::react;
 }
 
 - (void)gamificationDataReloaded {
+    // Always dispatch to main: the SDK may post this from a background queue,
+    // and createGamificationLoyaltyView is a UIKit/MainActor call.
     dispatch_async(dispatch_get_main_queue(), ^{
+        // Fabric keeps unmounted component views alive in its recycle pool, and a pooled view is
+        // still a registered observer here. It must NOT rebuild: every successful
+        // createGamificationLoyaltyView records an impression against the entry point's display count
+        // (conditions.showCount.count), so an off-screen pooled view would silently burn the cap and
+        // the widget would vanish for real users far sooner than configured. A mounted view always
+        // has a superview; a pooled one never does (Fabric asserts this when enqueueing).
+        if (self.superview == nil) {
+            return;
+        }
         self->_needsLoyaltyView = YES;
         [self attachLoyaltyViewIfPossible];
     });
 }
 
+// Fabric recycles component views. RCTViewComponentView's own prepareForRecycle resets the event
+// emitter and react subviews but NOT `contentView`, and setContentView: re-adds it to the container
+// view — so without this a recycled instance keeps the previous mount's loyalty view (a live
+// WKWebView showing an already-rendered campaign). updateProps would then see `contentView != nil`
+// with an unchanged loyaltyId and never ask the SDK again, bypassing the frequency-cap/visibility
+// check entirely and displaying stale content the SDK has decided to hide.
+- (void)prepareForRecycle {
+    self.contentView = nil;
+    _loyaltyId = nil;
+    _needsLoyaltyView = NO;
+    _retryPending = NO;
+    [super prepareForRecycle];
+}
+
 - (void)updateProps:(const Props::Shared &)props oldProps:(const Props::Shared &)oldProps {
     const auto &newProps = *std::static_pointer_cast<const GamificationLoyaltyViewProps>(props);
 
@@ -85,16 +110,31 @@ using namespace facebook::react;
     if (!_needsLoyaltyView || _loyaltyId.length == 0) {
         return;
     }
-    if (CGRectIsEmpty(self.bounds)) {
+    // Only WIDTH has to be laid out: the SDK ignores our bounds entirely (it measures the window)
+    // and seeds the real height back through onHeight. Requiring a non-empty rect would wedge a
+    // surface that has legitimately collapsed to height 0 — it could never rebuild when fresh data
+    // arrives, because its own bounds would stay empty forever.
+    if (self.bounds.size.width <= 0) {
         return;
     }
 
+    NSLog(@"[GamificationLoyalty] trying createGamificationLoyaltyView(loyaltyId=%@)", _loyaltyId);
     UIView *loyaltyView = [[HydraSDKCore shared] createGamificationLoyaltyViewWithLoyaltyId:_loyaltyId];
     if (loyaltyView) {
+        NSLog(@"[GamificationLoyalty] loyalty view created OK");
         self.contentView = loyaltyView;
         _needsLoyaltyView = NO;
         _retryPending = NO;
     } else {
+        NSLog(@"[GamificationLoyalty] SDK returned nil — collapsing and scheduling long fallback");
+        // nil means "do not render this now" — hidden, frequency-capped, or no resolved URL.
+        // Drop anything already attached so a previously loaded webview can't outlive that decision.
+        // The SDK has already pushed height 0 through onHeight, so the JS side collapses with us.
+        self.contentView = nil;
+        // Don't retry aggressively: the SDK may have entry points loaded but
+        // reward/program data not yet ready. The HydraGamificationDataReloaded
+        // notification fires when everything is ready and will call us again.
+        // This 5-second fallback only fires if that notification is missed.
         [self scheduleFallbackRetry];
     }
 }

package/ios/HydraLib.h

@@ -1,11 +1,10 @@
 #import <React/RCTEventEmitter.h>
 
 #ifdef RCT_NEW_ARCH_ENABLED
-#ifdef RN_VERSION_BELOW_76
+// Codegen output is generated by the consuming app's own build against its own
+// React Native version, and exposed on the header search path by the
+// ReactCodegen pod - this package no longer ships a pre-generated copy.
 #import <RNHydraLibSpec/RNHydraLibSpec.h>
-#else
-#import "generated/RNHydraLibSpec/RNHydraLibSpec.h"
-#endif
 @interface HydraLib : RCTEventEmitter <NativeHydraLibSpec>
 #else
 #import <React/RCTBridgeModule.h>

package/ios/HydraLib.mm

@@ -194,6 +194,22 @@ RCT_EXPORT_METHOD(reportMessageRating:(nonnull NSDictionary *)message rating:(do
   [[HydraSDKCore shared] setCapToken:token resolve:resolve reject:reject];
 }
 
+- (void)setGamificationSuppressed:(BOOL)suppressed resolve:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject {
+  [[HydraSDKCore shared] setGamificationSuppressed:suppressed resolve:resolve reject:reject];
+}
+
+- (void)isGamificationSuppressed:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject {
+  [[HydraSDKCore shared] isGamificationSuppressed:resolve reject:reject];
+}
+
+- (void)setThemeMode:(nonnull NSString *)mode resolve:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject {
+  [[HydraSDKCore shared] setThemeMode:mode resolve:resolve reject:reject];
+}
+
+- (void)getThemeMode:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject {
+  [[HydraSDKCore shared] getThemeMode:resolve reject:reject];
+}
+
 
 
 #ifdef RCT_NEW_ARCH_ENABLED

package/ios/HydraSDK/HydraInAppMessages.swift

@@ -60,22 +60,49 @@ import React
 //    }
   }
   
+  // NOTE: these four methods do not yet call into a corresponding HydraCore/HydraInAppMessage
+  // report API (unlike the Android side, which calls HydraInAppUIHelper...reportInAppMessage*).
+  // The logging/resolve/reject below only makes failures visible and stops the RN promise
+  // from hanging forever — it does not report the click/dismiss/rating/feedback to the SDK.
+
   @objc public func reportMessageClicked(_ message: [String: Any]?, resolve : RCTPromiseResolveBlock?, reject : RCTPromiseRejectBlock?)  -> Void{
-    if let payload = message?["nativeJsonPayload"] as? [String: Any]{
-      Logger.debug("HydraInAppMessages.reportMessageClicked payload = \(payload)")
+    guard let payload = message?["nativeJsonPayload"] as? [String: Any] else {
+      Logger.error("HydraInAppMessages: reportMessageClicked: message is nil or missing nativeJsonPayload")
+      reject?("Error", "message is nil or missing nativeJsonPayload", nil)
+      return
     }
+    Logger.debug("HydraInAppMessages.reportMessageClicked payload = \(payload)")
+    resolve?(true)
   }
-  
+
   @objc public func reportMessageDismissed(_ message: [String: Any]?, resolve : RCTPromiseResolveBlock?, reject : RCTPromiseRejectBlock?)  -> Void{
-    
+    guard let payload = message?["nativeJsonPayload"] as? [String: Any] else {
+      Logger.error("HydraInAppMessages: reportMessageDismissed: message is nil or missing nativeJsonPayload")
+      reject?("Error", "message is nil or missing nativeJsonPayload", nil)
+      return
+    }
+    Logger.debug("HydraInAppMessages.reportMessageDismissed payload = \(payload)")
+    resolve?(true)
   }
-  
+
   @objc public func reportMessageRating(_ message: [String: Any]?, rating: Double, resolve : RCTPromiseResolveBlock?, reject : RCTPromiseRejectBlock?)  -> Void{
-    
+    guard let payload = message?["nativeJsonPayload"] as? [String: Any] else {
+      Logger.error("HydraInAppMessages: reportMessageRating: message is nil or missing nativeJsonPayload")
+      reject?("Error", "message is nil or missing nativeJsonPayload", nil)
+      return
+    }
+    Logger.debug("HydraInAppMessages.reportMessageRating payload = \(payload), rating = \(rating)")
+    resolve?(true)
   }
-  
+
   @objc public func reportMessageFeedback(_ message: [String: Any]?, feedback: String, feedbackOptions: [String], resolve : RCTPromiseResolveBlock?, reject : RCTPromiseRejectBlock?)  -> Void{
-    
+    guard let payload = message?["nativeJsonPayload"] as? [String: Any] else {
+      Logger.error("HydraInAppMessages: reportMessageFeedback: message is nil or missing nativeJsonPayload")
+      reject?("Error", "message is nil or missing nativeJsonPayload", nil)
+      return
+    }
+    Logger.debug("HydraInAppMessages.reportMessageFeedback payload = \(payload), feedback = \(feedback), feedbackOptions = \(feedbackOptions)")
+    resolve?(true)
   }
 }