# Sahha Capacitor SDK The Sahha SDK provides a convenient way for Ionic / Capacitor apps to connect to the Sahha API. Sahha lets your project seamlessly collect health and lifestyle data from smartphones and wearables via Apple Health, Google Health Connect, and a variety of other sources. For more information on Sahha please visit https://sahha.ai. --- ## Docs The Sahha Docs provide detailed instructions for installation and usage of the Sahha SDK. [Sahha Docs](https://docs.sahha.ai) --- ## Example The Sahha Demo App provides a convenient way to try the features of the Sahha SDK. [Sahha Demo App](https://github.com/sahha-ai/sahha-capacitor/tree/main/example-app) --- ## Health Data Source Integrations Sahha supports integration with the following health data sources: - [Apple Health Kit](https://sahha.notion.site/Apple-Health-HealthKit-13cb2f553bbf80c0b117cb662e04c257?pvs=25) - [Google Fit](https://sahha.notion.site/Google-Fit-131b2f553bbf804a8ee6fef7bc1f4edb?pvs=25) - [Google Health Connect](https://sahha.notion.site/Health-Connect-Android-13cb2f553bbf806d9d64e79fe9d07d9e?pvs=25) - [Samsung Health](https://sahha.notion.site/Samsung-Health-d3f76840fad142469f5e724a54c24ead?pvs=25) - [Fitbit](https://sahha.notion.site/Fitbit-12db2f553bbf809fa93ff01f9acd7330?pvs=25) - [Garmin Connect](https://sahha.notion.site/Garmin-12db2f553bbf80afb916d04a62e857e6?pvs=25) - [Polar Flow](https://sahha.notion.site/Polar-12db2f553bbf80c3968eeeab55b484a2?pvs=25) - [Withings Health Mate](https://sahha.notion.site/Withings-12db2f553bbf80a38d31f80ab083613f?pvs=25) - [Oura Ring](https://sahha.notion.site/Oura-12db2f553bbf80cf96f2dfd8343b4f06?pvs=25) - [Whoop](https://sahha.notion.site/WHOOP-12db2f553bbf807192a5c69071e888f4?pvs=25) - [Strava](https://sahha.notion.site/Strava-12db2f553bbf80c48312c2bf6aa5ac65?pvs=25) - [Sleep as Android](https://sahha.notion.site/Sleep-as-Android-Smart-alarm-131b2f553bbf802eb7e4dca6baab1049?pvs=25) & many more! Please visit our [integrations](https://sahha.notion.site/data-integrations?v=17eb2f553bbf80e0b0b3000c0983ab01) page for more information. --- ## Install > **Note**: Sahha Capacitor SDK v1.3.8+ requires **Capacitor 8**. > - **Android**: Requires Java 21, Kotlin 1.9.25+, and Android Gradle Plugin 8.7.2+. > - **iOS**: Requires iOS Deployment Target 15.0+ and Xcode 15+. ```bash npm install sahha-capacitor npx cap sync ``` ### Android In the `AndroidManifest.xml` file, which can be found in `android` > `app` > `src` > `main`, declare Google Health Connect data types if required, e.g. sleep and step count. More data types are available such as heart rate, workout / exercise, please refer to the links below for more information. ```xml

