v0.3.4

What's Changed

Features

• Typed response layer (g.typed accessor) — an optional Pydantic namespace that wraps high-value read endpoints with validated, IDE-friendly models. Requires pydantic>=2.0; zero impact on existing users.

  pip install garminconnect[typed]

  g = Garmin(email, password)
  raw   = g.get_stats(date)         # dict[str, Any] — unchanged
  stats = g.typed.get_stats(date)   # DailyStats (Pydantic model)
  print(stats.total_steps, stats.resting_heart_rate)

  Supported methods in this release:

  Method	Typed return
  get_stats, get_user_summary	DailyStats
  get_sleep_data	SleepData
  get_hrv_data	HrvData | None
  get_body_battery	list[BodyBatteryEntry]
  get_training_readiness	list[TrainingReadiness]
  get_activities_by_date	list[Activity]

  Validation failures raise GarminConnectResponseValidationError with .raw preserved. Extra/missing fields are tolerated so schema drift doesn't break running apps. Marked experimental — the surface may evolve based on feedback.

Bug Fixes

• CN account token refresh — DI OAuth2 token endpoint now routes to diauth.garmin.cn for is_cn=True accounts. Previously the .com endpoint was always used, causing refresh failures (invalid_grant) after the ~4-hour access token TTL expired. Cron-driven sync jobs and long-running sessions on CN accounts are now fixed. (PR #360 by @MidnightV1)

Contributors

• @sorlen008 — typed namespace implementation
• @MidnightV1 — CN DI token endpoint fix

Full Changelog: v0.3.3...v0.3.4

Release 0.3.3

What's Changed

Performance

• Persistent HTTP session reuse across API calls (avoids repeated connection overhead)
• Retries enabled by default (retry_attempts=3 with exponential backoff for transient errors)

Fixes

• Correct sportTypeId for swimming workouts
• Ruff and mypy CI clean (0 errors)

Misc / Tooling

• Added -debug / -d flag on demo script for timing and HTTP visibility
• Python 3.12 minimum; tooling and workout models modernized
• Expanded mocked unit test coverage (~30 new tests)

Release 0.3.2

What's Changed

Features

• 5-strategy cascading login added
• MFA dual-endpoint fallback: tries both /mobile and /portal MFA verify endpoints
• Add get_scheduled_workouts API method (PR #343 by @hab)

Fixes

• Fix validation error message
• Fix mypy return type for _http_post

Style

• Apply ruff format fixes

Release 0.3.1

What's new

• Token file save bug fixed #342 by @0mlml
• Cleanup unused tokens usage/storage

Full Changelog: 0.3.0...0.3.1

Release 0.3.0

v0.3.0 — Native Authentication

This release replaces the garth dependency with a native authentication engine that uses the same mobile SSO flow as the official Garmin Connect app.

What's new

• Native DI OAuth authentication — Login, token exchange, and auto-refresh are handled internally.
• Cloudflare bypass — multiple TLS impersonation strategies (Safari, Chrome, Edge via curl_cffi) to work around Garmin's Cloudflare blocking of programmatic logins.
• Automatic token refresh — DI OAuth tokens refresh seamlessly in the background. Once logged in, sessions persist indefinitely.
• Random browser fingerprinting — login requests use randomized browser identities to avoid detection.
• New methods: delete_workout(), unschedule_workout() (#341)
• Golf API fix — golf endpoints now work correctly (#320, thanks @rcloran)
• Workout constant fix — TargetType.HEART_RATE now maps to the correct Garmin API value (#333)
• Regression tests for workout constants to prevent future drift (thanks @ayazhankadessova, PR #340)
• Added descriptions to workouts by @miki134 in #339

Breaking changes

• Saved tokens from previous versions are not compatible. A fresh login is required after upgrading.
• New token format stored as garmin_tokens.json in ~/.garminconnect/.
• New dependencies: curl_cffi, ua-generator.

Install

pip install --upgrade garminconnect curl_cffi ua-generator

Full Changelog: https://github.com/cyberjunky/python-garminconnect/commits/0.3.0

Release 0.2.40

What's Changed

• Added get_running_tolerance method for #328

Full Changelog: 0.2.29...0.2.40

Release 0.2.39

What's Changed

• Update garth requirement from <0.6.0,>=0.5.17 to >=0.5.17,<0.7.0 by @dependabot[bot] in #319
• Bump actions/upload-artifact from 6 to 7 by @dependabot[bot] in #326
• Fixed linting in demo.py by @BernatNicolau in #325
• Add workout scheduling by @Skydler in #327
• Added nutrition service endpoints for daily food, meals, and settings by @KopyWasTaken in #323
• Added our first Golf related endpoints (see menu demo.py)
• Added import_activity method for uploads without Strava re-export

New Contributors

• @BernatNicolau made their first contribution in #325
• @Skydler made their first contribution in #327
• @KopyWasTaken made their first contribution in #323

Full Changelog: 0.2.38...0.2.29

Release 0.2.38

What's Changed

• Stricter linting and fixes
• Added get morning training readiness
• Fixed demo menu numbering issue
• Fixed get goals parameters not accepting '0'
• Added Weekly Steps, Weekly Stress and Weekly Intensity Minutes

Full Changelog: 0.2.37...0.2.38

Release 0.2.37

What's Changed

• Fixed possible MFA race condition
• Bump actions/upload-artifact from 5 to 6 by @dependabot[bot] in #314
• Fix maxpoly arg to get_activity_details() to allow 0 value by @puntonim in #313
• Added time in power zones for activities by @SebastianBurmester in #316

New Contributors

• @puntonim made their first contribution in #313
• @SebastianBurmester made their first contribution in #316

Full Changelog: 0.2.36...0.2.37

Release 0.2.36

What's Changed

• Added methods for uploading workouts, also see demo.py menu option 5.

Full Changelog: 0.2.35...0.2.36