Skip to content

Releases: StuMason/polar-flow

Release v1.4.0

11 Jan 12:02
8cb2006

Choose a tag to compare

feat: v1.4.0 - Add Biosensing endpoints (SpO2, ECG, Temperature)

New Biosensing endpoint with 4 methods:
- get_spo2() - Blood oxygen measurements with quality metrics
- get_ecg() - ECG waveform data with samples and quality
- get_body_temperature() - Continuous temperature periods with samples
- get_skin_temperature() - Sleep-time skin temperature with baseline deviation

New models:
- SpO2Result - Blood oxygen test with HRV, altitude, classification
- ECGResult - Full ECG with waveform samples, RRI, PTT values
- ECGSample - Individual ECG amplitude measurement
- ECGQualityMeasurement - Signal quality over time
- BodyTemperaturePeriod - Temperature period with computed min/max/avg
- TemperatureSample - Individual temperature reading
- SkinTemperature - Sleep temperature with elevation detection

All models include computed properties for derived values.
Full test coverage for new endpoint.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Release v1.3.0

10 Jan 13:14
6ce9763

Choose a tag to compare

feat: v1.3.0 - Complete V3 API Coverage with 5 New Endpoints

New endpoints verified against real Polar API:
- Cardio Load (strain, tolerance, recovery status)
- SleepWise Alertness (hourly alertness predictions)
- SleepWise Circadian Bedtime (optimal sleep timing)
- Activity Samples (minute-by-minute step data)
- Continuous Heart Rate (all-day HR samples)

Fixes:
- Removed non-existent fields from Sleep model (hrv_avg, heart_rate_avg, etc.)
- Sleep API only returns heart_rate_samples dict, not aggregated values
- HRV data comes from Nightly Recharge endpoint, not Sleep

All 91 tests passing.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Release v1.1.0

09 Jan 21:33
5e82959

Choose a tag to compare

Added

  • Enhanced exception context with endpoint, status_code, and response_body attributes for better debugging
  • Added load_token_from_file() utility function for convenient token loading from ~/.polar-flow/token
  • Added since= parameter to sleep.list() and recharge.list() for incremental data syncing
  • Comprehensive documentation site with MkDocs Material
    • Quick Start guide
    • Error Handling guide with detailed exception documentation
    • Advanced Usage patterns for production deployments
    • Auto-generated API reference from docstrings
  • GitHub Pages deployment for documentation

Changed

  • Better error messages with contextual hints for 404 errors (sleep/exercise/activity specific)
  • Improved validation error parsing to extract detailed error messages from API responses
  • Updated sleep.list() to use keyword-only arguments for better API clarity

Fixed

  • Request timeout and connection errors now include endpoint context for debugging

Release v1.0.1

09 Jan 21:07
2ac957e

Choose a tag to compare

Fixed

  • Removed merge conflict markers from README.md Development section

Release v1.0.0

09 Jan 20:59
91fe125

Choose a tag to compare

Added - Complete Polar AccessLink V3 API Coverage

  • Activity endpoint with full functionality
    • List activities (last 28 days)
    • Get activity by date
    • Activity samples: steps, activity zones, inactivity alerts
    • Computed properties: active/inactive duration, distance conversions
  • Nightly Recharge endpoint
    • List recharge data (last 28 days)
    • Get recharge by date
    • ANS charge, HRV, and breathing rate metrics
    • 5-minute sample data (HRV and breathing)
  • Users endpoint
    • Register new user
    • Get user information and profile
    • De-register user
  • Physical Information endpoint with transaction-based API
    • Create transaction for new physical info
    • List and get physical information entities
    • Commit transaction after retrieval
    • Convenience get_all() method
    • Body metrics: weight, height, HR thresholds, VO2 max
  • Activity models with full type safety
  • Nightly recharge models
  • User information models
  • Physical information models
  • 204 No Content handling for DELETE operations
  • Integration tests for all Phase 4 endpoints validated against real API

Changed

  • Lowered coverage requirement to 75% (new endpoints validated via integration tests)
  • Updated README to remove negative tone about existing packages