@@ -5,6 +5,37 @@ All notable changes to this project will be documented in this file.
55The format is based on [ Keep a Changelog] ( https://keepachangelog.com/en/1.0.0/ ) ,
66and this project adheres to [ Semantic Versioning] ( https://semver.org/spec/v2.0.0.html ) .
77
8+ ## [ 1.4.0] - 2025-01-24
9+
10+ ### Added
11+ - ** 🎥 Microsoft Clarity Integration** : Complete integration with official Clarity Flutter SDK for behavioral analytics
12+ - ** EngineClarityConfig** : Configuration class for Microsoft Clarity with Project ID, User ID, and LogLevel support
13+ - ** Masking Widgets** : ` EngineMaskWidget ` and ` EngineUnmaskWidget ` for protecting sensitive content
14+ - ** Example App** : Complete example demonstrating Clarity integration with masking examples
15+
16+ ### Enhanced
17+ #### Microsoft Clarity Features
18+ - ** Session Recordings** : Automatic capture of user sessions for replay
19+ - ** Heatmaps** : Visual representation of user interactions
20+ - ** User Insights** : Automatic detection of rage taps, dead taps, excessive scrolling
21+ - ** Auto-tracking** : Automatic capture of navigation and user interactions
22+ - ** Zero Configuration Events** : No manual event logging needed - Clarity captures automatically
23+
24+ #### Architecture Updates
25+ - ** EngineAnalyticsModel** : Added ` clarityConfig ` property for Clarity configuration
26+ - ** EngineAnalytics** : Added ` isClarityInitialized `
27+ - ** Widget Exports** : Added Clarity masking widgets to widget exports
28+ - ** Adapter Pattern** : Adapted Clarity's unique widget-based initialization to Engine Tracking architecture
29+
30+ ### Dependencies
31+ - ** clarity_flutter: ^1.0.0** : Official Microsoft Clarity Flutter SDK
32+
33+ ### Technical Details
34+ - ** Unique Implementation** : Clarity requires wrapping the app with ClarityWidget instead of static methods
35+ - ** LogLevel Support** : Automatic production optimization (LogLevel.None in release builds)
36+ - ** User ID Validation** : Base-36 format validation for Clarity user IDs
37+ - ** Session Recording** : ~ 30 minutes for real-time viewing, ~ 2 hours for complete processing
38+
839## [ 1.3.0] - 2025-01-23
940
1041### Added
0 commit comments