synheart_session 0.3.0

Flutter SDK for live HR/HRV session tracking — typed event streams driven by pluggable biosignal and behavior providers.

Changelog

All notable changes to this package will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.3.0 - 2026-09-25

Minor bump, not a patch: a new SessionMode value breaks an exhaustive switch over it in Dart 3.

Added

• SessionMode.typing ("typing").

Fixed

• Android: the watch message listener is held only while a session runs. WatchSessionRelay registered its MessageClient listener in its constructor and removed it only on dispose, so a relay received watch messages when no session was active. The listener is now added by startSession and removed when the session ends (stop, end from the watch, or dispose).

0.2.0 - 2026-05-06

Initial open-source release of the Synheart Session SDK for Flutter.

The SDK runs a live session engine that consumes a BiosignalProvider (any HR/HRV source — synheart_wear, a BLE HRM, an Apple Watch relay, or your own implementation) and an optional BehaviorProvider, then emits typed session events: SessionStarted, BiosignalFrame, SessionFrame, SessionSummary, SessionError.

Public surface

• SynheartSession facade with live and mock constructors.
• LiveSessionEngine — Dart-side engine driving real HR data through a circular buffer with SDNN/RMSSD computed from real RR intervals.
• BiosignalProvider / BehaviorProvider abstractions for pluggable inputs. MockBiosignalProvider (sinusoidal BPM at 1 Hz) and MockBehaviorProvider ship for local development.
• WatchBiosignalProvider for relaying HR from a paired Apple Watch via WCSession.
• Configurable ComputeProfile (window size, emit interval).
• iOS plugin (SynheartSessionPlugin.swift) and Android plugin (SynheartSessionPlugin.kt + WatchSessionRelay.kt) implement the watch relay over WCSession and the Wearable Data Layer MessageClient.

Platform support

• iOS 13.0+
• Android API 21+ (Android 5.0+)
• Flutter 3.22.0+