Added #

• SDK Initialization Validation - Enhanced initialize() method to validate actual wearable data availability
  • Throws NO_WEARABLE_DATA error if no data is available after initialization
  • Throws STALE_DATA error if latest data is older than 24 hours
  • Ensures SDK is truly ready for use with fresh, valid data
• Data Freshness Validation - Added automatic data freshness checks in cloud providers
  • WHOOP: Validates data freshness in connectWithCode() and all fetch() methods
  • Ensures data is within 24 hours, with graceful handling of timezone differences
• Unified Data Format - Cloud providers now return standardized WearMetrics format
  • WHOOP: All fetch() methods now return List<WearMetrics> instead of raw Map<String, dynamic>
  • Consistent bio signal mapping (HR, HRV, steps, calories, distance, stress) across all sources
  • Automatic conversion of provider-specific data structures to unified schema
• Garmin Integration (In Development) - Initial implementation of Garmin cloud provider
  • ⚠️ Status: Pending/Not Fully Functional - Garmin integration is still in development
  • Added requestBackfill() method structure for requesting historical Garmin data via webhooks
  • Added data freshness validation structure in handleDeepLinkCallback() and fetch() methods
  • Added data format conversion to WearMetrics structure
  • Note: Garmin features are experimental and may not be fully functional yet

Changed #

• License - Updated from MIT License to Apache License 2.0
  • Updated LICENSE file with complete Apache 2.0 text
  • Updated pubspec.yaml license field to Apache-2.0
  • Updated README badge to reflect Apache 2.0 license
• Garmin OAuth URL (In Development) - Updated OAuth authorization URL to use configurable baseUrl
  • getAuthorizationUrl() now uses $baseUrl/v1/garmin/oauth/authorize instead of hardcoded URL
  • ⚠️ Note: Garmin integration is still pending/not fully functional
• Enhanced Logging - Improved initialization validation logging with emoji indicators for better visibility
  • Uses logWarning() for critical validation messages (visible by default)
  • Added data age and freshness indicators in logs
• Cloud Provider Data Conversion - Internal refactoring for consistent data handling
  • Added helper methods: _convertToWearMetricsList(), _convertSingleItemToWearMetrics(), _toNum()
  • Improved timestamp extraction and parsing across multiple formats (ISO strings, Unix seconds/milliseconds)
  • Better error handling for malformed API responses

Fixed #

• Timezone Handling - Fixed negative data age calculation when timestamps are slightly in the future
  • Detects and handles timezone differences gracefully
  • Logs appropriate warnings for future timestamps without failing validation
• CI Workflow - Fixed Dart SDK version mismatch in GitHub Actions
  • Updated flutter-version from 3.32.0 to 3.30.0 to match Dart SDK requirements

Added #

• Comprehensive dartdoc documentation for all public APIs
• Documentation for all public classes, enums, and methods
• Enhanced enum documentation with detailed descriptions

Changed #

• Improved documentation coverage across the entire SDK
• Updated LICENSE file with complete MIT License text

Fixed #

• Fixed incomplete LICENSE file
• Added missing documentation to error classes (PermissionDeniedError, DeviceUnavailableError, NetworkError)
• Added missing documentation to adapter classes (WearAdapter, FitbitAdapter, AppleHealthKitAdapter)
• Added missing documentation to provider classes (WhoopProvider, SwipHooks)
• Added documentation to all enum values (DeviceAdapter, ConsentStatus, PermissionType, MetricType)
• Added repository field to pubspec.yaml for better pub.dev scoring

Added #

• Initial release of synheart_wear package
• Apple HealthKit integration for iOS
• Support for multiple health metrics: heart rate (HR), heart rate variability (HRV), steps, calories
• Real-time data streaming capabilities
• Local encrypted caching for offline data persistence
• Unified data schema following the Synheart RFC specification
• Permission management system
• Data normalization engine for multi-device support
• Example Flutter app demonstrating SDK usage

Features #

• Cross-platform support (iOS and Android)
• Real-time HR and HRV streaming
• Consent-based data access
• AES-256-CBC encryption for local storage
• Automatic data quality validation
• Support for both RMSSD and SDNN HRV metrics

Platform Support #

• iOS: Full support via HealthKit integration
• Android: Under development

Added #

• Whoop Integration - Full REST API integration for Whoop devices (iOS/Android)
  • OAuth 2.0 authentication flow
  • Real-time data fetching (cycles, recovery, sleep, workouts)
  • User ID persistence and configuration management
• Health Connect/HealthKit Integration - Native platform health data access
  • Health Connect support for Android (via health package v13.2.1)
  • HealthKit support for iOS
  • Unified adapter for both platforms (AppleHealthKitAdapter)
  • Support for HR, HRV, steps, calories, and distance metrics
• Distance metric support across both iOS and Android platforms
  • iOS: DISTANCE_WALKING_RUNNING via HealthKit
  • Android: DISTANCE_DELTA via Health Connect
• Platform configuration documentation (AndroidManifest.xml and Info.plist setup)
• Comprehensive platform configuration section in README
• WidgetsFlutterBinding.ensureInitialized() in code examples
• Improved README with collapsible sections for better readability
• Enhanced library documentation with concise, professional formatting

Changed #

• Health adapter now supports both HealthKit (iOS) and Health Connect (Android)
• Distance handling now supports both iOS (DISTANCE_WALKING_RUNNING) and Android (DISTANCE_DELTA)
• Updated HealthAdapter to properly map distance types per platform
• Enhanced AppleHealthKitAdapter to include distance in Android supported permissions
• Improved error messages and logging throughout the SDK (replaced all print() with proper logger)
• README restructured for better readability and scannability (reduced from 648 to 454 lines)
• Library documentation streamlined and made more concise
• Replaced all print() statements with SynheartLogger for production-ready logging

Fixed #

• Distance data retrieval on Android via Health Connect (now uses DISTANCE_DELTA)
• Unit conversion for distance metrics (properly handles meters, km, miles, feet, yards)
• Missing distance case in HealthAdapter conversion logic
• Platform-specific permission handling for distance on Android

Documentation #

• Added comprehensive platform configuration guide
• Added field descriptions table for data schema
• Added platform limitations section
• Improved code examples with proper initialization
• Enhanced API documentation with better structure