Synheart Wear - Swift/iOS SDK

dependencies: [
    .package(url: "https://github.com/synheart-ai/synheart-wear-swift.git", from: "0.4.3")
]

<key>NSHealthShareUsageDescription</key>
<string>We need access to your health data</string>

import SynheartWear

let config = SynheartWearConfig(
    enabledAdapters: [.platformHealth],
    enableLocalCaching: true
)

let synheartWear = SynheartWear(config: config)

Task {
    try await synheartWear.initialize()

    // Shows the HealthKit permission sheet
    _ = try await synheartWear.requestPermissions([.heartRate, .steps, .calories])

    let metrics = try await synheartWear.readMetrics()
    print("Heart Rate: \(metrics.getMetric(.hr) ?? 0) bpm")
}

import Combine

var cancellables = Set<AnyCancellable>()

synheartWear.streamHR(interval: 5.0)
    .sink(
        receiveCompletion: { _ in },
        receiveValue: { metrics in
            if let hr = metrics.getMetric(.hr) {
                print("Current HR: \(hr) bpm")
            }
        }
    )
    .store(in: &cancellables)

// HRV over a rolling window: streamHRV(window: 5.0)

// Async/await alternative:
Task {
    for await metrics in synheartWear.streamHRAsync(interval: 5.0) {
        if let hr = metrics.getMetric(.hr) {
            print("Current HR: \(hr) bpm")
        }
    }
}

<key>NSBluetoothAlwaysUsageDescription</key>
<string>This app uses Bluetooth to connect to heart rate monitors.</string>

import SynheartWear

let config = SynheartWearConfig(enabledAdapters: [.bleHrm])
let synheartWear = SynheartWear(config: config)

// The BLE HRM provider exists once .bleHrm is enabled
guard let bleHrm = synheartWear.bleHrm else { return }

// Scan for nearby HR monitors (default timeout 10 s)
let devices = try await bleHrm.scan(timeoutMs: 10000, namePrefix: "Polar")
guard let device = devices.first else { return }

try await bleHrm.connect(deviceId: device.deviceId, sessionId: "my-session")

// onHeartRate doesn't finish on its own: read it in its own task
let reader = Task {
    for await sample in bleHrm.onHeartRate {
        print("BPM: \(sample.bpm)")
        if let rr = sample.rrIntervalsMs {
            print("RR: \(rr)")
        }
    }
}

// Later, when you're done:
reader.cancel()
try await bleHrm.disconnect()

let config = SynheartWearConfig(
    enabledAdapters: [.platformHealth, .whoop, .garmin, .fitbit, .oura],
    appId: "your-app-id",
    redirectUri: "yourapp://oauth/callback"
    // baseUrl: optional override of the Synheart Wear API
)
let synheartWear = SynheartWear(config: config)

let whoop = try synheartWear.getProvider(.whoop)   // no typed accessor for WHOOP
let garmin: GarminProvider? = synheartWear.garmin
let fitbit: FitbitProvider? = synheartWear.fitbit
let oura:   OuraProvider?   = synheartWear.oura

let reader = HealthKitHistoryReader()
let end = Date()
let start = Calendar.current.date(byAdding: .day, value: -14, to: end)!

let nights = try await reader.fetchSleepNights(start: start, end: end, timeZone: .current)
let physiology = try await reader.fetchOvernightPhysiology(start: start, end: end, timeZone: .current)

import SynheartWear

let xmlURL: URL = ...   // path to unzipped export.xml

let importer = AppleHealthXmlImport(
    xmlURL: xmlURL,
    sink: MyIngestSink()  // conforms to AppleXmlIngestSink
)
// Synchronous: run it off the main thread
let result = try importer.parse(progress: { fraction in print(fraction) })
print("imported \(result.inserted) of \(result.totalSamples) samples")

import SynheartWear

let garmin = GarminHealth(licenseKey: "your-garmin-sdk-key")
try await garmin.initialize()
let synheartWear = SynheartWear(config: config, garminHealth: garmin)

// The stream doesn't finish on its own: read it in its own task
let scan = Task {
    for await devices in garmin.scannedDevicesStream() {
        print("Found \(devices.count) devices")
    }
}
try await garmin.startScanning(timeoutSeconds: 30)

// Once the user picks a device:
let paired = try await garmin.pairDevice(scannedDevice)
try await garmin.startStreaming(device: paired)
scan.cancel()