Mobile Push Notification Opt-In Optimization: Two-Step Pre-Prompts & Contextual Triggers

import { CapEngageMobileSDK, PermissionResult } from '@capengage/react-native-sdk';

// Initialize CapEngage Mobile SDK with custom permission interceptor
export async function requestContextualPushPermission(triggerContext: 'order_completed' | 'price_alert_set') {
  const status = await CapEngageMobileSDK.getNotificationPermissionStatus();
  
  // If already authorized or permanently denied at OS level, handle accordingly
  if (status === 'AUTHORIZED' || status === 'DENIED_BY_SYSTEM') {
    return status;
  }

  // Present tailored two-step in-app pre-permission modal
  const userAgreed = await CapEngageMobileSDK.showCustomPrePrompt({
    modalId: `pre_prompt_${triggerContext}`,
    title: triggerContext === 'order_completed' ? 'Track Your Delivery Live' : 'Get Instant Price Drop Alerts',
    description: 'Enable notifications to receive real-time courier updates, OTPs, and exclusive order tracking.',
    confirmButtonText: 'Enable Live Updates',
    cancelButtonText: 'Maybe Later',
    themeColor: '#4f46e5'
  });

  if (userAgreed) {
    // Fire the native iOS / Android OS runtime permission dialog
    const nativeResult: PermissionResult = await CapEngageMobileSDK.requestNativeSystemPermission();
    
    // Automatically track conversion event to CapEngage CDP
    CapEngageMobileSDK.trackEvent('push_permission_outcome', {
      context: triggerContext,
      accepted: nativeResult === 'GRANTED',
      timestamp: new Date().toISOString()
    });
    
    return nativeResult;
  } else {
    // Log dismissal and schedule cool-down period
    CapEngageMobileSDK.setPromptCoolDown('push_soft_prompt', 14 /* days */);
    return 'DISMISSED_SOFT_PROMPT';
  }
}