saafe_aa_sdk 1.0.0

Flutter SDK for integrating SAAFE's secure authentication and financial experience

Changelog

1.0.0

⚠️ BREAKING CHANGES

• Client-controlled navigation: SDK no longer auto-closes after callbacks. Client apps must handle navigation using Navigator.of(context).pop() in callback handlers
• Enhanced callback data structure: Callbacks now return structured JSON data instead of simple strings

🚀 New Features

• New SAAFE TSP API Integration: Added support for new login + consent generation API flow
• Enhanced Callback Handling:
  • Structured callback data for AA flow events (approved/rejected)
  • Detailed error callback data with error codes, types, and stack traces
  • Support for consent approval and rejection with detailed metadata
• Advanced Theme Support:
  • Automatic system brightness detection for dark/light mode
  • Theme-based safe area styling (#051923 for dark, #f9fafb for light)
  • Automatic status bar icon color adjustment (white for dark mode, dark for light mode)
• Production-ready Logging: Converted debug prints to debugPrint for production builds

🐛 Bug Fixes

• Fixed JWT token extraction from nested API response structure (data.access_token)
• Fixed parameter extraction from new API response format (data.encode.*)
• Enhanced error handling for API failures and malformed responses
• Improved WebView message parsing with better error recovery

🔧 Improvements

• Better API error handling with structured error responses
• Enhanced JavaScript message handling in WebView
• Improved WebView cleanup and resource management
• More robust parameter validation and extraction
• Better debugging with conditional logging in development mode

📚 Documentation

• Updated README with new API integration examples
• Added comprehensive callback handling documentation
• Enhanced theme support documentation
• Added client-controlled navigation examples

0.1.6

• Added postMessage event handling for flow completion from parent application
• Added customizable display modes: bottom sheet (default) and full page with left-to-right transition
• Added option to show/hide close button (showCloseButton parameter)
• Enhanced WebView with better JavaScript integration
• Updated example app to demonstrate new features
• Improved documentation with detailed usage examples

0.1.5

• Added environment switching capability with useSandbox flag
• Added dedicated URLs for sandbox (https://stage-redirection.saafe.in/login) and production (https://app-redirection.saafe.in/login)
• Enhanced example app with environment toggle
• Improved documentation for environment configuration

0.1.4

• Improved WebView resolution and text rendering
• Added optimized font smoothing and text legibility settings
• Disabled zoom to prevent scaling artifacts
• Updated mobile user-agent for better compatibility
• Updated documentation with detailed integration guide

0.1.3

• Added intelligent external URL handling with fallbacks
• Improved error dialogs with copy-to-clipboard functionality
• Enhanced platform detection for iOS, Android and Flutter
• Fixed bugs in the WebView navigation delegate

0.1.2

• Added theme support (light, dark, system)
• Improved WebView modal appearance with drag handle
• Added confirmation dialog when closing flows
• Fixed keyboard handling and screen insets

0.1.1

• Improved portrait orientation locking during flows
• Added better error handling and logging
• Fixed minor UI issues in dialogs
• Enhanced callback support

1.0.0

• First stable release
• iOS-like modal transitions
• Improved keyboard handling
• Modern confirmation dialogs
• Fixed gesture detection for better WebView scrolling
• Absolute positioned close button
• Memory optimizations and bug fixes

0.1.0

• Initial release
• Core WebView integration with SAAFE platform
• Dialog-based display
• Support for message handling
• Callback support for success, error, load, and cancel events