OpenWearablesHealthSDK

Native iOS SDK for secure background health data synchronization from Apple HealthKit to the Open Wearables platform.

Features

• Streaming sync with memory-efficient processing
• Resumable sync sessions (survives app restarts)
• Dual authentication: token-based (with auto-refresh) or API key
• Background execution via HealthKit observer queries and BGTaskScheduler
• Automatic retry with persistent outbox
• Per-user state isolation
• Network and device lock monitoring

Requirements

• iOS 14.0+
• Swift 5.0+
• HealthKit entitlement

Installation

Swift Package Manager

Add to your Package.swift:

dependencies: [
    .package(url: "https://github.com/the-momentum/OpenWearablesHealthSDK.git", from: "0.1.0")
]

Or in Xcode: File > Add Package Dependencies > paste the repository URL.

CocoaPods

pod 'OpenWearablesHealthSDK', '~> 0.1.0'

Usage

import OpenWearablesHealthSDK

let sdk = OpenWearablesHealthSDK.shared

// Logging
sdk.onLog = { message in
    print("[Health] \(message)")
}

// Auth error handling
sdk.onAuthError = { statusCode, message in
    print("Auth error: \(statusCode) - \(message)")
}

// Configure
sdk.configure(host: "https://api.example.com")

// Sign in (token-based)
sdk.signIn(
    userId: "user123",
    accessToken: "access_token",
    refreshToken: "refresh_token",
    apiKey: nil
)

// Or sign in (API key)
sdk.signIn(
    userId: "user123",
    accessToken: nil,
    refreshToken: nil,
    apiKey: "your_api_key"
)

// Request HealthKit authorization
sdk.requestAuthorization(types: [.steps, .heartRate, .sleep]) { granted in
    if granted {
        // Start background sync
        sdk.startBackgroundSync { started in
            print("Sync started: \(started)")
        }
    }
}

// Trigger immediate sync
sdk.syncNow { }

// Stop sync
sdk.stopBackgroundSync()

// Sign out
sdk.signOut()

AppDelegate Setup

For background URL session support, add to your AppDelegate:

func application(
    _ application: UIApplication,
    handleEventsForBackgroundURLSession identifier: String,
    completionHandler: @escaping () -> Void
) {
    OpenWearablesHealthSDK.setBackgroundCompletionHandler(completionHandler)
}

Info.plist

Add required background modes and HealthKit usage descriptions:

<key>NSHealthShareUsageDescription</key>
<string>We need access to your health data to sync it with the platform.</string>
<key>UIBackgroundModes</key>
<array>
    <string>fetch</string>
    <string>processing</string>
</array>
<key>BGTaskSchedulerPermittedIdentifiers</key>
<array>
    <string>com.openwearables.healthsdk.task.refresh</string>
    <string>com.openwearables.healthsdk.task.process</string>
</array>

License

MIT