axeptio_sdk

See CHANGELOG.md for full release notes.

🚨 Breaking Changes

• navigatorKey is now required for the consent UI to function. Set it before calling initialize:

  AxeptioSdk.navigatorKey = GlobalKey<NavigatorState>();
  // Pass it to MaterialApp:
  MaterialApp(navigatorKey: AxeptioSdk.navigatorKey, ...)
  

• Native iOS and Android Axeptio SDKs have been removed. Consent is now managed entirely through a pure Flutter WebView implementation. No Maven credentials or CocoaPods setup is required.
• The _ax_token SharedPreferences key is replaced by AX_CLIENT_TOKEN. Existing stored tokens are read transparently during migration.
• MethodChannelAxeptioSdk removed from public API (was deprecated)
• showConsentScreen() / setupUI() now throw AxeptioNotInitializedException instead of returning silently
• AxeptioEventListener has new onError callback for async error notification

✨ New Features

• Native iOS WKWebView: Replace webview_flutter with native WKWebView PlatformView for reliable JS injection timing
• Android consent webview: Add Android support using webview_flutter with JS channel bridge and polyfill
• Typed exception hierarchy: AxeptioNotInitializedException, AxeptioConsentException, AxeptioNetworkException, AxeptioStorageException — replaces 27 silent error sites
• JS bridge message parser: Critical consent parsing logic extracted into testable JsBridgeMessageParser with per-event schema validation
• WebView network failure detection: onWebResourceError/onHttpError routed through AxeptioEventListener.onError

🔧 Fixes

• Inject localStorage values in onPageStarted (before page scripts run) instead of onPageFinished
• appendAxeptioTokenURL now only appends axeptio_token, not clientId/cookiesVersion
• showConsentScreen now awaits until the consent screen is dismissed
• AxeptioSdk.navigatorKey setter rejects null (throws ArgumentError)
• Transparent route overlay for consent webview on both platforms
• Handle unsupported platforms (web, macOS, Linux, Windows) with error callback and route close
• Defer Google Mobile Ads initialization in example app to prevent Dart event loop freeze
• Use nonPersistent data store on iOS for fresh consent state each load
• Restrict WebView navigation to consent host only (matching iOS behavior)
• Reset script injection flag on each navigation for proper re-injection

🗑 Removed

• Deleted deprecated MethodChannelAxeptioSdk (210 lines)
• Deleted native event stream handlers (iOS/Android) and ModelHelper stub

3.0.0-beta.2

✨ New Features

• Native iOS WKWebView: Replace webview_flutter with native WKWebView PlatformView for reliable JS injection timing
• Android consent webview: Add Android support using webview_flutter with JS channel bridge and polyfill

🔧 Fixes

• Transparent route overlay for consent webview on both platforms
• Handle unsupported platforms (web, macOS, Linux, Windows) with error callback and route close
• Defer Google Mobile Ads initialization in example app to prevent Dart event loop freeze
• Use nonPersistent data store on iOS for fresh consent state each load
• Restrict WebView navigation to consent host only (matching iOS behavior)
• Reset script injection flag on each navigation for proper re-injection

📊 Quality

• 378 tests, 95.1% coverage

v3.0.0-beta.1

First beta of the v3 pure Flutter WebView implementation, including SDK hardening.

Highlights

• Pure Flutter WebView — native iOS/Android SDKs replaced with WebView-based consent UI
• Typed exception hierarchy — AxeptioNotInitializedException, AxeptioConsentException, AxeptioNetworkException, AxeptioStorageException
• JS bridge hardening — message parser extracted and validated per-event schema
• Network failure detection — WebView errors surfaced via AxeptioEventListener.onError
• 343 tests, 94%+ coverage

Breaking Changes

• navigatorKey must be set before initialize()
• Native SDKs removed — no Maven/CocoaPods setup needed
• MethodChannelAxeptioSdk removed from public API
• showConsentScreen() / setupUI() throw instead of returning silently
• Token key migrated from _ax_token to AX_CLIENT_TOKEN (transparent)

See CHANGELOG.md for full details.

What's Changed

• feat: upgrade native SDKs to Android 2.0.9 and iOS 2.0.17 by @pleberre in #86

What's Changed

• feat: Implement Flutter-native GVL service with comprehensive vendor management

Full Changelog: 2.0.17...2.0.18

