flutter_meon_kyc 2.0.4

flutter_meon_kyc: ^2.0.4 copied to clipboard

Fixed #

• Git State Cleanup: Resolved git state warnings for clean package publishing

Improved #

• Final optimizations and code cleanup
• Enhanced package validation

Fixed #

• Critical Session Management Fix: WebView now initializes ONLY AFTER initial logout completes successfully
• Previous session properly cleared before KYC flow starts
• Loading screen displays during logout process

Improved #

• Better async/await handling for initial logout
• Enhanced state management with _webViewInitialized flag
• Matches React Native implementation flow exactly

Added #

• Cookie Storage for Permissions: Camera, microphone, and location permissions are now stored in browser cookies (7 days expiry) in addition to sessionStorage and localStorage for maximum cross-domain compatibility

Fixed #

• Initial Logout Flow: WebView now loads ONLY AFTER initial logout completes successfully, ensuring previous sessions are properly cleared before KYC starts
• Loading state properly managed - shows "Initializing KYC..." until logout is complete

Improved #

• Better persistence of permission states across page reloads and iframes
• Enhanced permission storage with triple redundancy (sessionStorage + localStorage + cookies)
• Improved compatibility with FaceFinder and other IPV systems
• Proper async/await handling for initial logout before WebView initialization

Added #

• Dynamic Permission Control: New parameters enableCameraPermission, enableMicrophonePermission, and enableLocationPermission allow frontend to control which permissions to request for IPV
• IPV White Screen Auto-Fix: Automatically detects and reloads IPV pages that fail to render content (up to 2 attempts) to prevent white screen issues
• Cookie-based Permission Storage: Permissions now stored in cookies (in addition to sessionStorage and localStorage) for better cross-domain persistence

Improved #

• Permission request logic now respects individual permission flags
• Better handling of IPV page load failures with automatic recovery
• Enhanced logging for permission states
• Permissions are now stored in sessionStorage, localStorage, AND cookies (7 days expiry) for maximum compatibility

Added #

• Complete Rewrite: New MeonKYC widget with comprehensive features matching React Native implementation
• Automatic Permission Management: Auto-request camera, microphone, and location permissions
• IPV Detection: Intelligent detection of In-Person Verification steps with automatic permission handling
• Payment Link Support: Native handling of UPI and payment app links (PhonePe, Google Pay, Paytm, BHIM)
• Success Detection: JavaScript-based detection of KYC completion with MutationObserver
• Session Management: Automatic logout on initialization and completion
• Custom Header: Interactive header with back, refresh, and close buttons
• JavaScript Injection: Permission state injection, success detection, and payment handling scripts
• External URL Handling: Automatic opening of external apps and payment links
• Loading States: Comprehensive loading indicators and error screens
• Custom Styling: Support for custom styles (container, header, headerTitle)
• Callback System: onSuccess, onError, and onClose callbacks with detailed data
• Configuration Options: enableIPV, enablePayments, autoRequestPermissions, showHeader
• Dynamic Parameters: Customizable workflow, headerTitle, and baseURL
• Hardware Back Button: Proper Android back button handling with WebView navigation
• HTTP Package: Added for API calls (logout functionality)
• Backward Compatibility: Deprecated SDKCall widget maintained for legacy support

Changed #

• Migrated from basic WebView to feature-rich implementation
• Updated WebView to use modern WebViewController API
• Enhanced error handling with proper user feedback
• Improved logging with detailed debug information
• Better state management with comprehensive flags

Breaking Changes #

• Main widget renamed from SDKCall to MeonKYC (old widget deprecated but still available)
• New parameter structure with callbacks instead of simple navigation
• Requires http package dependency

Migration Guide #

Replace SDKCall with MeonKYC and add callbacks:

// Old
SDKCall(
  companyName: 'company',
  workflowName: 'individual',
)

// New
MeonKYC(
  companyName: 'company',
  workflow: 'individual',
  onSuccess: (data) => handleSuccess(data),
  onError: (error) => handleError(error),
  onClose: () => Navigator.pop(context),
)

Added #

• Added WebView integration.
• Added logging framework to replace print statements.

Fixed #

• Fixed compatibility issues with SurfaceAndroidWebView.