feat(example/ios): differentiate silent from standard push with content-available (#333)

* feat(example/ios): differentiate pure silent push from standard push with content-available

didReceiveRemoteNotification fires for both pure silent pushes and
standard pushes with content-available. Add the delegate method with
differentiation: only pure silent pushes (no aps.alert) are forwarded
to PushNotificationsHelper.handleSilentPush for background processing.

Standard pushes with content-available are left to willPresent/didReceive.
Shows a debug alert when isDebug=YES, consistent with existing pattern.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

* chore: add NSLog for content-avail push

Author: aahiltn

example/ios/KlaviyoReactNativeSdkExample/AppDelegate.mm

@@ -184,6 +184,44 @@ - (void)applicationDidBecomeActive:(UIApplication *)application {
   [PushNotificationsHelper updateBadgeCount:0];
 }
 
+// iOS Installation Step 15: Handle silent push notifications (content-available: 1).
+// This method fires for both pure silent pushes and standard pushes that carry
+// content-available. Only forward pure silent pushes (no aps.alert) for background
+// processing — standard pushes are handled by willPresent/didReceive.
+- (void)application:(UIApplication *)application
+    didReceiveRemoteNotification:(NSDictionary *)userInfo
+          fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
+  NSDictionary *apsPayload = userInfo[@"aps"];
+  BOOL hasVisibleContent = apsPayload[@"alert"] != nil;
+
+  if (!hasVisibleContent) {
+    [PushNotificationsHelper handleSilentPushWithUserInfo:userInfo];
+
+    if (isDebug) {
+      NSString *payload = [NSString stringWithFormat:@"%@", userInfo];
+      UIAlertController *alert = [UIAlertController
+          alertControllerWithTitle:@"Silent Push Received"
+                           message:payload
+                    preferredStyle:UIAlertControllerStyleAlert];
+      [alert addAction:[UIAlertAction actionWithTitle:@"OK"
+                                                style:UIAlertActionStyleDefault
+                                              handler:nil]];
+      [self.window.rootViewController presentViewController:alert
+                                                   animated:YES
+                                                 completion:nil];
+    }
+  } else if (apsPayload[@"content-available"]) {
+    if (isDebug) {
+      NSLog(@"Standard Push with Background Processing: %@", userInfo);
+    }
+  }
+
+  // You MUST call the completion handler within ~30 seconds.
+  // Failing to do so will cause iOS to throttle or stop delivering
+  // silent push notifications to your app.
+  completionHandler(UIBackgroundFetchResultNewData);
+}
+
 // iOS Installation Step 16: call this method from
 // `application:didFinishLaunchingWithOptions:` before calling the super class
 // method with the launch arguments. This is a workaround for a react issue

example/ios/KlaviyoReactNativeSdkExample/PushNotificationsHelper.swift

@@ -40,6 +40,12 @@ class PushNotificationsHelper: NSObject {
     KlaviyoSDK().set(pushToken: token)
   }
 
+  @objc
+  static func handleSilentPush(userInfo: NSDictionary) {
+    NSLog("[Klaviyo] Silent push received: %@", userInfo)
+    // Perform background work here, e.g. prefetch content or sync state.
+  }
+
   @objc
   static func handleReceivingPush(
     response: UNNotificationResponse,