✨ New Features

• Flutter-Native GVL Service: Complete Global Vendor List integration implemented in pure Dart/Flutter
  • loadGVL(): Download and cache IAB Global Vendor List from https://static.axept.io/gvl/vendor-list.json
  • getVendorName(vendorId): Get individual vendor name by ID with intelligent fallbacks
  • getVendorNames(vendorIds[]): Get multiple vendor names efficiently
  • getVendorConsentsWithNames(): Enhanced consent data combining platform consent with GVL names
  • unloadGVL(), clearGVL(): Memory and cache management for GVL data
  • isGVLLoaded(), getGVLVersion(): Status and version information
• VendorInfo Model: Comprehensive vendor information class with purposes, features, and metadata
• Smart Caching: 7-day local storage with SharedPreferences and automatic cache invalidation
• Zero Native Dependencies: Pure Flutter implementation eliminates platform-specific GVL code

🎛️ Enhanced Example App

• Advanced GVL Management UI: Comprehensive interface for testing all GVL features
• Real-time Vendor Analytics: Live vendor consent visualization with names
• Interactive Controls: Load/unload/clear GVL operations with status feedback
• Performance Monitoring: GVL loading status, version tracking, and error reporting

🧪 Testing Improvements

• 100% Test Success Rate: All 163 tests passing with real GVL API integration
• Real Data Testing: Tests use actual GVL data (1372+ vendors) instead of mocks
• Comprehensive Coverage: Unit, integration, and error handling tests for all GVL features

🔧 Technical Architecture

• HTTP Client Integration: Direct API calls with proper error handling and timeouts
• Memory Optimization: Efficient loading and unloading of large vendor datasets (1372+ vendors)
• Platform Interface Cleanup: Removed complex GVL method signatures from native bridges
• Backward Compatibility: All existing APIs maintained, zero breaking changes

📚 Documentation

• Enhanced README with GVL integration examples
• Comprehensive API documentation for all new methods
• Example app serves as complete integration reference

What's Changed

• feat: comprehensive test coverage improvements for SDK reliability
• feat(example): implement comprehensive TCF vendor management UI (MSK-89)

Full Changelog: 2.0.16...2.0.17

• Update example app with improved user interface and functionality.
• Enhance configuration screen with better validation and user feedback.
• Improve vendor data service with real-time updates and analytics.
• Add comprehensive TCF vendor management UI with detailed consent tracking.
• Enhanced debug information display with proper scrolling and formatting.

What's Changed

• docs: update README table of contents structure and formatting
• fix: resolve vendor API bridge implementation and iOS type casting issues
• fix: implement tag-driven version publishing workflow
• feat(ci): implement manual workflow dispatch for publishing

Full Changelog: 2.0.10...2.0.16

• Implement manual workflow dispatch for publishing workflows.
• Add comprehensive changelog validation to prevent publishing without documentation.
• Align dry-run-publish.yml to use release tag logic instead of pubspec.yaml.
• Update release process to require manual workflow execution for better control.

• Fix iOS bridge type casting issue for vendor consent APIs.
• Resolve 'String' is not subtype of 'Map<dynamic, dynamic>' error in getVendorConsents.
• Add proper handling for [Int: Bool] dictionary conversion in iOS sanitizeForFlutter.
• Improve method channel bridge reliability for TCF vendor APIs.

• Update iOS Axeptio SDK to 2.0.13 and Android SDK to 2.0.7.
• Expose method to fetch vendor consent debug info.

• Update iOS Axeptio SDK to 2.0.13 and Android SDK to 2.0.7.
• Expose method to fetch vendor consent debug info.

• Improved sample app to enable immediate testing of an existing project
• fix an iOS mapping

Docs and sample apps improvements.

Update to iOSAxeptio SDK 2.0.7 and Android SDK 2.0.6

Update to iOSAxeptio SDK 2.0.3 and Android SDK 2.0.2 Brands events fix.

Update to iOSAxeptio SDK 2.0.2 ATT consent bug fix.

Update to Axeptio SDK 2.0.1 Clearing consent and partial consent bug fix.

Updated to Axeptio SDK 2.0.0 Manage brands and publishers configuration

Fix CMP first show on iOS SDK

• Fix xcprivacy in iOS SDK

• First release

• Second alpha

• First alpha