@robinhealth/health-sdk 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robin Health
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,189 @@
+# @robin/health-sdk
+
+Unified health data SDK for React Native — HealthKit (iOS) and Health Connect (Android).
+
+One API, both platforms. Query steps, heart rate, sleep, workouts, body composition, and more without writing platform-specific code.
+
+## Features
+
+- **19 health data types** — activity, vitals, sleep, body composition, hydration
+- **79 workout types** — from running and cycling to pickleball and underwater diving
+- **Sleep sessions** — full stage breakdowns (awake, light, deep, REM)
+- **Aggregations** — sum, average, min, max over any date range
+- **Permission management** — persistent state tracking via expo-sqlite
+- **Type-safe** — full TypeScript definitions
+
+## Install
+
+```bash
+npm install @robin/health-sdk
+```
+
+Then install the platform-specific peer dependencies you need:
+
+```bash
+# iOS
+npm install @kingstinct/react-native-healthkit
+
+# Android
+npm install react-native-health-connect
+
+# Permission persistence (recommended)
+npm install expo-sqlite
+```
+
+## Platform Setup
+
+### iOS (Expo)
+
+Add the HealthKit plugin to your `app.json`:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "@kingstinct/react-native-healthkit",
+        {
+          "NSHealthShareUsageDescription": "This app needs access to your health data."
+        }
+      ]
+    ]
+  }
+}
+```
+
+### iOS (Bare React Native)
+
+1. Enable the **HealthKit** capability in Xcode
+2. Add `NSHealthShareUsageDescription` to `Info.plist`
+3. Run `pod install`
+
+### Android (Expo)
+
+Add the Health Connect plugin to your `app.json`:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "expo-health-connect",
+        {
+          "permissions": [
+            "android.permission.health.READ_STEPS",
+            "android.permission.health.READ_HEART_RATE"
+          ]
+        }
+      ]
+    ]
+  }
+}
+```
+
+Requires `minSdkVersion` 28+.
+
+### Android (Bare React Native)
+
+1. Set `minSdkVersion` 28+ in `build.gradle`
+2. Declare health permissions in `AndroidManifest.xml`
+3. Add the `ViewPermissionUsageActivity` alias for the permissions rationale screen
+
+See [docs/INTEGRATION.md](docs/INTEGRATION.md) for full setup instructions.
+
+## Quick Start
+
+```typescript
+import {
+  createHealthProvider,
+  HealthDataType,
+} from 'robin-health-sdk';
+
+const provider = createHealthProvider();
+
+// Check availability
+const available = await provider.isAvailable();
+
+// Request permissions
+await provider.requestAuthorization([
+  HealthDataType.Steps,
+  HealthDataType.HeartRate,
+  HealthDataType.SleepAnalysis,
+]);
+
+// Query samples
+const now = new Date();
+const yesterday = new Date(now.getTime() - 24 * 60 * 60 * 1000);
+
+const heartRateSamples = await provider.querySamples(
+  HealthDataType.HeartRate,
+  yesterday,
+  now,
+);
+
+// Get aggregated stats
+const stepTotal = await provider.queryAggregated(
+  HealthDataType.Steps,
+  yesterday,
+  now,
+);
+console.log(`Steps: ${stepTotal.sum}`);
+
+// Query workouts
+const workouts = await provider.queryWorkouts(yesterday, now);
+
+// Query sleep sessions with stage breakdowns
+const sleep = await provider.querySleepSessions(yesterday, now);
+```
+
+## Supported Data Types
+
+| Category | Type | Unit |
+|----------|------|------|
+| **Activity** | Steps | count |
+| | DistanceWalkingRunning | meters |
+| | ActiveEnergyBurned | kcal |
+| | FlightsClimbed | count |
+| **Vitals** | HeartRate | bpm |
+| | RestingHeartRate | bpm |
+| | BloodPressureSystolic | mmHg |
+| | BloodPressureDiastolic | mmHg |
+| | BloodOxygen | % |
+| | RespiratoryRate | breaths/min |
+| **Sleep** | SleepAnalysis | hours |
+| **Body** | BodyFatPercentage | % |
+| | BodyMassIndex | kg/m² |
+| | BasalEnergyBurned | kcal |
+| **Hydration** | Water | mL |
+
+## API
+
+### `createHealthProvider(): HealthProvider`
+
+Returns a platform-specific health provider (HealthKit on iOS, Health Connect on Android).
+
+### `HealthProvider`
+
+| Method | Description |
+|--------|-------------|
+| `isAvailable()` | Check if health data is available on this device |
+| `shouldRequestAuthorization(types)` | Check if permissions need to be requested |
+| `requestAuthorization(types)` | Request read access for the given data types |
+| `getPermissionStatus()` | Get current permission status |
+| `querySamples(type, start, end)` | Get individual readings in a date range |
+| `queryAggregated(type, start, end)` | Get aggregated stats (sum, avg, min, max) |
+| `queryWorkouts(start, end)` | Get workout sessions with metadata |
+| `querySleepSessions(start, end)` | Get sleep sessions with stage breakdowns |
+
+See [docs/API.md](docs/API.md) for the full API reference with type definitions and platform notes.
+
+## Requirements
+
+- Node >= 16
+- React >= 18.0.0
+- React Native >= 0.72.0
+- iOS 13+ / Android SDK 28+
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createHealthProvider } from './provider';
+export type { HealthProvider, HealthSample, HealthAggregate, Workout, SleepStageSample, SleepSession, } from './types';
+export { HealthDataType, WorkoutActivityType, PermissionStatus, SleepStage, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,OAAO,EACP,gBAAgB,EAChB,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createHealthProvider } from './provider';
+export { HealthDataType, WorkoutActivityType, PermissionStatus, SleepStage, } from './types';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AASlD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,3 @@
+import type { HealthProvider } from './types';
+export declare function createHealthProvider(): HealthProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,oBAAoB,IAAI,cAAc,CAcrD"}