``` This is recommended if you'd like to retrieve Health Connect data from other health apps such as WHOOP, Garmin, Samsung Health etc. To declare other sensor permissions, please refer to [this](https://docs.sahha.ai/docs/data-flow/sdk/setup#step-2-review-sensor-permissions) page. Only include the sensor permissions required by your project, what is declared here will be reviewed by the Play Store. You must be able to justify reasons behind requiring the sensor permissions, [these](https://docs.sahha.ai/docs/data-flow/sdk/app-store-submission/google-play-store#data-type-justifications) justifications may be used to clearly articulate the reasoning behind your required sensor permissions. ### Apple iOS #### Enable HealthKit - Open your project in Xcode and select your `App Target` in the Project panel. - Navigate to the `Signing & Capabilities` tab. - Click the `+` button (or choose `Editor > Add Capability`) to open the Capabilities library. - Locate and select `HealthKit`; double-click it to add it to your project. #### Background Delivery - Select your project in the Project navigator and choose your app’s target. - In the `Signing & Capabilities` tab, find the HealthKit capability. - Enable the nested `Background Delivery` option to allow passive health data collection. #### Add Usage Descriptions - Select your `App Target` and navigate to the `Info` tab. - Click the `+` button to add a new key and choose `Privacy - Health Share Usage Description`. - Provide a clear description, such as: "*This app needs your health info to deliver mood predictions*." For more detailed instructions, refer to our [setup guide](https://docs.sahha.ai/docs/data-flow/sdk/setup#minimum-requirements). --- ## API * [`configure(...)`](#configure) * [`isAuthenticated()`](#isauthenticated) * [`authenticate(...)`](#authenticate) * [`authenticateToken(...)`](#authenticatetoken) * [`deauthenticate()`](#deauthenticate) * [`getProfileToken()`](#getprofiletoken) * [`getDemographic()`](#getdemographic) * [`postDemographic(...)`](#postdemographic) * [`getSensorStatus(...)`](#getsensorstatus) * [`enableSensors(...)`](#enablesensors) * [`getScores(...)`](#getscores) * [`getBiomarkers(...)`](#getbiomarkers) * [`getStats(...)`](#getstats) * [`getSamples(...)`](#getsamples) * [`openAppSettings()`](#openappsettings) * [`postSensorData()`](#postsensordata) * [Interfaces](#interfaces) * [Enums](#enums) ### configure(...) ```typescript configure(options: { settings: SahhaSettings; }) => Promise<{ success: boolean; }> ``` | Param | Type | | ------------- | ---------------------------------------------------------------------- | | **`options`** | { settings: SahhaSettings; } | **Returns:** Promise<{ success: boolean; }> -------------------- ### isAuthenticated() ```typescript isAuthenticated() => Promise<{ success: boolean; }> ``` **Returns:** Promise<{ success: boolean; }> -------------------- ### authenticate(...) ```typescript authenticate(options: { appId: string; appSecret: string; externalId: string; }) => Promise<{ success: boolean; }> ``` | Param | Type | | ------------- | ---------------------------------------------------------------------- | | **`options`** | { appId: string; appSecret: string; externalId: string; } | **Returns:** Promise<{ success: boolean; }> -------------------- ### authenticateToken(...) ```typescript authenticateToken(options: { profileToken: string; refreshToken: string; }) => Promise<{ success: boolean; }> ``` | Param | Type | | ------------- | ------------------------------------------------------------ | | **`options`** | { profileToken: string; refreshToken: string; } | **Returns:** Promise<{ success: boolean; }> -------------------- ### deauthenticate() ```typescript deauthenticate() => Promise<{ success: boolean; }> ``` **Returns:** Promise<{ success: boolean; }> -------------------- ### getProfileToken() ```typescript getProfileToken() => Promise<{ profileToken?: string; }> ``` **Returns:** Promise<{ profileToken?: string; }> -------------------- ### getDemographic() ```typescript getDemographic() => Promise<{ demographic?: string; }> ``` **Returns:** Promise<{ demographic?: string; }> -------------------- ### postDemographic(...) ```typescript postDemographic(options: { demographic: SahhaDemographic; }) => Promise<{ success: boolean; }> ``` | Param | Type | | ------------- | ------------------------------------------------------------------------------- | | **`options`** | { demographic: SahhaDemographic; } | **Returns:** Promise<{ success: boolean; }> -------------------- ### getSensorStatus(...) ```typescript getSensorStatus(options: { sensors: SahhaSensor[]; }) => Promise<{ status: SahhaSensorStatus; }> ``` | Param | Type | | ------------- | ---------------------------------------- | | **`options`** | { sensors: SahhaSensor[]; } | **Returns:** Promise<{ status: SahhaSensorStatus; }> -------------------- ### enableSensors(...) ```typescript enableSensors(options: { sensors: SahhaSensor[]; }) => Promise<{ status: SahhaSensorStatus; }> ``` | Param | Type | | ------------- | ---------------------------------------- | | **`options`** | { sensors: SahhaSensor[]; } | **Returns:** Promise<{ status: SahhaSensorStatus; }> -------------------- ### getScores(...) ```typescript getScores(options: { types: SahhaScoreType[]; startDateTime: number; endDateTime: number; }) => Promise<{ value: string; }> ``` | Param | Type | | ------------- | ------------------------------------------------------------------------------------- | | **`options`** | { types: SahhaScoreType[]; startDateTime: number; endDateTime: number; } | **Returns:** Promise<{ value: string; }> -------------------- ### getBiomarkers(...) ```typescript getBiomarkers(options: { categories: SahhaBiomarkerCategory[]; types: SahhaBiomarkerType[]; startDateTime: number; endDateTime: number; }) => Promise<{ value: string; }> ``` | Param | Type | | ------------- | ------------------------------------------------------------------------------------------------------------------------------- | | **`options`** | { categories: SahhaBiomarkerCategory[]; types: SahhaBiomarkerType[]; startDateTime: number; endDateTime: number; } | **Returns:** Promise<{ value: string; }> -------------------- ### getStats(...) ```typescript getStats(options: { sensor: SahhaSensor; startDateTime: number; endDateTime: number; }) => Promise<{ value: string; }> ``` | Param | Type | | ------------- | ------------------------------------------------------------------------------------------------------------ | | **`options`** | { sensor: SahhaSensor; startDateTime: number; endDateTime: number; } | **Returns:** Promise<{ value: string; }> -------------------- ### getSamples(...) ```typescript getSamples(options: { sensor: SahhaSensor; startDateTime: number; endDateTime: number; }) => Promise<{ value: string; }> ``` | Param | Type | | ------------- | ------------------------------------------------------------------------------------------------------------ | | **`options`** | { sensor: SahhaSensor; startDateTime: number; endDateTime: number; } | **Returns:** Promise<{ value: string; }> -------------------- ### openAppSettings() ```typescript openAppSettings() => Promise ``` -------------------- ### postSensorData() ```typescript postSensorData() => Promise ``` -------------------- ### Interfaces #### SahhaSettings | Prop | Type | | -------------------------- | -------------------------------------------------------------------------- | | **`environment`** | SahhaEnvironment | | **`sensors`** | SahhaSensor[] | | **`notificationSettings`** | { icon?: string; title?: string; shortDescription?: string; } | #### SahhaDemographic | Prop | Type | | --------------- | ------------------- | | **`age`** | number | | **`gender`** | string | | **`birthDate`** | string | ### Enums #### SahhaEnvironment | Members | Value | | ----------------- | -------------------------- | | **`development`** | 'development' | | **`sandbox`** | 'sandbox' | | **`production`** | 'production' | #### SahhaSensor | Members | Value | | -------------------------------------------- | ----------------------------------------------------- | | **`gender`** | 'gender' | | **`date_of_birth`** | 'date_of_birth' | | **`sleep`** | 'sleep' | | **`steps`** | 'steps' | | **`floors_climbed`** | 'floors_climbed' | | **`heart_rate`** | 'heart_rate' | | **`resting_heart_rate`** | 'resting_heart_rate' | | **`walking_heart_rate_average`** | 'walking_heart_rate_average' | | **`heart_rate_variability_sdnn`** | 'heart_rate_variability_sdnn' | | **`heart_rate_variability_rmssd`** | 'heart_rate_variability_rmssd' | | **`blood_pressure_systolic`** | 'blood_pressure_systolic' | | **`blood_pressure_diastolic`** | 'blood_pressure_diastolic' | | **`blood_glucose`** | 'blood_glucose' | | **`vo2_max`** | 'vo2_max' | | **`oxygen_saturation`** | 'oxygen_saturation' | | **`respiratory_rate`** | 'respiratory_rate' | | **`active_energy_burned`** | 'active_energy_burned' | | **`basal_energy_burned`** | 'basal_energy_burned' | | **`total_energy_burned`** | 'total_energy_burned' | | **`basal_metabolic_rate`** | 'basal_metabolic_rate' | | **`time_in_daylight`** | 'time_in_daylight' | | **`body_temperature`** | 'body_temperature' | | **`basal_body_temperature`** | 'basal_body_temperature' | | **`sleeping_wrist_temperature`** | 'sleeping_wrist_temperature' | | **`height`** | 'height' | | **`weight`** | 'weight' | | **`lean_body_mass`** | 'lean_body_mass' | | **`body_mass_index`** | 'body_mass_index' | | **`body_fat`** | 'body_fat' | | **`body_water_mass`** | 'body_water_mass' | | **`bone_mass`** | 'bone_mass' | | **`waist_circumference`** | 'waist_circumference' | | **`stand_time`** | 'stand_time' | | **`move_time`** | 'move_time' | | **`exercise_time`** | 'exercise_time' | | **`activity_summary`** | 'activity_summary' | | **`device_lock`** | 'device_lock' | | **`exercise`** | 'exercise' | | **`running_speed`** | 'running_speed' | | **`running_power`** | 'running_power' | | **`running_ground_contact_time`** | 'running_ground_contact_time' | | **`running_stride_length`** | 'running_stride_length' | | **`running_vertical_oscillation`** | 'running_vertical_oscillation' | | **`six_minute_walk_test_distance`** | 'six_minute_walk_test_distance' | | **`stair_ascent_speed`** | 'stair_ascent_speed' | | **`stair_descent_speed`** | 'stair_descent_speed' | | **`walking_speed`** | 'walking_speed' | | **`walking_steadiness`** | 'walking_steadiness' | | **`walking_asymmetry_percentage`** | 'walking_asymmetry_percentage' | | **`walking_double_support_percentage`** | 'walking_double_support_percentage' | | **`walking_step_length`** | 'walking_step_length' | | **`energy_intake`** | 'energy_intake' | | **`protein_intake`** | 'protein_intake' | | **`fat_intake`** | 'fat_intake' | | **`fat_saturated_intake`** | 'fat_saturated_intake' | | **`fat_monounsaturated_intake`** | 'fat_monounsaturated_intake' | | **`fat_polyunsaturated_intake`** | 'fat_polyunsaturated_intake' | | **`cholesterol_intake`** | 'cholesterol_intake' | | **`carbohydrate_intake`** | 'carbohydrate_intake' | | **`sugar_intake`** | 'sugar_intake' | | **`fiber_intake`** | 'fiber_intake' | | **`vitamin_a_intake`** | 'vitamin_a_intake' | | **`vitamin_c_intake`** | 'vitamin_c_intake' | | **`vitamin_d_intake`** | 'vitamin_d_intake' | | **`vitamin_e_intake`** | 'vitamin_e_intake' | | **`vitamin_k_intake`** | 'vitamin_k_intake' | | **`vitamin_b6_intake`** | 'vitamin_b6_intake' | | **`vitamin_b12_intake`** | 'vitamin_b12_intake' | | **`thiamin_intake`** | 'thiamin_intake' | | **`riboflavin_intake`** | 'riboflavin_intake' | | **`niacin_intake`** | 'niacin_intake' | | **`pantothenic_acid_intake`** | 'pantothenic_acid_intake' | | **`folate_intake`** | 'folate_intake' | | **`biotin_intake`** | 'biotin_intake' | | **`calcium_intake`** | 'calcium_intake' | | **`iron_intake`** | 'iron_intake' | | **`magnesium_intake`** | 'magnesium_intake' | | **`phosphorus_intake`** | 'phosphorus_intake' | | **`potassium_intake`** | 'potassium_intake' | | **`sodium_intake`** | 'sodium_intake' | | **`zinc_intake`** | 'zinc_intake' | | **`chloride_intake`** | 'chloride_intake' | | **`copper_intake`** | 'copper_intake' | | **`manganese_intake`** | 'manganese_intake' | | **`chromium_intake`** | 'chromium_intake' | | **`molybdenum_intake`** | 'molybdenum_intake' | | **`selenium_intake`** | 'selenium_intake' | | **`iodine_intake`** | 'iodine_intake' | | **`caffeine_intake`** | 'caffeine_intake' | | **`water_intake`** | 'water_intake' | | **`menstrual_flow`** | 'menstrual_flow' | | **`menstrual_period`** | 'menstrual_period' | | **`intermenstrual_bleeding`** | 'intermenstrual_bleeding' | | **`cervical_mucus`** | 'cervical_mucus' | | **`ovulation_test`** | 'ovulation_test' | | **`sexual_activity`** | 'sexual_activity' | | **`pregnancy`** | 'pregnancy' | | **`pregnancy_test`** | 'pregnancy_test' | | **`progesterone_test`** | 'progesterone_test' | | **`lactation`** | 'lactation' | | **`contraceptive`** | 'contraceptive' | | **`infrequent_menstrual_cycles`** | 'infrequent_menstrual_cycles' | | **`irregular_menstrual_cycles`** | 'irregular_menstrual_cycles' | | **`persistent_intermenstrual_bleeding`** | 'persistent_intermenstrual_bleeding' | | **`prolonged_menstrual_periods`** | 'prolonged_menstrual_periods' | | **`abdominal_cramps`** | 'abdominal_cramps' | | **`acne`** | 'acne' | | **`appetite_changes`** | 'appetite_changes' | | **`bladder_incontinence`** | 'bladder_incontinence' | | **`bloating`** | 'bloating' | | **`breast_pain`** | 'breast_pain' | | **`chest_tightness_or_pain`** | 'chest_tightness_or_pain' | | **`chills`** | 'chills' | | **`constipation`** | 'constipation' | | **`coughing`** | 'coughing' | | **`diarrhea`** | 'diarrhea' | | **`dizziness`** | 'dizziness' | | **`dry_skin`** | 'dry_skin' | | **`fainting`** | 'fainting' | | **`fatigue`** | 'fatigue' | | **`fever`** | 'fever' | | **`generalized_body_ache`** | 'generalized_body_ache' | | **`hair_loss`** | 'hair_loss' | | **`headache`** | 'headache' | | **`heartburn`** | 'heartburn' | | **`hot_flashes`** | 'hot_flashes' | | **`loss_of_smell`** | 'loss_of_smell' | | **`loss_of_taste`** | 'loss_of_taste' | | **`lower_back_pain`** | 'lower_back_pain' | | **`memory_lapse`** | 'memory_lapse' | | **`mood_changes`** | 'mood_changes' | | **`nausea`** | 'nausea' | | **`night_sweats`** | 'night_sweats' | | **`pelvic_pain`** | 'pelvic_pain' | | **`rapid_pounding_or_fluttering_heartbeat`** | 'rapid_pounding_or_fluttering_heartbeat' | | **`runny_nose`** | 'runny_nose' | | **`shortness_of_breath`** | 'shortness_of_breath' | | **`sinus_congestion`** | 'sinus_congestion' | | **`skipped_heartbeat`** | 'skipped_heartbeat' | | **`sleep_changes`** | 'sleep_changes' | | **`sore_throat`** | 'sore_throat' | | **`vaginal_dryness`** | 'vaginal_dryness' | | **`vomiting`** | 'vomiting' | | **`wheezing`** | 'wheezing' | #### SahhaSensorStatus | Members | Value | | ----------------- | -------------- | | **`pending`** | 0 | | **`unavailable`** | 1 | | **`disabled`** | 2 | | **`enabled`** | 3 | #### SahhaScoreType | Members | Value | | ---------------------- | ------------------------------- | | **`wellbeing`** | 'wellbeing' | | **`activity`** | 'activity' | | **`sleep`** | 'sleep' | | **`readiness`** | 'readiness' | | **`mental_wellbeing`** | 'mental_wellbeing' | #### SahhaBiomarkerCategory | Members | Value | | ---------------- | ------------------------- | | **`activity`** | 'activity' | | **`body`** | 'body' | | **`engagement`** | 'engagement' | | **`nutrition`** | 'nutrition' | | **`sleep`** | 'sleep' | | **`vitals`** | 'vitals' | #### SahhaBiomarkerType | Members | Value | | ---------------------------------------- | ------------------------------------------------- | | **`steps`** | 'steps' | | **`floors_climbed`** | 'floors_climbed' | | **`active_hours`** | 'active_hours' | | **`active_duration`** | 'active_duration' | | **`activity_low_intensity_duration`** | 'activity_low_intensity_duration' | | **`activity_medium_intensity_duration`** | 'activity_medium_intensity_duration' | | **`activity_high_intensity_duration`** | 'activity_high_intensity_duration' | | **`activity_sedentary_duration`** | 'activity_sedentary_duration' | | **`active_energy_burned`** | 'active_energy_burned' | | **`total_energy_burned`** | 'total_energy_burned' | | **`height`** | 'height' | | **`weight`** | 'weight' | | **`body_mass_index`** | 'body_mass_index' | | **`body_fat`** | 'body_fat' | | **`fat_mass`** | 'fat_mass' | | **`lean_mass`** | 'lean_mass' | | **`waist_circumference`** | 'waist_circumference' | | **`resting_energy_burned`** | 'resting_energy_burned' | | **`age`** | 'age' | | **`biological_sex`** | 'biological_sex' | | **`date_of_birth`** | 'date_of_birth' | | **`sleep_start_time`** | 'sleep_start_time' | | **`sleep_end_time`** | 'sleep_end_time' | | **`sleep_duration`** | 'sleep_duration' | | **`sleep_debt`** | 'sleep_debt' | | **`sleep_interruptions`** | 'sleep_interruptions' | | **`sleep_in_bed_duration`** | 'sleep_in_bed_duration' | | **`sleep_awake_duration`** | 'sleep_awake_duration' | | **`sleep_light_duration`** | 'sleep_light_duration' | | **`sleep_rem_duration`** | 'sleep_rem_duration' | | **`sleep_deep_duration`** | 'sleep_deep_duration' | | **`sleep_regularity`** | 'sleep_regularity' | | **`sleep_latency`** | 'sleep_latency' | | **`sleep_efficiency`** | 'sleep_efficiency' | | **`heart_rate_resting`** | 'heart_rate_resting' | | **`heart_rate_sleep`** | 'heart_rate_sleep' | | **`heart_rate_variability_sdnn`** | 'heart_rate_variability_sdnn' | | **`heart_rate_variability_rmssd`** | 'heart_rate_variability_rmssd' | | **`respiratory_rate`** | 'respiratory_rate' | | **`respiratory_rate_sleep`** | 'respiratory_rate_sleep' | | **`oxygen_saturation`** | 'oxygen_saturation' | | **`oxygen_saturation_sleep`** | 'oxygen_saturation_sleep' | | **`vo2_max`** | 'vo2_max' | | **`blood_glucose`** | 'blood_glucose' | | **`blood_pressure_systolic`** | 'blood_pressure_systolic' | | **`blood_pressure_diastolic`** | 'blood_pressure_diastolic' | | **`body_temperature_basal`** | 'body_temperature_basal' | | **`skin_temperature_sleep`** | 'skin_temperature_sleep' | --- Copyright © 2024 Sahha. All rights reserved.