package/dist/provider.js

@@ -0,0 +1,13 @@
+import { Platform } from 'react-native';
+export function createHealthProvider() {
+    if (Platform.OS === 'ios') {
+        const { HealthKitProvider } = require('./providers/healthkit');
+        return new HealthKitProvider();
+    }
+    if (Platform.OS === 'android') {
+        const { HealthConnectProvider } = require('./providers/healthconnect');
+        return new HealthConnectProvider();
+    }
+    throw new Error(`Health data is not supported on ${Platform.OS}. Supported platforms: ios, android.`);
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC,MAAM,UAAU,oBAAoB;IAClC,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAC/D,OAAO,IAAI,iBAAiB,EAAE,CAAC;IACjC,CAAC;IAED,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;QACvE,OAAO,IAAI,qBAAqB,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,IAAI,KAAK,CACb,mCAAmC,QAAQ,CAAC,EAAE,sCAAsC,CACrF,CAAC;AACJ,CAAC"}

package/dist/providers/healthconnect.d.ts

@@ -0,0 +1,16 @@
+import { HealthDataType, PermissionStatus, type HealthProvider, type HealthSample, type HealthAggregate, type Workout, type SleepSession } from '../types';
+export declare class HealthConnectProvider implements HealthProvider {
+    private initPromise;
+    private ensureInitialized;
+    isAvailable(): Promise<boolean>;
+    shouldRequestAuthorization(dataTypes: HealthDataType[]): Promise<boolean>;
+    requestAuthorization(dataTypes: HealthDataType[]): Promise<boolean>;
+    getPermissionStatus(): Promise<PermissionStatus>;
+    querySamples(type: HealthDataType, startDate: Date, endDate: Date): Promise<HealthSample[]>;
+    queryAggregated(type: HealthDataType, startDate: Date, endDate: Date): Promise<HealthAggregate>;
+    querySleepSessions(startDate: Date, endDate: Date): Promise<SleepSession[]>;
+    queryWorkouts(startDate: Date, endDate: Date): Promise<Workout[]>;
+    private deriveBMISamples;
+    private manualAggregate;
+}
+//# sourceMappingURL=healthconnect.d.ts.map

package/dist/providers/healthconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthconnect.d.ts","sourceRoot":"","sources":["../../src/providers/healthconnect.ts"],"names":[],"mappings":"AAmBA,OAAO,EACL,cAAc,EAEd,gBAAgB,EAEhB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,OAAO,EAEZ,KAAK,YAAY,EAClB,MAAM,UAAU,CAAC;AAqJlB,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,WAAW,CAAiC;YAEtC,iBAAiB;IAUzB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAU/B,0BAA0B,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAmCzE,oBAAoB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAoCnE,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAahD,YAAY,CAChB,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,OAAO,CAAC,YAAY,EAAE,CAAC;IA2KpB,eAAe,CACnB,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,OAAO,CAAC,eAAe,CAAC;IAwDrB,kBAAkB,CACtB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,OAAO,CAAC,YAAY,EAAE,CAAC;IAkEpB,aAAa,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;YAkEzD,gBAAgB;YA0ChB,eAAe;CA0B9B"}